使用 Agent Retrieval 远程 MCP 服务器连接到 AI 和自定义应用

Model Context Protocol (MCP) 规范了大语言模型 (LLM) 以及 AI 应用或智能体与外部数据源的连接方式。借助 MCP 服务器，您可以使用其工具、资源和提示来执行操作，并从其后端服务获取更新后的数据。

本地 MCP 服务器和远程 MCP 服务器有何区别？

本地 MCP 服务器

通常在本地机器上运行，并使用标准输入和输出流 (stdio) 在同一设备上的服务之间进行通信。

远程 MCP 服务器

在服务的基础设施上运行，并向 AI 应用提供 HTTP 端点，以便在 AI MCP 客户端和 MCP 服务器之间进行通信。如需详细了解 MCP 架构，请参阅 MCP 架构。

无状态核心

从 MCP 版本 2026-07-28 开始，MCP 从双向有状态协议更改为无状态协议。每个 MCP 请求都是自描述的，可以使用标头进行路由。不需要 initialize/initialized 握手或 Mcp-Session-Id，因为每个请求都包含 HTTP 标头或 _meta 参数中所需的所有信息。MCP 服务器可以通过多轮请求 (MRTR) 请求工具所需的其他信息。

为了在不解析请求正文的情况下帮助路由和处理请求，需要一些 MCP 标头，包括：

• MCP 规范要求的标头，例如协议版本标头和标准请求标头。
• 由 MCP 服务器定义的自定义标头。这些标头会使用 x-mcp-header 属性从工具的输入架构镜像到 HTTP 标头中。例如，MCP 服务器可能会定义一个自定义标头，用于指定 Cloud de Confiance by S3NS 区域或项目 ID。

如需详细了解 MCP 架构，请参阅 MCP 版本 2026-07-28 规范和主要变更。

Google 和 Cloud de Confiance by S3NS 远程 MCP 服务器

• 简化、集中的发现
• 托管式全球或区域 HTTP 端点
• 细粒度授权
• 可选的提示和回答安全功能，由 Model Armor 提供保护
• 集中式审核日志记录

如需了解其他 MCP 服务器以及 Google Cloud MCP 服务器可用的安全和治理控制措施，请参阅 Google Cloud MCP 服务器概览。

准备工作

1. In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

   Go to project selector

2. If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

3. 启用 Agent Retrieval API（如果尚未启用）。

   启用 API 所需的角色

   如需启用 API，您需要拥有 serviceusage.services.enable 权限。如果您创建了项目，则可能已经通过 Owner 角色 (roles/owner) 拥有此权限。否则，您可以通过 Service Usage Admin 角色 (roles/serviceusage.serviceUsageAdmin) 获得此权限。了解如何授予角色。

   启用 API

所需的角色

如需获得使用智能体检索 MCP 服务器所需的权限，请让管理员为您授予您要使用智能体检索 MCP 服务器的项目上的以下 IAM 角色：

• 进行 MCP 工具调用： MCP Tool User (roles/mcp.toolUser)
• 读取智能体检索资源：Vector Search Viewer (roles/vectorsearch.viewer)

如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

这些预定义角色包含使用智能体检索 MCP 服务器所需的权限。如需查看所需的确切权限，请展开所需权限部分：

您也可以使用自定义角色或其他预定义角色来获取这些权限。

Agent Retrieval MCP 服务器仅公开只读工具，不需要写入权限。

身份验证和授权

智能体检索 MCP 服务器使用 OAuth 2.0 协议和 IAM 进行身份验证和授权。支持所有 Cloud de Confiance by S3NS 身份用于向 MCP 服务器进行身份验证。

我们建议您为使用 MCP 工具的代理创建单独的身份，以便控制和监控对资源的访问。如需详细了解身份验证，请参阅向 MCP 服务器进行身份验证。

Agent Retrieval MCP OAuth 范围

OAuth 2.0 使用范围和凭证来确定经过身份验证的主账号是否有权对资源执行特定操作。如需详细了解 Google 的 OAuth 2.0 范围，请参阅使用 OAuth 2.0 访问 Google API。

智能体检索 MCP 服务器接受以下 OAuth 范围：

将 MCP 客户端配置为使用智能体检索 MCP 服务器

Claude 或 Antigravity 等 AI 应用和智能体可以实例化连接到单个 MCP 服务器的 MCP 客户端。一个 AI 应用可以有多个连接到不同 MCP 服务器的客户端。如果您的应用未在客户端专用指南中列出，则可以使用以下信息从大多数应用进行连接。

在 AI 应用中，寻找添加或连接到远程 MCP 服务器的方式。对于智能体检索 MCP 服务器，请根据需要输入以下信息：

• 服务器名称：智能体检索 MCP 服务器

• 服务器网址或端点：https://vectorsearch.googleapis.com/mcp

  此单一端点会公开所有九个 Agent Retrieval MCP 工具。 工具调用通过基于标头的路由分派到正确的后端。

• 传输：可流式传输的 HTTP

• 身份验证详细信息：您的 Cloud de Confiance by S3NS 凭证、您的 OAuth 客户端 ID 和密钥，或代理身份和凭证。如需详细了解身份验证，请参阅向 MCP 服务器进行身份验证。

基于标头的路由和客户端协议要求

Agent Retrieval MCP 服务器会根据两个 HTTP 标头在网络边缘分派每个 tools/call：

• Mcp-Name - 必须与请求正文中的工具名称 (params.name) 相同。
• Mcp-Param-Region - 必须等于请求正文中资源路径的 location 组件（例如，projects/PROJECT_ID/locations/us-central1/collections/COLLECTION_ID 处的集合的 us-central1）。

如果任一标头缺失或与正文不匹配，请求会被拒绝并显示 HTTP 400 Bad Request。

您的 MCP 客户端必须根据 tools/call 动态发出这些标头。 此行为在 MCP 协议版本 2026-07-28 及更高版本中已标准化；请确保您的 MCP 客户端库在 initialize 握手期间至少通告此协议版本。如果客户端固定到早期协议版本，或固定到不支持动态标头发送的 SDK 版本，则无法通过统一的 /mcp 端点使用智能体检索 MCP 服务器。

重定向 URI

对于基于 Web 的应用和某些桌面应用，您必须在创建用于身份验证的客户端 ID 和密钥时将重定向 URI 列入许可清单。授权服务器使用重定向 URI 向您的应用发送令牌。应用的文档应指定您必须使用的重定向 URI。不支持自定义重定向 URI。

如需了解有关设置和连接到 MCP 服务器的应用专属指南，请参阅客户端专属指南。

如需了解更一般的指南，请参阅以下资源：

• 连接到远程 MCP 服务器。
• 在 AI 应用中配置 MCP。

可用工具

Agent Retrieval MCP 服务器提供九个只读工具：

所有工具均为只读；MCP 服务器不会对 Agent Retrieval 资源公开任何写入、更新或删除操作。

列出工具

使用 MCP 检查器列出工具，或直接向智能体检索 MCP 服务器发送 tools/list HTTP 请求。tools/list 方法不需要进行身份验证。

智能体检索 MCP 服务器支持 MCP 2026-07-28 无状态协议，因此每个无状态请求都是自描述的，并且必须在 MCP-Protocol-Version HTTP 标头和 _meta.io.modelcontextprotocol/protocolVersion 正文字段中声明协议版本，以及一个 _meta.io.modelcontextprotocol/clientCapabilities 对象（接受空对象）。Mcp-Method HTTP 标头还必须与正文中的 method 匹配。

curl -X POST 'https://vectorsearch.googleapis.com/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'MCP-Protocol-Version: 2026-07-28' \
  -H 'Mcp-Method: tools/list' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {
      "_meta": {
        "io.modelcontextprotocol/protocolVersion": "2026-07-28",
        "io.modelcontextprotocol/clientCapabilities": {}
      }
    }
  }'

示例应用场景

以下是智能体检索 MCP 服务器的示例应用场景：

• 资源检查：列出项目中的集合和索引，并检查其架构和元数据。
• 向量和语义搜索：对集合运行向量或语义搜索，以查找与查询最相关的数据对象。
• 混合检索：在单个批量调用中结合语义、文本和向量搜索，并使用倒数排序融合 (RRF) 或 Vertex Ranking API 融合结果。
• 数据对象检索：按 ID 检索单个数据对象，或按过滤条件查询集合以检查提取的记录。

示例提示

• “列出 REGION 中项目 PROJECT_ID 的智能体检索集合。”
• “显示区域 REGION 中集合 COLLECTION_ID 的架构。”
• “对集合 COLLECTION_ID 运行语义搜索，查找 QUERY_TEXT 并返回前 5 个最近邻。”
• "Do a hybrid search on collection COLLECTION_ID for QUERY_TEXT that combines semantic and text search, then rerank the top 50 with semantic-ranker-fast@latest."
• "从集合 COLLECTION_ID 中获取 ID 为 DATA_OBJECT_ID 的数据对象。"

在提示中，替换以下内容：

• PROJECT_ID： Cloud de Confiance 项目 ID
• REGION：集合所在的区域（例如 us-central1）
• COLLECTION_ID：智能体检索集合的 ID
• DATA_OBJECT_ID：集合中数据对象的 ID
• QUERY_TEXT：查询的自然语言文本

配额和限制

Agent Retrieval MCP 服务器没有自己的配额。对 MCP 服务器的调用次数没有限制。您仍需遵守 Agent Retrieval API 强制执行的配额，MCP 服务器工具会代表您调用该 API。如需了解详情，请参阅智能体检索配额。

后续步骤

• 请参阅智能体检索 MCP 参考文档。
• 了解如何创建合集。
• 了解如何搜索数据对象。
• 了解如何对搜索结果重新排名。
• 详细了解 Google Cloud MCP 服务器。