MCP 工具

Model Context Protocol (MCP) 是一种开放源代码标准,用于将 AI 应用连接到外部系统。它建立了一组特定的实体和明确的结构,可作为一种标准方式将各种数据源和工具与 AI 模型连接起来。

您可以使用 MCP 工具将智能体应用与现有 MCP 服务器相关联。

限制

存在以下限制:

  • CX Agent Studio 仅支持基于 StreamableHttpTransport 的服务器,不支持 SSE 传输服务器。

构建或选择 MCP 服务器

如需构建自己的 MCP 服务器,我们建议您使用官方 MCP SDK 或其他可靠的第三方 SDK,例如 FastMCP。创建 MCP 服务器后,将其部署到托管服务。 您可以使用 Cloud RunCompute Engine 来托管 MCP 服务器。您可以参考以下指南,全面了解整个流程:在 10 分钟内构建远程 MCP 服务器并将其部署到 Google Cloud Run

除了从头开始构建 MCP 服务器之外,您还可以使用预构建的 MCP 服务器,例如 Google Cloud MCP 服务器

身份验证

MCP 工具具有与 OpenAPI 工具相同的身份验证选项

单独测试 MCP 服务器

在将代理连接到 MCP 服务器之前,建议您先单独测试 MCP 服务器。使用 StreamableHttpTransport 构建的服务器以后缀(/mcp/mcp/)结尾。例如,如果服务器托管在 https://example.com,则向服务器发送请求的正确网址为 https://example.com/mcp

如需在本地测试服务器,请考虑使用 curl 或 Postman(原生支持 MCP 连接)。这可确保服务器正常运行,并确保系统了解与服务器通信所需的身份验证信息。

创建 MCP 工具

如需通过控制台创建 MCP 工具,请执行以下操作:

  1. 点击代理构建器右侧的工具图标。
  2. 选择 MCP 工具
  3. 提供工具名称。
  4. 提供工具说明。
  5. 提供 MCP 服务器的服务器地址。
  6. 选择身份验证类型。
  7. 点击创建

对于在 Cloud Run 上托管的服务器,建议的身份验证选项是服务代理 ID 令牌。此方法使用 CX Agent Studio 服务账号(格式为:service-{PROJECT_NUMBER}@gcp-sa-ces.iam.gserviceaccount.com)向 Cloud Run 作业发送请求。向 CX Agent Studio 服务账号授予 Cloud Run Invoker 角色,以便该服务账号可以使用自己的身份向服务器发送请求。

在向代理添加其他工具之前,建议您先测试至少一个工具,以确保身份验证信息设置正确。