计算巢 MCP-计算巢服务(Compute Nest)-阿里云帮助中心

计算巢 MCP 用于把 MCP Server 部署成可复用的 MCP 网关，并在创建或变配 Agent 时选择需要启用的 MCP 工具。

适用场景

Agent 需要调用地图、搜索、文件处理、图表生成、代码执行等外部工具。
您希望把多个 MCP Server 聚合到同一个 MCP 网关中统一管理。
您希望在 Agent 部署或变配时按需选择要启用的 MCP 工具。

MCP 网关与 Agent 的关系

MCP 网关用于承载一个或多个 MCP Server。Agent 启用 MCP 时，需要先选择一个 MCP 网关，再从该网关已部署的 MCP Server 中选择本次 Agent 要使用的工具。

一个 MCP 网关可以包含多个 MCP Server；一个 Agent 在部署或变配时可以从选定网关中启用一个或多个 MCP Server。

Agent 侧下发内容是 MCP 配置 JSON。计算巢 MCP 的 Authorization 会直接写入配置，文档示例中使用 *** 脱敏展示：

{
  "mcpServers": {
    "12306": {
      "type": "sse",
      "baseUrl": "http://120.26.***.***:8080/12306/sse",
      "headers": {
        "Authorization": "Bearer sk-***"
      }
    }
  }
}

请勿在代码仓库、日志或公开文档中暴露真实的 Authorization Token。

配置方式

创建或变配 Agent 时，可以在工具配置中启用计算巢 MCP。

打开 Agent 创建或变配页面。
在工具配置中打开 启动MCP 开关。
在 MCP 类型 中选择 计算巢MCP。
在 MCP 网关 中选择 MCP 网关实例。
如果没有可用网关，点击 新建 MCP 网关，创建后返回当前页面选择。
选择该网关下需要启用的具体 MCP。
提交创建或变配。
变更完成后，在 Agent 中触发一次 MCP 工具调用，确认工具可用。

切换 MCP 网关会清空当前已选 MCP；一次部署只使用一个 MCP 网关实例。

存放位置

计算巢 MCP 网关是控制台入口和资源管理方式，底层 MCP 配置 JSON 的存放位置仍与部署入口和部署形态有关：

部署入口	ECS 场景	集群场景
Agent 市场部署	写入镜像内 `config` 目录。	写入镜像内 `config` 目录。
快速部署	写入 `/root/` 目录。	写入 `MCP_JSON` 环境变量。
代码创建 Agent	写入代码工作目录。	写入 `MCP_JSON` 环境变量。

计算巢 MCP 在 Agent 侧会下发为 MCP 配置 JSON。

代码开发接入

若通过代码创建 Agent，可以使用 computenest-agent-integrations 最新版对接 MCP。该版本提供 McpTool，可以把 MCP 配置 JSON 转为 Google ADK 可使用的 McpToolset。

安装依赖：

pip install -U computenest-agent-integrations

参考格式：

import os
from computenest.integrations.adk import McpTool
from google.adk.agents import LlmAgent

# 集群部署时，MCP 配置写入 MCP_JSON 环境变量。
# ECS 部署时，请按“存放位置”表格从对应目录读取平台下发的 MCP 配置 JSON 内容。
mcp_config_json = os.environ["MCP_JSON"]
mcp_tools = list(McpTool(mcp_config_json))

root_agent = LlmAgent(
    name="mcp_agent",
    model=model,
    instruction="你可以根据用户问题调用 MCP 工具。",
    tools=mcp_tools,
)

McpTool 支持完整 MCP JSON（包含 mcpServers）或 mcpServers 对象，支持 sse 和 streamableHttp 类型，并会从环境变量解析 ${VAR} 形式的占位符。

注意事项

MCP Server 可能需要访问外部系统，请根据具体工具配置所需环境变量、密钥或 Token。
同一个网关中可以部署多个 MCP Server，但 Agent 只会启用部署或变配时选择的工具。
MCP 变更提交后，需要等待部署或变配完成后再调用工具。
若采用集群部署，配置变更后还需要重启 Pod 才能加载新配置。
不要在日志中打印完整 MCP 配置，尤其是 Authorization、API Key、Token 等敏感信息。

常见问题

Agent 创建页面没有 MCP 配置

确认当前 Agent 支持 MCP。不同 Agent 支持的工具配置不同，如果页面没有 启动MCP 或 计算巢MCP 配置项，表示当前 Agent 不支持该能力。

选择网关后没有可用 MCP Server

确认目标 MCP 网关中已经部署 MCP Server，并且部署状态正常。必要时返回 MCP 页签，在 我的 MCP 网关 中查看网关详情或重新配置 MCP。

MCP 工具调用失败

检查 MCP Server 的环境变量、访问凭证、网络连通性和 Agent 日志。对于 SSE 类型 MCP，还需要确认 baseUrl 可访问，并且鉴权 Header 有效。