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 Workspace MCP API と、Google Cloud プロジェクトで検索対象とする製品の 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 を有効にする

Universal Search 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

Universal Search MCP Server は、Gmail、Google ドライブ、Google カレンダー、Google チャットを横断的に検索します。

ただし、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

Antigravity に Universal Search MCP サーバーを追加するには、サーバー構成を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. 設定画面を開きます（例：左下の設定をクリックするか、反重力ユーザー設定を開きます）。
      2. [カスタマイズ] に移動します。
      3. [インストールされた MCP サーバー] で、[更新] をクリックします。
      4. リストで workspace-universal を見つけて [認証] をクリックし、Google アカウントにログインして認証コードをコピーし、入力ダイアログに貼り付けて [送信] をクリックします。

    • Antigravity CLI の場合:

      1. Antigravity CLI を起動します。

        agy

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

        /mcp

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

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

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

Claude

Universal Search MCP Server を 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) を横断して検索を実行します。