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

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

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

前提条件

ユニバーサル検索 MCP サーバーを構成する

Universal Search MCP サーバーを使用するには、Google Cloud プロジェクトで有効にしてから、接続するように MCP クライアントを構成する必要があります。

API を有効にする

ユニバーサル検索 MCP サーバーを使用するには、Google Cloud プロジェクトで Google Workspace MCP API を有効にします。

CLI

gcloud services enable 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 サーバーに必要なスコープが追加されていることを確認してください。

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
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.memberships.readonly

ユニバーサル検索 MCP サーバーは、Gmail、Google ドライブ、Google カレンダー、Google Chat を検索します。

ただし、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、https://www.googleapis.com/auth/chat.spaces.readonly、https://www.googleapis.com/auth/chat.memberships.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
    • https://www.googleapis.com/auth/chat.spaces.readonly
    • https://www.googleapis.com/auth/chat.memberships.readonly

    https://www.googleapis.com/auth/chat.spaces.readonly と https://www.googleapis.com/auth/chat.memberships.readonly を含めて、サーバーが各 Google Chat の会話に参加しているユーザーを識別できるようにします。これらがないと、Google Chat の結果は外部で共有されているものとして扱われ、ユーザーによる確認が必要になるか、フィルタされる可能性があります。

  4. [更新]、[保存] の順にクリックします。

同意画面の設定方法について詳しくは、Google Workspace MCP サーバーを構成するをご覧ください。

MCP クライアントを構成する

Universal Search MCP サーバーを MCP クライアントに追加するには、クライアントの手順に沿って操作します。

Universal Search MCP サーバーを呼び出すユーザー委任 OAuth 2.0 クライアント ID では、[Google Auth Platform] > [クライアント] で [このクライアントを AI 搭載エージェントに使用する] を選択する必要があります。既存の OAuth 2.0 クライアント ID を更新するには、OAuth クライアントを管理するの説明に沿って、[Google Auth Platform] > [クライアント] でこの設定を選択します。既存のクライアントでこの設定を変更できない場合や、クライアントがエージェント以外の機能もサポートしている場合は、AI エージェント用に新しい OAuth 2.0 クライアント ID を作成します。拒否されたリクエスト、ドメイン全体の委任を使用するサービス アカウント、Google Apps Script については、トラブルシューティングをご覧ください。

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 を追加します。[このクライアントを 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. 設定画面を開きます（左下の [Settings] をクリックするか、[Antigravity User Settings] を開きます）。
      2. [カスタマイズ] に移動します。
      3. [Installed MCP Servers] で [Refresh] をクリックします。
      4. リストで workspace-universal を見つけて [Authenticate] をクリックし、Google アカウントにログインして認証コードをコピーし、入力ダイアログに貼り付けて [Submit] をクリックします。

    • Antigravity CLI の場合:

      1. Antigravity CLI を起動します。

        agy

      2. 次のコマンドを実行して、インタラクティブな MCP 管理パネルを開きます。

        /mcp

      3. 矢印キーを使用して workspace-universal を選択し、[Authenticate] アクションに移動して、Enter キーを押します。ブラウザでログインフローを完了し、認証コードをコピーしてターミナル プロンプトに貼り付け、Enter キーを押します。

  6. サーバーが正しく構成され、実行されていることを確認します。

    • Antigravity IDE または GUI の場合: [Customizations] > [Installed MCP サーバー] の workspace-universal の横に [Sign out] ボタンが表示されます。
    • Antigravity CLI の場合: /mcp パネルを開いて、構成済みの MCP サーバーを表示します。検証済みで認証済みのサーバーの名前の横には、インタラクティブ TUI パネル内に [Authed] と表示されます。ダッシュボード ビューで workspace-universal サーバーを選択すると、そのステータスを検査し、使用可能なすべてのツールを一覧表示できます。

Claude

Universal Search MCP サーバーを Claude に追加するには、カスタム コネクタを構成します。

  1. ウェブ アプリケーション タイプの OAuth 2.0 クライアント ID とシークレットを作成し、[このクライアントを AI 搭載エージェントに使用する] を選択します。手順については、Google Workspace MCP サーバーを構成するをご覧ください。

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

    • サーバー名: Universal Search MCP Server
    • リモート MCP サーバーの URL: 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、https://www.googleapis.com/auth/chat.spaces.readonly、https://www.googleapis.com/auth/chat.memberships.readonly が含まれます。

ユニバーサル検索 MCP サーバーをテストする

複数のプロダクトを検索する必要がある質問を MCP クライアントにしてみてください。

  • 「メール、ドキュメント、チャット メッセージから、プロジェクト X に関連するものをすべて探して。」
  • 「マーケティング プランに関する次のミーティングはいつですか？また、それに関する最新のメモとチャット メッセージを教えてください。」

ツールが正常に実行され、複数のプロダクトから関連するレスポンスが返された場合、ユニバーサル検索 MCP サーバーは正しく構成されています。

サポートされているツール

Universal Search MCP サーバーには、次のツールが用意されています。入力スキーマと出力スキーマについては、ユニバーサル検索 MCP リファレンスをご覧ください。

  • search_corpus: 指定されたクエリに基づいて、ドライブ、Gmail、カレンダー、Chat などの複数の Google Workspace サービスを検索します。