使用 Universal Search MCP Server for Workspace，讓 AI 代理在整個 Workspace 中搜尋

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

    本機殼層

    如要使用本機開發環境，請按照下列步驟操作：

    1. 安裝 Google Cloud CLI。 如果您先前已安裝 gcloud CLI，請執行 gcloud components update，確認您使用的是最新版本。
    2. 如果您使用外部識別資訊提供者 (IdP)，請使用聯合身分登入 gcloud CLI。詳情請參閱「使用聯合身分登入 gcloud CLI」。
    3. 初始化 gcloud CLI。

設定通用搜尋 MCP 伺服器

如要使用 Universal Search MCP 伺服器，您必須在 Google Cloud 雲端專案中啟用該伺服器，然後設定 MCP 用戶端以連線至該伺服器。

啟用 API

如要使用 Universal Search 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

如要將 Universal Search MCP 伺服器新增至 Antigravity，請將伺服器設定新增至 mcp_config.json 檔案。這些操作說明適用於 Antigravity 2.0、Antigravity IDE 和 Antigravity CLI。

  1. 建立「網頁應用程式」類型的 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. 建立「網頁應用程式」類型的 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。

測試 Universal Search MCP 伺服器

試著向您的 MCP 客戶提出一些需要在不同產品上搜尋的問題：

  • 「在我的電子郵件、文件和聊天記錄中尋找與 Project X 相關的任何內容。」
  • 「我下一次行銷計畫會議是什麼時候？會議的最新記事和即時通訊訊息是什麼？」

如果工具執行成功，並且您從多個產品收到相關回應，則您的通用搜尋 MCP 伺服器已正確配置。

支援的工具

通用搜尋 MCP 伺服器提供以下工具：

  • search_corpus：根據提供的查詢內容，搜尋多項 Google Workspace 產品 (Google 雲端硬碟、Gmail、Google 日曆和 Google Chat)。