概述

MCP 与 Skill 用于扩展 AI 应用可使用的工具和专业能力。MCP 适合连接持续运行的远程工具服务，Skill 适合以技能包的形式向 AI 应用提供说明、脚本和配套资源。两类资源都可以在 AX 中统一创建、管理，并在创建 AI 应用版本时关联。

MCP 与 Skill 的区别

例如，查询工单系统的实时数据适合使用 MCP；将一套固定的报告生成流程、脚本和模板交给 Agent 使用，适合封装为 Skill。

工作原理

1                       +-> MCP Server -> 外部系统或实时数据
2AI 应用 -> AX 工具配置 |
3                       +-> Skill 包 -> 说明、脚本和资源

将 MCP 或 Skill 关联到 AI 应用后，AX 会通过 AX_TOOL_NAME 环境变量向应用注入资源信息。关联多个资源时，应用需要解析该变量，并根据资源类型完成注册或加载。

说明 关联资源只负责将 MCP 与 Skill 的访问信息提供给应用。应用使用的 Agent 框架仍需具备加载 Skill、注册 MCP Server 和调用工具的能力。

AX 提供 一键复制 能力。完成资源关联并启动 AI 应用后，可以在应用详情页复制配置指令并发送给 Agent。Agent 会按照指令读取 AX_TOOL_NAME，自动识别并加载已关联的 MCP 与 Skill，无需用户手动查找资源地址。

前提条件

使用 MCP 前，请确认：

• MCP Server 可以从 AI 应用的出站网络访问。
• MCP Server 支持 Streamable HTTP。
• 已准备完整的服务地址，包括协议、域名、端口和路径。

使用 Skill 前，请确认：

• Skill 已打包为 .zip 文件，且文件大小不超过 10 MB。
• 压缩包内包含可解析的技能说明和相关资源。
• Skill 中的脚本和依赖来自可信来源，并已完成安全评估。

使用一键复制自动配置前，请确认：

• AI 应用已关联可用的模型代理和默认模型，Agent 能够正常运行和处理配置指令。
• AI 应用已关联需要使用的 MCP 与 Skill。
• 已完成应用版本构建和发布，并启动运行实例。

操作步骤

添加 MCP

1. 在左侧导航栏选择 模型与工具 > MCP 与 Skill。
2. 单击 添加 MCP 与 Skill。
3. 类型选择 MCP。
4. 填写名称和描述。

5. 在 MCP 配置 区域完成以下配置：

   配置项	说明
   MCP 协议类型	当前支持 Streamable HTTP。
   MCP 地址	选择 http:// 或 https://，然后填写 MCP Server 的域名、端口和路径。

6. 单击 确定。

添加 Skill

1. 在左侧导航栏选择 模型与工具 > MCP 与 Skill。
2. 单击 添加 MCP 与 Skill。
3. 类型选择 Skill。
4. 填写名称和描述。
5. 上传 Skill 压缩包。仅支持 .zip 文件，文件大小不超过 10 MB。
6. 等待 AX 完成预校验，并查看解析出的 Skill 名称和描述。需要使用压缩包中的信息时，单击 一键覆盖。
7. 建议保留 上传后自动扫描，对技能包执行安全扫描。
8. 单击 确定。

安全提示

Skill 可能包含可执行脚本。上传和使用前，应确认来源可信，检查脚本行为、外部依赖、文件访问范围和敏感信息处理方式。安全扫描不能替代人工审查。

在 AI 应用中关联 MCP 与 Skill

MCP 与 Skill 在创建或更新 AI 应用版本时关联。一个应用可以同时选择多个 MCP 和 Skill。

1. 在左侧导航栏选择 AI 应用。
2. 创建 AI 应用，或进入已有应用并创建新版本。
3. 展开 高级配置。

4. 在 关联平台资源 > MCP 与 Skill 中选择需要使用的资源。

   选项名称前会显示 [MCP] 或 [SKILL]，用于区分资源类型。

5. 在 关联平台资源 > 模型代理 中选择可用的模型代理，并选择默认模型。

   模型代理是使用一键复制自动配置能力的前提。Agent 需要通过模型代理调用模型，才能理解并执行复制的配置指令。

6. 如果 MCP Server 位于受限网络中，请同步配置 出站网络配置。
7. 完成其他配置，提交并等待版本构建完成。
8. 发布版本并启动实例。

使用一键复制自动配置 MCP 与 Skill

完成应用发布并启动实例后，可以通过一键复制将配置指令发送给 Agent，由 Agent 自动读取并加载关联资源。

1. 进入已发布的 AI 应用详情页。
2. 在 关联平台资源 区域找到 MCP 与 Skill。
3. 确认同一区域已显示模型代理和默认模型。如果未配置，请创建新版本并补充关联后重新发布。
4. 单击 MCP 与 Skill 右侧的 复制。
5. 进入该 AI 应用的 Agent 对话界面，将复制的配置指令发送给 Agent。

6. 等待 Agent 读取 AX_TOOL_NAME，并完成以下操作：

   • 自动识别关联资源是 MCP 还是 Skill。
   • 下载并注册 Skill。
   • 获取 MCP 配置并注册 MCP Server。
7. 向 Agent 发起一个需要使用目标 MCP 或 Skill 的任务，确认资源加载成功。

注意

复制操作复制的是供 Agent 执行的配置指令，不是 MCP 或 Skill 的名称、文件或访问地址。需要将复制的完整内容发送给当前 AI 应用中的 Agent。该能力依赖应用已配置模型代理和默认模型。

Agent 自动配置流程

一键复制生成的配置指令会引导 Agent 读取 AX_TOOL_NAME，并按照以下流程自动配置资源：

1. 按逗号拆分 AX_TOOL_NAME 中的多个资源地址。

2. 根据地址路径识别资源类型：

   • 以 ai/mcp 结尾：MCP 资源。
   • 以 ai/skills 结尾：Skill 资源。
3. 对 Skill 资源，下载 ZIP 文件，解压到应用的 skills 目录，并在 Agent 配置中注册启用。
4. 对 MCP 资源，发送 GET 请求获取配置，根据返回的 backendEndpoints 生成实际 MCP 地址，并注册到 Agent 的 MCP Server 配置中。

以上流程由收到配置指令的 Agent 执行。实际加载结果取决于 AI 应用使用的 Agent 框架、运行权限和网络连通性。AX 暂时不提供统一的 SDK；如果应用使用的 Agent 不支持自动执行该配置指令，需要根据上述流程自行完成集成。手动实现时应设置超时、重试和错误处理，并避免在日志中输出凭证或完整敏感地址。