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 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 サーバーは独立して動作しますが、基盤となる標準 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 サーバーを認証する

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

Antigravity 2.0

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

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

Antigravity IDE

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

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

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

Antigravity CLI

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

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

5. ツールをテストする

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