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

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

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

ユニバーサル検索 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 クライアントを構成する

Universal Search 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」を追加します。[このクライアントを 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. 設定画面を開きます（左下の [設定] をクリックするか、[Antigravity ユーザー設定] を開きます）。
      2. [カスタマイズ] に移動します。
      3. [インストール済みの MCP サーバー] で [更新] をクリックします。
      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 を含めます。

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

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

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

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

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

ユニバーサル検索 MCP サーバーには、次のツールが用意されています。

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