Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

Google Antigravity 2.0、IDE、CLI の Google Workspace MCP サーバー

1. はじめに

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

演習内容

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

必要なもの

ウェブブラウザ（Chrome など）
Google Workspace デベロッパープレビュープログラムに登録されている Google Cloud プロジェクト
Google Workspace アカウント
ローカルマシンに Antigravity 2.0、IDE、CLI のいずれかがインストールされている。詳細とインストールガイダンスについては、公式ウェブサイトをご覧ください。

この Codelab に簡単にアクセス

2. 始める前に

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

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

API を有効にする

Google Workspace MCP サーバーを使用するには、標準の Google Workspace API を有効にする必要があります。

MCP サービスを有効にする

次に、Google Workspace 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 Cloud コンソールで、[Google Auth Platform] > [ブランディング] に移動します。構成されていない場合は、[開始] をクリックします。
[アプリ情報] を構成します。
- アプリ名: Google Workspace MCP Servers
- ユーザーサポートメール: 自分のメールアドレスを選択します。
[対象] を構成します。[内部] を選択します（内部が利用できない場合は [外部] を選択します）。
[Contact Information] を構成します。メールアドレスを入力します。
ユーザーデータに関するポリシーを確認して同意し、[作成] をクリックします。
[外部] を選択した場合は、[オーディエンス] に移動し、[テストユーザー] にメールアドレスを追加します。
[データアクセス] > [スコープを追加または削除] に移動します。[スコープの手動追加] で、使用するサーバーに応じて以下を追加します。
- フリーサイズ: 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
- Gmail: https://www.googleapis.com/auth/gmail.readonly、https://www.googleapis.com/auth/gmail.compose
- Google ドライブ: https://www.googleapis.com/auth/drive.readonly、https://www.googleapis.com/auth/drive.file
- Google ドキュメント: https://www.googleapis.com/auth/drive.readonly、https://www.googleapis.com/auth/drive.file、https://www.googleapis.com/auth/documents.readonly、https://www.googleapis.com/auth/documents
- Google スプレッドシート: https://www.googleapis.com/auth/drive.readonly、https://www.googleapis.com/auth/drive.file、https://www.googleapis.com/auth/spreadsheets.readonly、https://www.googleapis.com/auth/spreadsheets
- Google スライド: https://www.googleapis.com/auth/drive.readonly、https://www.googleapis.com/auth/drive.file、https://www.googleapis.com/auth/presentations.readonly、https://www.googleapis.com/auth/presentations
- 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.messages.create、https://www.googleapis.com/auth/chat.users.readstate.readonly
- People API: https://www.googleapis.com/auth/directory.readonly、https://www.googleapis.com/auth/userinfo.profile、https://www.googleapis.com/auth/contacts.readonly
[Add to Table]、[Update]、[Save] の順にクリックします。

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

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

4. Antigravity を構成する

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

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

Antigravity 2.0、IDE、CLI は、~/.gemini/config/mcp_config.json ファイル内の中央 MCP 構成を共有します。

任意のテキストエディタで開きます。
注: Antigravity IDE がインストールされている場合は、次の手順で Antigravity IDE から直接ファイルにアクセスできます。
1. エディタのエージェントパネルの上部にある [...] プルダウンから [MCP サーバー] を開きます。
2. [Manage MCP Servers]、[View raw config] の順にクリックします。
次のカスタム MCP サーバー構成に変更します。その前に、<YOUR_CLIENT_ID> プレースホルダと <YOUR_CLIENT_SECRET> プレースホルダを、前の手順で作成した OAuth クライアント ID とシークレットに置き換えます。
保存してください。

{
  "mcpServers": {
    "gws-universal": {
      "serverUrl": "https://workspacemcp.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-drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-sheets": {
      "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-slides": {
      "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "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-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
    ...
  }
  ...
}

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

構成したすべての MCP サーバー（gws-universal、gws-gmail、gws-drive、gws-docs、gws-sheets、gws-slides、gws-calendar、gws-chat、gws-people）が Antigravity にインストールされていることがわかります。OAuth トークンは一元管理されていないため、Antigravity のサーフェスごとにそれぞれを認証する必要があります。

Antigravity 2.0

左下の [設定] をクリックします。
[カスタマイズ] に移動します。
[Installed MCP Servers] で [Refresh] をクリックします。

インストールされている各 MCP サーバーについて、次の操作を行います。
1. [認証] をクリックします。
1. 開いた新しいブラウザウィンドウで認証フローを完了します。
2. 完了したら、[Copy to Clipboard] をクリックします。
1. コピーした認証コードを Antigravity 2.0 の設定に表示されているテキストフィールドに貼り付け、[Submit] をクリックします。
1. [Authenticate] の代わりに [Sign out] ボタンが表示されるようになりました。

Antigravity IDE

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

[カスタマイズ] に移動します。
[Installed MCP Servers] で [Refresh] をクリックします。

インストールされている各 MCP サーバーについて、次の操作を行います。
1. [認証] をクリックします。
1. 開いた新しいブラウザウィンドウで認証フローを完了します。
2. 完了したら、[Copy to Clipboard] をクリックします。
1. コピーした認証コードを Antigravity IDE の設定に表示されているテキストフィールドに貼り付け、[Submit] をクリックします。
1. [Authenticate] の代わりに [Sign out] ボタンが表示されるようになりました。

Antigravity CLI

「/mcp」と入力して Enter キーを押します。

一覧表示された各 MCP サーバーについて、次の操作を行います。
1. 上矢印キーと下矢印キーを使用して選択し、Enter キーを押します。
2. 左矢印キーと右矢印キーを使用して [Authenticate] を選択し、Enter キーを押します。
1. 表示された URL を新しいブラウザウィンドウで開き、認証フローを完了します。
1. 完了したら、[Copy to Clipboard] をクリックします。
1. Antigravity CLI が実行されているターミナルに表示されたテキストフィールドに、コピーした認証コードを貼り付けて、Enter キーを押します。
1. [Auth Needed]（認証が必要）の代わりに [Authed]（認証済み）ステータスが表示されます。

5. テストツール

自然言語を使用して Google Workspace データを操作できるようになりました。以下に、各サービスのプロンプトの例を示します。

全世界

さまざまなプロダクトを検索してみてください。

「Google Workspace アカウントで最後に発生したことを数文で要約して。」
「メール、ドキュメント、チャットメッセージから [プロジェクト名] に関連するものをすべて検索して。」
「マーケティングプランに関する次のミーティングはいつですか？また、それに関する最新のメモとチャットメッセージを教えてください。」

Gmail

メールを検索または管理してみてください。

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

Google ドライブ

ファイルの検索や読み取りを試します。

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

Google ドキュメント、スプレッドシート、スライド

ドライブのリソースを検索してみてください。

「Google ドキュメント [DOCS_TITLE] の構造的な内容を表示して。」
「Google スプレッドシート [SHEETS_TITLE] のシート Sheet1 を読み取る」
「Google スライド [SLIDES_TITLE] のレイアウトを音声で説明して。」

Google カレンダー

スケジュールを検索してみてください。

「今週の予定されている会議を教えて」
「明日の午後に空き時間はありますか？」

Google Chat

次の方法でメールを検索してみてください。

「[スペース名] で [キーワード] を含むメッセージを探して」

People API

プロフィールまたは連絡先を検索してみてください。

「私の Google プロフィールに登録されている名前を教えて」
「[名前] の連絡先情報を探して」

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

MCP の真の力は、複数のサービスにまたがるタスクをオーケストレートするときに発揮されます。サービス間の連携機能を示す、次のプロンプトを試してみてください。

「[プロジェクト名] のマイルストーンの更新に関連するファイルをドライブで検索し、その内容を要約して、[名前] のメールアドレスを見つけ、その要約を記載した 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 サーバーを構成してテストしました。