借助适用于 Workspace 的 Universal Search MCP 服务器，让 AI 智能体在整个工作区中进行搜索

Google Workspace 的通用搜索 MCP 服务器使用 Model Context Protocol (MCP) 标准，以便 AI 智能体搜索您的 Workspace 制品。该服务器提供了一种方法，支持用户通过单一工具一站式搜索多款 Google Workspace 产品，包括 Gmail 邮件、Google 云端硬盘文件、Google 日历活动、Google Chat 聊天室和消息。

通用搜索 MCP 服务器为 AI 智能体提供了一种标准化方式，使其能够在整个 Google Workspace 账号中搜索信息，而无需调用各个特定于产品的工具。

前提条件

  • Google Cloud 项目。如需创建项目，请参阅创建项目。

  • MCP 客户端，例如 Google Antigravity。

  • 如需运行此页面中的命令，请在以下开发环境之一中设置 gcloud CLI：

    Cloud Shell

    如需使用已设置 gcloud CLI 的在线终端，请激活 Cloud Shell：

    激活 Cloud Shell

    本地 shell

    如需使用本地开发环境，请按照以下步骤操作：

    1. 安装 Google Cloud CLI。 如果您之前安装了 gcloud CLI，请运行 gcloud components update 确保您拥有最新版本。
    2. 如果您使用的是外部身份提供商 (IdP)，请使用您的联合身份登录 gcloud CLI。如需了解详情，请参阅使用联合身份登录 gcloud CLI。
    3. 初始化 gcloud CLI。

配置通用搜索 MCP 服务器

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

启用 API

如需使用通用搜索 MCP 服务器，请在您的 Google Cloud 项目中启用 Google Workspace MCP API 和您要搜索的产品的 API：

  • Gmail API
  • Google Drive API
  • Google Calendar API
  • Google Chat API

  • Google Workspace MCP API

CLI

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
workspacemcp.googleapis.com --project=PROJECT_ID

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

控制台

在 Google Cloud 控制台中启用 API：

启用 API

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

如果您已经为其他 MCP 服务器配置了 OAuth 权限请求页面，请确保您已为 Universal Search MCP 服务器添加了所需的范围。

当您使用 Universal Search MCP 服务器进行身份验证时，您可以选择验证所有请求的范围，或者仅验证其中的一部分。服务器会遵循这些选择，仅在已授予访问权限的产品中进行搜索。

例如，如果您使用以下所有范围进行身份验证：

  • https://www.googleapis.com/auth/gmail.readonly
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.googleapis.com/auth/chat.messages.readonly

通用搜索 MCP 服务器将搜索 Gmail、Google 云端硬盘、Google 日历和 Google Chat。

不过，如果您仅授予对 https://www.googleapis.com/auth/drive.readonly、https://www.googleapis.com/auth/calendar.readonly 和 https://www.googleapis.com/auth/chat.messages.readonly 的访问权限（并省略 https://www.googleapis.com/auth/gmail.readonly），全局搜索将仅返回 Google 云端硬盘、Google 日历和 Google Chat 中的结果。 它不会搜索您的电子邮件，也不会返回 Gmail 结果。

  1. 在 Google Cloud 控制台中，转到Google Auth 平台 > 数据访问。
  2. 点击添加或移除范围。

  3. 添加以下一个或多个范围：

    • https://www.googleapis.com/auth/gmail.readonly
    • https://www.googleapis.com/auth/drive.readonly
    • https://www.googleapis.com/auth/calendar.readonly
    • https://www.googleapis.com/auth/chat.messages.readonly

  4. 点击更新，然后点击保存。

有关设置权限请求页面的详细说明，请参阅配置 Google Workspace MCP 服务器。

配置 MCP 客户端

如需将 Universal Search MCP 服务器添加到您的 MCP 客户端，请按照客户端的相关说明操作。

Antigravity

如需将通用搜索 MCP 服务器添加到 Antigravity，请将服务器配置添加到 mcp_config.json 文件中。这些说明适用于 Antigravity 2.0、Antigravity IDE 和 Antigravity CLI。

  1. 创建类型为 Web 应用的 OAuth 2.0 客户端 ID 和密钥。在已获授权的重定向 URI 部分中，点击 + 添加 URI，然后在 URI 字段中添加 https://antigravity.google/oauth-callback。如需了解说明，请参阅配置 Google Workspace MCP 服务器。

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

  3. 将 workspace-universal 配置添加到 mcp_config.json：

    {
  "mcpServers": {
    "workspace-universal": {
      "serverUrl": "https://workspacemcp.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. 在列表中找到 workspace-universal，点击身份验证，登录您的 Google 账号，复制授权代码，将其粘贴到输入对话框中，然后点击提交。

    • 对于 Antigravity CLI：

      1. 启动 Antigravity CLI：

        agy

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

        /mcp

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

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

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

Claude

要将 Universal Search MCP 服务器添加到 Claude，请配置自定义连接器。

  1. 创建类型为 Web 应用的 OAuth 2.0 客户端 ID 和密钥。有关说明，请参阅配置 Google Workspace MCP 服务器。

  2. 在 Claude 设置中，添加自定义连接器：

    • 服务器名称：Universal Search MCP Server
    • 远程 MCP 服务器网址：https://workspacemcp.googleapis.com/mcp/v1
    • OAuth 客户端 ID 和 OAuth 客户端密钥：输入您的凭据。
    • 作用域：包括https://www.googleapis.com/auth/gmail.readonly、https://www.googleapis.com/auth/drive.readonly、https://www.googleapis.com/auth/calendar.readonly和https://www.googleapis.com/auth/chat.messages.readonly。

测试通用搜索 MCP 服务器

尝试向您的 MCP 客户提出一些需要跨不同产品进行搜索的问题：

  • “在我的电子邮件、文档和聊天消息中查找与项目 X 相关的所有内容。”
  • “我的下一场营销方案会议是什么时候？会议的最新备注和聊天消息是什么？”

如果工具成功执行，并且您从多个产品收到相关响应，则表示通用搜索 MCP 服务器已正确配置。

支持的工具

通用搜索 MCP 服务器提供以下工具：

  • search_corpus: 根据提供的查询，在多个 Google Workspace 产品（Google 云端硬盘、Gmail、Google 日历和 Google Chat）中执行搜索。