Workspace 向けユニバーサル検索 MCP サーバーで、AI エージェントが Workspace 全体を検索できるようにする

Google Workspace 用のユニバーサル検索 MCP サーバーは、Model Context Protocol（MCP）標準を使用して、AI エージェントが Workspace アーティファクトを検索できるようにします。このサーバーでは、単一のツールを使用して、Gmail のメッセージ、Google ドライブのファイル、Google カレンダーの予定、Google Chat のスペースやメッセージなど、複数の Google Workspace サービスを横断して検索できます。

ユニバーサル検索 MCP サーバーは、AI エージェントが個々のプロダクト固有のツールを呼び出すことなく、Google Workspace アカウント全体で情報を検索するための標準化された方法を提供します。

前提条件

ユニバーサル検索 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 に置き換えます。

Console

Google Cloud コンソールで API を有効にします。

API を有効にする

ユニバーサル検索 MCP サーバーは、認証と認可に OAuth 2.0 を使用します。OAuth クライアント ID を作成する前に、OAuth 同意画面を構成する必要があります。

他の 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. 次のスコープを 1 つ以上追加します。

    • 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. ウェブ アプリケーション タイプの 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 User Settings] を開くなど）。
      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. ウェブ アプリケーション タイプの OAuth 2.0 クライアント ID とシークレットを作成します。手順については、Google Workspace MCP サーバーを構成するをご覧ください。

  2. Claude の設定でカスタム コネクタを追加します。

    • サーバー名: Universal Search MCP Server
    • リモート MCP サーバーの URL: https://workspacemcp.googleapis.com/mcp/v1
    • OAuth クライアント ID と OAuth クライアント シークレット: 認証情報を入力します。
    • Scopes: 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）を検索します。