在计算巢中接入自定义 MCP

准备软件包

上传并部署软件包

准备好软件包后，在计算巢控制台完成上传和部署。

1. 打开 新增自定义 MCP 页面，选择 NPX 或 UVX。

2. 将包类型设置为 私有包。

3. 选择 OSS Bucket 所在地域和 Bucket。

4. 上传软件包。计算巢会把文件保存到 mcp-package/ 目录。

5. 填写启动参数和环境变量。

6. 保存配置并提交变配。

启动命令示例

• UVX

  uvx /mcp-package/<文件名>

• NPX

  需要填写 package.json 中声明的 bin 命令

  npx -y --package /mcp-package/<文件名> <bin命令>

配置 OSS 权限

如果使用计算巢自动创建的 OSS Bucket，模板会配置运行时访问权限，通常不需要额外授权。

如果使用已有 Bucket，操作用户必须能上传软件包，服务运行时必须能读取软件包。

下面的 RAM 策略展示了上传用户所需的最小权限，需将 <bucket-name> 替换为实际 Bucket 名称。

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["oss:ListBuckets"],
      "Resource": ["acs:oss:*:*:*"]
    },
    {
      "Effect": "Allow",
      "Action": ["oss:GetBucketInfo", "oss:ListObjects"],
      "Resource": ["acs:oss:*:*:<bucket-name>"]
    },
    {
      "Effect": "Allow",
      "Action": ["oss:GetObject", "oss:PutObject"],
      "Resource": ["acs:oss:*:*:<bucket-name>/mcp-package/*"]
    }
  ]
}

准备资源

开始前，请准备以下资源：

• 一个可用的 AI 网关实例，以及调用方可访问的域名。

• 一个 AI 网关能够访问的 HTTP 后端服务。

• 一份 OpenAPI 或 Swagger 文件，或一份可手工配置的工具定义。

• 一个已部署的计算巢 MCP 服务实例。

测试域名适合功能验证，但存在每日调用次数限制。生产环境推荐使用已备案并配置 HTTPS 证书的自定义域名。

创建 MCP 服务

在 AI 网关中创建后端服务，再把 HTTP 接口转换为 MCP。

1. 登录 AI 网关控制台，选择目标地域，在左侧导航栏选择服务。

2. 单击创建服务，并根据后端位置选择函数计算、域名、固定地址或容器服务，在左侧导航栏选择 MCP 管理。

3. 单击创建 MCP 服务，将协议设置为 HTTP 接口转 MCP，将使用场景设置为 单服务。

4. 选择后端服务，填写 MCP 服务名称和描述，并选择访问域名。

5. 单击保存并发布。

如果 AI 网关 MCP 已开启消费者认证，ACS 接入计算巢时需要把消费者认证请求头配置为上游请求头。例如，AI 网关要求 x-api-key 时，在自定义 MCP 的环境变量中填写 header:x-api-key 和对应的 API Key。计算巢 MCP 实例自身的 API Key 认证仍可独立开启，两层认证互不替代。

添加并调试工具

创建 MCP 服务后，添加工具并验证两种 MCP 协议。

1. 打开刚创建的 MCP 服务，单击添加工具。

2. 上传 OpenAPI 文件、粘贴 Swagger 定义，或使用自定义 YAML 配置工具。

3. 检查工具名称、描述、输入参数和 HTTP 路径。

   如果后端需要认证，配置基础认证、令牌认证或密钥认证。

4. 打开调试页面，选择 SSE 或 Streamable HTTP。依次完成连接、获取工具和测试调用。

5. 调试通过后，复制与目标协议对应的地址，并按 接入远程 SSE 或 Streamable HTTP 服务完成接入。