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

百炼 MCP 用于在 Agent 部署或变配时接入百炼提供的 MCP 工具。开启后，可以在工具配置中选择需要启用的百炼 MCP 工具，并随 Agent 配置一起下发。

适用场景

Agent 需要调用百炼提供的 MCP 工具。
您已经开通百炼，并希望在 Agent 中启用对应 MCP 能力。
当前 Agent 的创建或变配页面展示了 启动MCP 和 百炼MCP 配置项。

如果页面中没有 启动MCP 或 百炼MCP 配置项，表示当前 Agent 不支持百炼 MCP 配置。

使用前提

使用百炼 MCP 前，需要先满足以下条件：

已开通百炼。
需要使用的 MCP 已在百炼侧开启。

如果未开通 MCP，Agent 部署页面会提示 您还未开通 MCP，请您在新开页中开通 MCP。此时需要点击 前往开通，在新页面完成开通后，再返回 Agent 部署页面继续配置。未开通时，Agent 部署处无法使用对应 MCP。

配置方式

打开 Agent 创建或变配页面。
在工具配置中打开 启动MCP 开关。
在 百炼MCP 区域查看可用 MCP。
如页面提示未开通 MCP，先点击 前往开通 完成开通。
开通完成后，返回 Agent 创建或变配页面。
选择需要启用的百炼 MCP 工具。
提交创建或变配。
变更完成后，在 Agent 中触发一次 MCP 工具调用，确认配置生效。

存放位置

百炼 MCP 的底层配置以 MCP 配置 JSON 下发。不同部署入口和部署形态的存放位置不同：

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

配置内容包含已启用的 MCP Server 信息，例如 type、baseUrl 和鉴权 Header 等。百炼 MCP 的鉴权与百炼 API Key 公用，通常通过 ${DASHSCOPE_API_KEY} 引用。

示例：

{
  "mcpServers": {
    "zimage": {
      "type": "streamableHttp",
      "baseUrl": "https://dashscope.aliyuncs.com/api/v1/mcps/zimage/mcp",
      "headers": {
        "Authorization": "Bearer ${DASHSCOPE_API_KEY}"
      }
    }
  }
}

注意事项

只有已开通的百炼 MCP 才能在 Agent 部署或变配时使用。
如果开通后页面仍未刷新，请返回 Agent 创建或变配页面后重新选择。
MCP 变更提交后，需要等待部署或变配完成后再调用工具。
若采用集群部署，配置变更后还需要重启 Pod 才能加载新配置。

代码开发接入

若通过代码创建 Agent，可以使用 computenest-agent-integrations 最新版对接 MCP。该版本提供 McpTool，可以把 MCP 配置 JSON 转为 Google ADK 可使用的 McpToolset。百炼 MCP 示例中的 ${DASHSCOPE_API_KEY} 会从环境变量中解析，授权与百炼 API Key 公用。

安装依赖：

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="bailian_mcp_agent",
    model=model,
    instruction="你可以根据用户问题调用百炼 MCP 工具。",
    tools=mcp_tools,
)

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

请勿在日志中打印完整 MCP 配置，尤其是 Authorization、API Key、Token 等敏感信息。

常见问题

页面提示未开通 MCP

点击 前往开通，在新页面完成百炼 MCP 开通。开通完成后不要关闭 Agent 部署页面，返回原页面继续配置。

找不到需要使用的百炼 MCP

确认对应 MCP 已在百炼侧开启，并检查当前账号、地域和页面筛选条件是否正确。

MCP 工具调用失败

检查百炼 MCP 是否已开启、Agent 是否已提交最新配置、部署或变配是否完成，以及 Agent 日志中是否存在网络或鉴权错误。