Model Context Protocol (MCP) 是一种开源标准，用于将 AI 应用连接到外部系统。 它建立了一组特定的实体和定义的结构，作为将各种数据源和工具与 AI 模型连接的标准方式。
您可以使用 MCP 工具将智能体应用与现有 MCP 服务器连接。
限制
存在以下限制：
- CX Agent Studio 仅支持基于 StreamableHttpTransport 的服务器；不支持 SSE 传输服务器。
构建或选择 MCP 服务器
如需构建自己的 MCP 服务器， 我们建议您使用官方 MCP SDK 或其他可靠的第三方 SDK（例如 FastMCP）。 创建 MCP 服务器后，将其部署到托管服务。 您可以使用 Cloud Run 或 Compute Engine 托管 MCP 服务器。 您可以参阅本指南，了解端到端流程： 在 10 分钟内构建远程 MCP 服务器并将其部署到 Cloud Run Google Cloud 。
除了从头开始构建 MCP 服务器之外， 您还可以使用预构建的 MCP 服务器， 例如 Google Cloud MCP 服务器。
身份验证
MCP 工具具有与 OpenAPI 工具相同的 身份验证选项。
自定义标头
您可以提供自定义 HTTP 标头，以便在向 MCP 服务器发送的请求中发送这些标头。 您还可以将会话上下文中的变量注入到这些标头中。 如需了解详情，请参阅 会话上下文变量。
单独测试 MCP 服务器
在将智能体连接到 MCP 服务器之前，我们建议您单独测试 MCP 服务器。
使用 StreamableHttpTransport
构建的服务器以后缀（/mcp 或 /mcp/）结尾。
例如，如果服务器托管在 https://example.com，
则向服务器发送请求的正确网址为 https://example.com/mcp。
如需在本地测试服务器， 请考虑使用 curl 或 Postman （它们原生支持 MCP 连接）。 这样可确保服务器正常运行，并确保了解与服务器通信所需的身份验证信息。
自定义标头
您可以定义在向 MCP 服务器发送 HTTP 请求（工具列表请求以及工具执行）时包含的自定义标头。 这些标头的值必须由 变量提供， 因此如需定义自定义标头， 您必须先定义一个包含标头值的变量。 如果变量不包含值，并且运行时没有默认值，则请求中不会包含该标头。
创建 MCP 工具
如需通过控制台创建 MCP 工具，请执行以下操作：
- 点击智能体构建器右侧的工具图标。
- 选择 MCP 工具 。
- 提供工具名称。
- 提供工具说明。
- 提供 MCP 服务器的服务器地址。
- 选择身份验证类型。
- （可选）通过提供标头 名称和用作标头值的变量来定义自定义标头。
- 点击创建 。
对于托管在 Cloud Run 上的服务器，建议的身份验证选项是服务代理 ID 令牌 。
此方法使用 CX Agent Studio 服务帐号（格式为：service-{PROJECT_NUMBER}@gcp-sa-ces.）向 Cloud Run 作业发送请求。
向 CX Agent Studio 服务帐号授予
Cloud Run Invoker 角色
，以便它可以使用自己的身份向服务器发送请求。
在向智能体添加其他工具之前，我们建议您至少测试一个工具，以确保身份验证信息设置正确。