配置 Chat MCP 服务器

Google Chat 提供了一个远程 Model Context Protocol (MCP) 服务器，可让 AI 智能体安全地与 Google Chat 数据进行交互。通过配置 Google Chat MCP 服务器，您可以让 Google Antigravity 和 Claude 等 AI 应用在 Google Chat 中执行操作。

Google Chat MCP 服务器为 AI 智能体提供了一种标准化方式，使其能够：

  • 读取数据：列出和搜索对话，以及读取消息。
  • 遵循安全设置：继承与用户相同的权限和数据治理控制措施。

前提条件

配置 Google Chat MCP 服务器

如需使用 Google Chat MCP 服务器，您必须在 Google Cloud 项目中启用该服务器，然后配置 MCP 客户端以连接到该服务器。

启用 API

如需使用 Google Chat MCP 服务器，您必须在 Google Cloud 云项目中启用以下 API：

  • Google Chat API

CLI

gcloud services enable chat.googleapis.com --project=PROJECT_ID

将 PROJECT_ID 替换为您的 Google Cloud 项目 ID。

控制台

在 Google Cloud 控制台中启用 API：

启用 API

启用 MCP 服务

如需为 Google Chat 启用 MCP 组件，您必须在 Google Cloud 项目中启用以下服务：

  • Google Chat MCP API

CLI

gcloud services enable chatmcp.googleapis.com --project=PROJECT_ID

将 PROJECT_ID 替换为您的 Google Cloud 项目 ID。

控制台

在 Google Cloud 控制台中启用 MCP 服务：

启用 MCP 服务

配置 Chat 应用

如需使用 Google Chat MCP 服务器执行只读操作（例如搜索对话），您必须启用该 API 并创建一个 OAuth 客户端。无需配置 Chat 应用。

如需执行写入操作（例如发送消息），您必须在 Google Cloud 项目中配置 Chat 应用。

  1. 在 Google Cloud 控制台中，搜索 Google Chat API，然后依次点击 Google Chat API > 管理 > 配置。

    前往 Google Chat API

  2. 设置 Chat 应用：

    1. 在应用名称字段中，输入 Chat MCP。
    2. 在头像网址字段中，输入 https://developers.google.com/chat/images/quickstart-app-avatar.png。
    3. 在说明中，输入 Chat MCP server。
    4. 在功能下，通过将启用互动功能切换为关闭状态来停用互动功能。
    5. 在日志下，选择将错误记录到 Logging。

  3. 点击保存。

如需详细了解如何构建 Chat 应用，请参阅选择 Google Chat 应用架构。

Google Chat MCP 服务器使用 OAuth 2.0 进行身份验证和授权。您必须先配置 OAuth 权限请求页面，然后才能创建 OAuth 客户端 ID。

  1. 在 Google Cloud 控制台中，依次前往 Google Auth Platform > 品牌信息。

    前往“品牌塑造”

  2. 如果您已配置 Google Auth Platform，则可以在品牌信息、受众群体和数据访问中配置以下 OAuth 权限请求页面设置。 如果您看到一条消息，提示尚未配置 Google Auth Platform，请点击开始使用：

    1. 在应用信息下的应用名称中，输入 Chat MCP Server。
    2. 在用户支持邮箱中，选择您的邮箱或适当的 Google 群组。
    3. 点击下一步。
    4. 在受众群体下，选择内部。如果您无法选择内部，请选择外部。
    5. 点击下一步。
    6. 在联系信息下，输入一个邮箱，以便您接收有关项目变更的通知。
    7. 点击下一步。
    8. 在完成下，查看 Google API 服务用户数据政策，如果您同意，请选择我同意 Google API 服务：用户数据政策。
    9. 点击继续。
    10. 点击创建。
    11. 如果您选择了外部作为用户类型，请添加测试用户：
      1. 点击受众群体。
      2. 在测试用户下，点击添加用户。
      3. 输入您的邮箱和任何其他已获授权的测试用户，然后点击保存。

  3. 依次点击数据访问权限 > 添加或移除范围。系统会显示一个面板，其中列出了您在 Google Cloud 项目中启用的每个 API 的范围。

    1. 在手动添加范围下，粘贴 Google Chat MCP 服务器的范围：

      • https://www.googleapis.com/auth/chat.spaces.readonly
      • https://www.googleapis.com/auth/chat.memberships.readonly
      • https://www.googleapis.com/auth/chat.messages.readonly
      • https://www.googleapis.com/auth/chat.messages.create
      • https://www.googleapis.com/auth/chat.users.readstate
      • https://www.googleapis.com/auth/chat.users.spacesettings

    2. 点击添加到表格。

    3. 点击更新。

    4. 选择应用所需的范围后，在数据访问页面上点击保存。

配置 MCP 客户端

如需将 Google Chat 远程 MCP 服务器添加到 MCP 客户端，请按照客户端的说明操作。

Antigravity

如需将 Google Chat 远程 MCP 服务器添加到 Antigravity，请将服务器配置添加到 mcp_config.json 文件中。这些说明支持 Antigravity 2.0、Antigravity IDE 和 Antigravity CLI。

  1. 创建 OAuth 2.0 客户端 ID 和密钥：

    1. 在 Google Cloud 控制台中，依次前往 Google Auth Platform > 客户端 > 创建客户端

      前往“创建客户端”

    2. 选择 Web 应用作为应用类型。

    3. 输入名称。

    4. 在已获授权的重定向 URI 部分中，点击 + 添加 URI，然后在 URI 字段中添加 https://antigravity.google/oauth-callback。

    5. 选择将此客户端用于 AI 赋能的智能体。

    6. 点击创建，然后复制您的客户端 ID 和客户端密钥。

  2. 打开或创建配置文件 ~/.gemini/config/mcp_config.json。

  3. 将 mcpServers 配置添加到 mcp_config.json：

    {
  "mcpServers": {
    "chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}

    替换以下内容：

    • OAUTH_CLIENT_ID：您创建的客户端 ID。
    • OAUTH_CLIENT_SECRET：您创建的客户端密钥。

  4. 可享受 mcp_config.json 的优惠。

  5. 对 MCP 服务器进行身份验证。您可以使用 GUI 设置或 CLI 进行身份验证：

    • 对于 Antigravity IDE 或 GUI (Antigravity 2.0)：

      1. 打开设置界面（例如，点击左下角的设置或打开 Antigravity 用户设置）。
      2. 前往自定义。
      3. 在已安装的 MCP 服务器下，点击刷新。
      4. 在列表中找到 chat，点击身份验证，登录您的 Google 账号，复制授权代码，将其粘贴到输入对话框中，然后点击提交。

    • 对于 Antigravity CLI：

      1. 启动 Antigravity CLI：

        agy

      2. 运行以下命令，打开交互式 MCP 管理面板：

        /mcp

      3. 使用箭头键选择 chat，移至身份验证操作，然后按 Enter 键。在浏览器中完成登录流程，复制授权代码，将其粘贴到终端提示中，然后按 Enter 键。

  6. 验证服务器是否已正确配置并正在运行：

    • 对于 Antigravity IDE 或 GUI：在自定义 > 已安装的 MCP 服务器下，服务器旁边会显示退出按钮。
    • 对于 Antigravity CLI：打开 /mcp 面板，查看已配置的 MCP 服务器。经过验证和身份验证的服务器会在交互式 TUI 面板中的名称旁边显示 Authed。您可以在信息中心视图下选择任意服务器，以检查其状态并列出其所有可用工具。

远程 MCP 服务器已准备就绪，可在 Antigravity 中使用。

Claude

如需将 Google Chat 远程 MCP 服务器与 Claude.ai 或 Claude Desktop 搭配使用，您必须拥有 Claude Enterprise、Pro、Max 或 Team 方案。

如需将 Google Chat 远程 MCP 服务器添加到 Claude，请使用 OAuth 客户端 ID 和密钥配置自定义连接器。

  1. 创建 OAuth 2.0 客户端 ID 和密钥：

    1. 在 Google Cloud 控制台中，依次前往 Google Auth Platform > 客户端 > 创建客户端

      前往“创建客户端”

    2. 选择 Web 应用作为应用类型。

    3. 输入名称。

    4. 在已获授权的重定向 URI 部分中，点击 + 添加 URI，然后在 URI 字段中添加 https://claude.ai/api/mcp/auth_callback。

    5. 选择将此客户端用于 AI 赋能的智能体。

    6. 点击创建，然后复制您的客户端 ID 和客户端密钥。

  2. 在 Claude 中配置 MCP 服务器：

    1. 在 Claude.ai 或 Claude Desktop 中，依次前往设置（或管理员设置）> 连接器。
    2. 点击添加自定义连接器。
    3. 输入 Google Chat 产品的连接详细信息：
      • 服务器名称：Google Chat。
      • 远程 MCP 服务器网址：https://chatmcp.googleapis.com/mcp/v1
    4. 在高级设置中，输入您的 OAuth 客户端 ID 和 OAuth 客户端密钥。
    5. 点击添加。

其他

许多 AI 应用都提供了连接到远程 MCP 服务器的方式。您通常需要输入服务器的相关详细信息，例如其名称、端点、传输协议和身份验证方法。对于 Google Chat 远程 MCP 服务器，请输入以下内容：

  • 服务器名称：chat

  • 服务器网址：https://chatmcp.googleapis.com/mcp/v1

  • 传输：可流式传输的 HTTP

  • 身份验证：Google Chat 远程 MCP 服务器使用 OAuth 2.0。创建 OAuth 2.0 客户端时，请选择将此客户端用于 AI 赋能的智能体。如需了解详情，请参阅了解身份验证和授权。

如需详细了解如何连接不同类型的客户端，请参阅在 AI 应用中配置 MCP。

测试 Google Chat MCP 服务器

配置 MCP 客户端后，您可以通过运行一些测试提示来验证连接。

尝试向 MCP 客户端提出以下问题：

  • “‘项目 X’聊天室中的最后一条消息是什么？”

    客户端使用 search_conversations 查找聊天室，然后使用 list_messages 检索消息。

如果工具成功执行并收到相关响应，则表示您的 Google Chat MCP 服务器配置正确。

问题排查

如果您在连接到 MCP 服务器时遇到问题，可以在 OAuth 日志中检查是否存在错误。请让您的管理员在安全调查工具中查看 OAuth 日志事件。

如果对 MCP 服务器的请求被拒绝，请验证您的 OAuth 2.0 客户端是否已在 Google Auth Platform > Clients 中选择将此客户端用于 AI 赋能的智能体。如果您无法在现有 OAuth 客户端上更改此设置，请创建一个新 OAuth 客户端，并选择将此客户端用于 AI 赋能的智能体，然后更新您的应用以使用该客户端。如果现有 OAuth 客户端同时用于 AI 智能体和非智能体功能，请为 AI 智能体创建一个单独的 OAuth 客户端，并保留现有客户端用于非智能体功能。如需查看相关说明，请参阅配置 MCP 客户端和管理 OAuth 客户端。

如果您大约每小时都会收到重新登录的提示，则表示您的 MCP 客户端未收到刷新令牌。仅当授权请求包含 access_type=offline 时，Google 的授权服务器才会颁发刷新令牌；仅请求 OIDC offline_access 范围是不够的。如果您的 MCP 客户端支持自定义授权参数，请将 access_type=offline 添加到授权请求中。如需为已授予访问权限的用户获取新的刷新令牌，请同时添加 prompt=consent。

工具参考

Google Chat MCP 服务器提供以下工具：

  • search_conversations
  • list_messages
  • search_messages
  • send_message
  • mark_as_read
  • mark_as_unread
  • list_memberships
  • get_notification_settings
  • update_notification_settings

重要安全注意事项：间接提示词注入

当您向语言模型公开不可信数据时，存在间接提示词注入攻击的风险。由于 Google Antigravity 等 MCP 主机可以通过 Google Chat MCP 服务器访问强大的工具和 API，因此它们可以读取、修改和删除您 Google 账号中的数据。

为了降低这些风险，您必须筛查提示和回答中是否存在恶意内容或提示注入攻击。您可以使用 Google 提供的 Model Armor，也可以使用自己的解决方案，前提是您在文档中说明了该解决方案，以便用户接受该风险。如需了解详情，请参阅为 Google Workspace MCP 服务器配置安全性。

请遵循以下最佳做法：

  • 仅使用可信工具。切勿将 Google Chat MCP 服务器连接到不受信任或未经验证的应用。
  • 请谨慎处理不可信的输入。避免让 MCP 客户端处理来自未经验证来源的消息或其他资源。这些输入可能包含隐藏的指令，这些指令可以劫持您的会话，从而使攻击者能够修改、窃取或删除您的数据。
  • 查看所有操作。请务必仔细检查 AI 客户端代表您执行的操作，确保这些操作正确无误且符合您的意图。