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 を追加] をクリックし、 https://antigravity.google/oauth-callback を [URI] フィールドに追加します。手順については、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

ユニバーサル検索 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 クライアント シークレット: 認証情報を入力します。
    • スコープ: 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）を検索します。