Antigravity の Google Workspace MCP サーバー

1. はじめに

この Codelab では、Model Context Protocol（MCP）を使用して Antigravity を Google Workspace データ に接続する方法について説明します。MCP は、AI モデルがリモートサーバーから提供されるツールを安全に使用できるようにするオープンスタンダードです。コードを記述せずに、Gmail、Google ドライブ、Google カレンダー、Google Chat、People API とやり取りするように Antigravity を設定します。

Google Workspace MCP アーキテクチャ

演習内容

Google Cloud プロジェクトで Google Workspace MCP サービス を有効にします。
これらの MCP サービスにアクセスするように Antigravity を構成します。
Google Workspace データとやり取りする 便利で楽しいプロンプト を使用して統合をテストします。

必要なもの

ウェブブラウザ（Chrome など）
Google Cloud プロジェクト
Google Workspace アカウント
ローカルマシンにインストールされた Antigravity

この Codelab への簡単なアクセス

2. 始める前に

Google Cloud プロジェクトを作成または選択する

Google Cloud コンソールで、Google Cloud プロジェクトを作成または選択 します。

API を有効にする

Google Workspace MCP サーバーを使用するには、標準の Google Workspace API を有効にする必要があります。一部の MCP サーバーは独立して動作しますが、他の MCP サーバーでは、基盤となる標準 API を有効にする必要があります。

Gmail と Chat には、標準 API が必要です。
ドライブ では、特定のツールに標準 API が必要です。
カレンダー では、標準 API を有効にする必要はありません。
People API は標準権限と MCP 機能の両方を処理するため、有効にする個別の MCP サービスはありません。

MCP サービスを有効にする

次に、プロダクト専用の MCP サービスを有効にします。

Chat アプリを構成する

Google Chat MCP サーバーを使用するには、Google Cloud プロジェクトで Chat アプリを構成する必要があります。

Google Cloud コンソールで「Google Chat API」を検索し、[Google Chat API] > [管理] > [構成] をクリックします。

Chat アプリを設定します。
- [アプリケーション名] フィールドに、「Chat MCP」と入力します。
- [アバターの URL] フィールドに「https://developers.google.com/chat/images/quickstart-app-avatar.png」と入力します。
- [説明] に Chat MCP server と入力します。
- [機能] で、[インタラクティブ機能を有効にする] をオフにします。
- [ログ] で、[エラーを Logging に記録する] を選択します。
[保存] をクリックします。

3. OAuth 同意とクライアントを構成する

Google Workspace MCP サーバーは、安全な認証に OAuth 2.0 を使用します。OAuth 同意画面を構成し、ウェブアプリケーションクライアントを作成する必要があります。

Google Workspace MCP サーバーは、認証に OAuth 2.0 を使用します。最初に同意画面を構成する必要があります。

Google Cloud コンソールで、[Google Auth Platform] > [ブランディング] に移動します。構成されていない場合は、[使ってみる] をクリックします。
[**アプリ情報**] を構成します。
- アプリ名: Google Workspace MCP Servers
- ユーザーサポートメール: メールアドレスを選択します。
[対象ユーザー] を構成します。[内部] を選択します（[内部] が使用できない場合は [外部] を選択します）。
[**連絡先情報**] を構成します。メールアドレスを入力します。
ユーザーデータに関するポリシーを確認して同意し、[作成] をクリックします。
[外部] を選択した場合は、[対象ユーザー] に移動し、[テストユーザー] にメールアドレスを追加します。
[データアクセス] > [スコープの追加または削除] に移動します。[**スコープの手動追加**] で、使用するサーバーに次のものを追加します。
- Google カレンダー: https://www.googleapis.com/auth/calendar.calendarlist.readonly、https://www.googleapis.com/auth/calendar.events.freebusy、https://www.googleapis.com/auth/calendar.events.readonly
- Google Chat: https://www.googleapis.com/auth/chat.spaces.readonly、https://www.googleapis.com/auth/chat.memberships.readonly、https://www.googleapis.com/auth/chat.messages.readonly、https://www.googleapis.com/auth/chat.users.readstate.readonly
- Google ドライブ: https://www.googleapis.com/auth/drive.readonly、https://www.googleapis.com/auth/drive.file
- Gmail: https://www.googleapis.com/auth/gmail.readonly、https://www.googleapis.com/auth/gmail.compose
- People API: https://www.googleapis.com/auth/directory.readonly、https://www.googleapis.com/auth/userinfo.profile、https://www.googleapis.com/auth/contacts.readonly
[テーブルに追加]、[更新]、[保存] の順にクリックします。

OAuth クライアント ID を作成する

[Google Auth Platform] > [クライアント] > [クライアントの作成] に移動します。
アプリケーションの種類として [ウェブアプリケーション] を選択します。
Antigravity という名前を付けます。
[承認済みのリダイレクト URI] で、[+ URI を追加] をクリックして https://antigravity.google/oauth-callback と入力します。
[作成] をクリックして、クライアント ID とクライアントシークレット をコピーします。これらは次のステップで必要になります。

4. Antigravity を構成する

これらのエンドポイントを使用するように Antigravity を構成しましょう。Antigravity がインストールされていない場合は、Antigravity ウェブサイトのインストール手順に沿ってインストールしてください。

カスタム MCP サーバーを追加する

エディタのエージェントパネルの上部にある [...] プルダウンで [MCP Servers] を開きます。

[Manage MCP Servers]、[View raw config] の順にクリックします。

新しく開いたファイル mcp_config.json を、次のカスタム MCP サーバー構成で変更します。その前に、<YOUR_CLIENT_ID> と <YOUR_CLIENT_SECRET> のプレースホルダを、前のステップで作成した OAuth クライアント ID とシークレットに置き換えます。

{
  "mcpServers": {
    "gws-calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-gmail": {
      "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
  }
}

[Manage MCP Servers] に戻り、[Refresh] をクリックします。

カスタム MCP サーバーを認証する

ウィンドウの上部にある [Editor-Specific settings] メニュープルダウンで [Antigravity User Settings] を開きます。

[Customizations] に移動します。

[**INSTALLED MCP SERVERS**] に表示されている各サーバーについて、次の操作を行います。
1. [Authenticate] をクリックします。

新しいブラウザウィンドウで認証フローを行います。
完了したら、[Copy to Clipboard] をクリックします。

ブラウザウィンドウを閉じます。
コピーした認証コードを、Antigravity の設定に表示されるテキストフィールドに貼り付けます。
[Submit] をクリックします。

5. ツールをテストする

自然言語を使用して Google Workspace データとやり取りできるようになりました。各サービスのプロンプトの例をいくつか示します。

Google カレンダー

スケジュールを検索してみましょう。

「今週の今後の会議は？」
「明日の午後に空き時間はありますか？」

Google Chat

メッセージを検索してみましょう。

["'{SPACE_NAME}' で '{KEYWORD}' を含むメッセージを探して"]

Google ドライブ

ファイルを検索または読み取ってみましょう。

「Google ドライブで '[KEYWORD]' を含むファイルを検索して」
「最近編集したドキュメントを一覧表示して」
「'[FILE_NAME]' ドキュメントの内容を読んで、主な目標を要約して」

Gmail

メールを検索または管理してみましょう。

「受信した最新の 5 件のメールを要約して」
["'[EMAIL_ADDRESS]' 宛てに、'[PROJECT_NAME]' プロジェクトの最新情報をリクエストするメールを作成して"]

People API

プロフィールまたは連絡先を検索してみましょう。

「Google プロフィールによると、私の名前は何ですか？」
「'[NAME]' の連絡先情報を探して」

複数のサービスを組み合わせる

MCP の真の力は、複数のサービスにわたるタスクをオーケストレートするときに発揮されます。サービスをまたぐ機能を示すプロンプトを試してみましょう。

「ドライブで '[PROJECT_NAME] マイルストーンの更新' に関連するファイルを検索し、内容を要約して、'[NAME]' のメールアドレスを見つけて、要約を含む Gmail の下書きを作成して」

その他のツールを調べる

これらは、できることのほんの一例です。各サービスで使用できるツールの完全なリストを確認して試すには、公式ドキュメントのサポートされているプロダクトのセクションをご覧ください。

6. クリーンアップ

プロジェクトを削除せずにクリーンアップするには、有効にした API と MCP サービスを無効にします。

Google Cloud コンソールで、[API とサービスのダッシュボード] に移動します。
有効にした Google Workspace API と MCP API（Calendar MCP、Chat MCP など）をそれぞれクリックし、[API を無効にする] をクリックします。

OAuth クライアント認証情報を使用する予定がない場合は、Google Auth Platform コンソールで削除します。

7. 完了

おめでとうございます！Antigravity を使用して、公式の Google Workspace MCP サーバーを構成してテストできました。