Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 Chat、People API とやり取りするように Antigravity を設定します。

演習内容

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

必要なもの

ウェブブラウザ（Chrome など）
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 サーバーは独立して動作しますが、他の 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 とクライアントシークレットをコピーします。この 2 つは以降の手順で必要になります。

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-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>"
      }
    }
    ...
  }
  ...
}

保存してください。

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

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

Antigrativity 2.0

左下の [設定] をクリックします。
[カスタマイズ] に移動します。
[インストール済み MCP サーバー] で、[更新] をクリックします。

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

Antigrativity IDE

ウィンドウの上部にある [エディタ固有の設定] メニューのプルダウンから [Antigravity User Settings] を開きます。

[カスタマイズ] に移動します。
[インストール済み MCP サーバー] で、[更新] をクリックします。

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

Antigrativity 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 のデータを操作できるようになりました。各サービスのプロンプトの例を次に示します。