MCP 集成

概述

MCP（Model Context Protocol）是一种标准化的协议，用于将沙箱内的工具和能力（如浏览器操作、代码执行等）无缝接入到大模型或智能体中。通过 MCP 集成，您可以快速为您的智能体赋予强大的环境交互能力，而无需编写复杂的底层对接代码。 目前，智能体引擎支持在基础沙箱、AIO 沙箱、代码解释器沙箱以及浏览器沙箱中开启 MCP 服务。

操作步骤

1. 登录智能体引擎控制台，左侧导航选择沙箱菜单，进入对应的沙箱实例详情页。

2. 在顶部导航栏选择集成，并切换到 MCP 集成 标签页。

3. 单击右侧的启动服务按钮开启 MCP 服务。

4. 服务启动后，您可以通过下方的 配置 MCP 服务器 和 使用 MCP 工具 两个子标签页进行配置和调用。

配置 MCP 服务器

在“配置 MCP 服务器”标签页下，系统会自动生成一段 JSON 格式的配置代码。您可以通过单击右上角的复制按钮，将这段配置代码粘贴到支持 MCP 协议的智能体开发平台（如 CodeFree、Cursor、Claude Desktop 等）的配置文件中。

配置示例

{
  "mcpServers": {
    "your-templateId-mcp": {
      "url": "https://your-mcp-url/templates/your-templateId/mcp",
      "type": "streamable-http",
      "headers": {
        "X-Mcp-ApiKey": "填写任意沙箱凭证的值"
      }
    }
  }
}

参数说明：

• Server Name (your-templateId-mcp)：当前沙箱模板的唯一标识名称。

• url：MCP 服务的 HTTP 连接地址，指向当前沙箱模板对应的 MCP 代理服务。

• type：连接类型，固定为 streamable-http。

• headers：如果您的沙箱模板配置了“访问凭证”（如 API Key），请在此处的 X-Mcp-ApiKey 填入对应的值；如果未配置访问凭证，可填入任意值占位。

使用 MCP 工具

在“使用 MCP 工具”标签页下，系统会展示如何在代码中调用沙箱提供的 MCP 工具。不同的沙箱类型内置了不同的工具集（例如：浏览器沙箱内置了页面导航、点击等工具）。

调用示例

您可以直接在支持 Node.js 运行环境的智能体中使用 await mcp.callTool 来调用工具：

const result = await mcp.callTool({
    name: 'create_sandbox',
    arguments: {
        timeout: 3600
    }
});
console.log(result);

参数说明：

• name：要调用的工具名称。截图示例中为 create_sandbox，实际使用时请替换为列表中的实际工具名（如 browser_click、browser_navigate 等）。

• arguments：传递给工具的参数对象。具体参数要求请参考工具列表中的定义（示例中传入了超时时间 timeout: 3600）。

注意事项

1. 工具能力差异：不同类型的沙箱提供的 MCP 工具集有所不同（例如：浏览器沙箱提供网页点击、截图工具；代码沙箱提供代码执行工具），具体请以“使用 MCP 工具”界面展示为准。

2. 按需开启工具：为了提升智能体的推理效率和降低上下文消耗，您可以在配置或接入外部智能体时，按需从工具列表中开启所需的 MCP 工具，无需全量加载。