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 モデルがリモートサーバーから提供されるツールを安全に使用できるようにするオープン標準です。コードを記述せずに、Gmail、Google ドライブ、Google ドキュメント、Google スプレッドシート、Google スライド、Google カレンダー、Google Chat、People API とやり取りするように Antigravity を設定します。

演習内容

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
- ユーザーサポートメール: メールアドレスを選択します。
[**対象**] を構成します。[**内部**] を選択します（[内部] が使用できない場合は [**外部**] を選択します）。
[**連絡先情報**] を構成します。メールアドレスを入力します。
ユーザーデータに関するポリシーを確認して同意し、[作成] をクリックします。
[外部] を選択した場合は、[対象] に移動し、[テストユーザー] にメールアドレスを追加します。
[データアクセス] > [スコープの追加または削除] に移動します。[**スコープの手動追加**] で、使用するサーバーに次のものを追加します。
- フリーサイズ: 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
[テーブルに追加]、[更新]、[保存] の順にクリックします。

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

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

4. Antigravity を構成する

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

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

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

任意のテキストエディタで開きます。
注: Antigravity IDE がインストールされている場合は、次の手順でファイルに直接アクセスできます。
1. エディタのエージェントパネルの上部にある [...] プルダウンで [MCP Servers] を開きます。
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 サーバーを認証する

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

Antigravity 2.0

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

インストールされている MCP サーバーごとに、次の操作を行います。
1. [認証] をクリックします。
1. 新しいブラウザウィンドウで認証フローを行います。
2. 完了したら、[Copy to Clipboard] をクリックします。
1. コピーした認証コードを Antigravity 2.0 の設定に表示されるテキストフィールドに貼り付けて、[送信] をクリックします。
1. [認証] が [ログアウト] ボタンに置き換わります。

Antigravity IDE

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

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

インストールされている MCP サーバーごとに、次の操作を行います。
1. [認証] をクリックします。
1. 新しいブラウザウィンドウで認証フローを行います。
2. 完了したら、[Copy to Clipboard] をクリックします。
1. コピーした認証コードを Antigravity IDE の設定に表示されるテキストフィールドに貼り付けて、[送信] をクリックします。
1. [認証] が [ログアウト] ボタンに置き換わります。

Antigravity CLI

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

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

5. ツールをテストする

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

フリーサイズ

さまざまなプロダクトで検索してみましょう。

「Google Workspace アカウントで最後に発生したことを数文で要約して。」
「メール、ドキュメント、チャットメッセージ全体で [PROJECT_NAME] に関連するものを検索して。」
「マーケティングプランに関する次の会議はいつですか？また、最新のメモとチャットメッセージは何ですか？」

Gmail

メールの検索や管理を試してみましょう。

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

Google ドライブ

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

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

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

ドライブのリソースを検索してみましょう。

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

Google カレンダー

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

「今週の今後の会議は何ですか？」
「明日の午後は空いていますか？」

Google Chat

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

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

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 サーバーを構成してテストできました。