借助适用于 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 权限请求页面，请确保您已为通用搜索 MCP 服务器添加所需的范围。

使用通用搜索 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 Platform > 数据访问权限 。
  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 客户端

如需将通用搜索 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/antigravity/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

如需将通用搜索 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）中执行搜索。