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

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

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

前提条件

配置 Universal Search MCP 服务器

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

启用 API

如需使用 Universal Search MCP 服务器，请在 Google Cloud 项目中启用 Google Workspace MCP API：

CLI

gcloud services enable 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 服务器添加了所需的范围。

向 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

Universal Search 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 客户端

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

Antigravity

如需将 Universal Search 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。选择将此客户端用于 AI 赋能的智能体。如需了解说明，请参阅配置 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 和密钥，然后选择将此客户端用于 AI 赋能的智能体。如需了解说明，请参阅配置 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 相关的任何内容。”
  • “我的下一场关于营销计划的会议是什么时候？关于该计划的最新备注和聊天消息有哪些？”

如果工具成功执行，并且您收到来自多个产品的相关回答，则表示您的 Universal Search MCP 服务器已正确配置。

支持的工具

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

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