Gemini Enterprise の Antigravity を使用する Google Workspace MCP サーバー

1. はじめに

注: こちらはデベロッパー向けガイドではありません。このガイドは、Gemini Enterprise 管理者を対象としています。Google Workspace MCP サーバーを Antigravity 2.0、IDE、CLI に接続する方法については、Antigravity Codelab で Google Workspace MCP サーバーを使用するをご覧ください。

この Codelab を使用する対象のお客様は、Gemini Enterprise を使用して Antigravity でGoogle Workspace Model Context Protocol（MCP）サーバー を構成、管理、保護する方法を学習します。MCP は、AI エージェントがリモート バックエンド サービスによって公開されたツールを安全にクエリして実行できるようにするオープン スタンダードです。

複雑な機能、アーキテクチャ仕様、プロダクト要件ドキュメント（PRD）、ビジネス指標は、Google ドキュメント、スプレッドシート、ドライブに保存されます。ブラウザタブ間でテキストをコピーして貼り付けると、コンテキストが古くなり、データ漏洩のリスクが生じます。Gemini Enterprise を使用して Workspace MCP サーバーを接続すると、エンタープライズ グレードのガバナンスを適用しながら、デベロッパーにライブ コンテキストを提供できます。

エンタープライズ AI デベロッパー機能の詳細については、Antigravity Enterprise のブログ投稿をご覧ください。

演習内容

• Gemini Enterprise でAI デベロッパー ツール を有効にし、一元化されたMCP サーバーの許可リスト を構成します。
• Google Cloud でバックエンドの Google Workspace API と MCP API を有効にします。
• 内部組織に限定されたスコープ付きの OAuth 2.0 ウェブ アプリケーション認証情報 を構成します。
• 承認された Workspace MCP サービスを Antigravity 内に登録して認証します。
• 許可リストのブロック、ユーザー ACL のパリティ、監査ロギングなど、管理セキュリティ境界 を確認します。

必要なもの

• Google Chrome などのウェブブラウザ。
• 課金を有効にした Google Cloud プロジェクト、Gemini Enterprise 管理者アクセス。
• Google Workspace デベロッパー プレビュー プログラムに登録されている Google Cloud プロジェクト。
• ワークステーションにインストールされた Antigravity 2.0、IDE、CLI。詳細なインストール ガイドは、Antigravity ドキュメント サイトで入手できます。

2. Gemini Enterprise AI デベロッパー ツールと許可リストを有効にする

エンタープライズ セキュリティは、一元化されたガバナンスから始まります。個々のデベロッパーが MCP サーバーをローカルに登録する前に、Workspace 管理者が統合を承認する必要があります。

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

Google Cloud Console で、Google Cloud プロジェクトを作成または選択 します。

AI デベロッパー ツールを有効にする

1. Google Cloud コンソール を開きます。
2. ナビゲーション メニューで、Gemini Enterprise > 設定 に移動します。
3. [AI デベロッパー ツール] を選択し、スイッチを [有効] に切り替えます。

この設定により、承認されたチームメンバーは、エンタープライズ Google Cloud アカウントを使用して Antigravity セッションを認証できます。

MCP サーバーの許可リストを定義する

承認されていないサードパーティ ツール接続を防ぐため、管理者は承認された MCP サーバー エンドポイントの明示的な許可リストを定義します。

1. Gemini Enterprise > 設定 > AI デベロッパー ツール に移動します。
2. [セキュリティ] の横にある [編集] をクリックします。
3. [MCP サーバー] 設定を見つけて、[有効] に切り替えます。
4. [許可されたサーバー構成] フィールドに、承認された Google Workspace MCP サーバー構成を入力します。

{
  "mcpServers": {
    "remote_servers": [
      {
        "id": "drive",
        "url": "https://drivemcp.googleapis.com/mcp/v1"
      },
      {
        "id": "docs",
        "url": "https://docsmcp.googleapis.com/mcp/v1"
      },
      {
        "id": "sheets",
        "url": "https://sheetsmcp.googleapis.com/mcp/v1"
      }
    ]
  }
}

5. [保存] をクリックします。

ガバナンスと一元化された配布: この許可リストにより、組織はエージェント環境からアクセスできる Workspace API をきめ細かく制御できます。管理者は、MDM、Google Cloud Workstation テンプレート、フリート構成スクリプトを使用して、事前入力された mcp_config.json ファイルをエンジニアリング マシンにデプロイすることで、クライアント構成を一元的に管理できます。これにより、デベロッパーの手動構成のオーバーヘッドがなくなります。詳細については、AI デベロッパー ツール設定のドキュメントをご覧ください。

3. バックエンド API と OAuth 認証情報を構成する

管理ガバナンスを有効にして、リクエストをルーティングし、ユーザー認証を処理するように Google Cloud プロジェクトを構成します。

管理者の責任: 管理者は、プロジェクトまたは組織に対して OAuth 同意画面とクライアント ID を 1 回構成します。次に、このクライアント ID をエンジニアリング チームと共有して、Cloud Console の管理者権限がなくてもローカルの Antigravity 環境を構成できるようにします。

バックエンド API と MCP サービスを有効にする

標準の Google Workspace API と対応する MCP バックエンド サービスを有効にします。

1. Google ドライブ、ドキュメント、スプレッドシートの API を有効にします。

Workspace API を有効にする

2. Google ドライブ、ドキュメント、スプレッドシートの MCP サービスを有効にします。

MCP サービスを有効にする

OAuth 同意画面を構成する

1. Google Cloud コンソールで、Google Auth Platform > ブランディング （または API とサービス > OAuth 同意画面 ）に移動します。
2. [アプリケーション名] を WorkspaceMCPDemo に設定します。
3. [ユーザー サポートメール] と [デベロッパーの連絡先情報] を設定し、[保存して次へ] をクリックします。

オーディエンスを構成する

1. [オーディエンス] で、[内部] ユーザータイプを選択します。これにより、認証は組織内の Google Workspace ユーザーに厳密に制限されます。

OAuth 2.0 クライアント認証情報を作成する

1. Google Auth Platform > クライアント （または API とサービス > 認証情報 ）に移動します。
2. [クライアントを作成]（または [認証情報を作成] > [OAuth クライアント ID]）をクリックします。
3. アプリケーション タイプとして [ウェブ アプリケーション] を選択します。
4. [名前] を WorkspaceMCPDemoClient に設定します。
5. [承認済みのリダイレクト URI] で、[+ URI を追加] をクリックして「https://antigravity.google/oauth-callback」と入力します。
6. [作成] をクリックして、クライアント ID とクライアント シークレット を記録します。

4. Antigravity MCP サービスを構成する

管理者の設定を確認し、デベロッパー向けのオンボーディング ガイドを準備するには、Antigravity 内で承認された MCP サービスを構成します。

デベロッパーのオンボーディングと一元管理のオプション: 次の構成は、エンジニアリング チームに配布する（または一元化された構成管理でデプロイする）ものです。デベロッパーは、組織の OAuth 認証情報をローカルの mcp_config.json ファイルに追加するだけで済みます。また、IDE と CLI の完全なチュートリアルについては、コンパニオン デベロッパー Codelab を共有することもできます。

承認された MCP サーバーを登録する

Antigravity は、~/.gemini/config/mcp_config.json にある中央構成ファイルを使用します。

1. 任意のテキスト エディタで ~/.gemini/config/mcp_config.json を開きます（または、Antigravity で [設定] > [カスタマイズ] に移動して、[MCP 構成を開く] をクリックします）。
2. 許可リストに登録されたサービス（drive、docs、sheets）の定義を入力し、<YOUR_CLIENT_ID> と <YOUR_CLIENT_SECRET> を OAuth 認証情報に置き換えます。

{
  "mcpServers": {
    "drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "sheets": {
      "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
  }
}

3. ファイルを保存 します。
4. Antigravity の [設定] > [カスタマイズ] に戻り、[更新] をクリックします。Google ドライブ、ドキュメント、スプレッドシートが、有効なインストール済み MCP サーバーの下に表示されます。

5. ライブ Workspace ドキュメントを認証してクエリする

エージェントがツール呼び出しを行う前に、ユーザー セッションを OAuth 認証情報にリンクして、エンドツーエンドの機能を確認します。

OAuth ハンドシェイクを完了する

1. [カスタマイズ] パネルで、アクティブなサービスの横にある [認証] をクリックします。
2. エンタープライズ Google Workspace アカウントで、ブラウザベースの OAuth フローを完了します。
3. 認証されると、各サーバーに登録済みのツール（read_doc、get_spreadsheet、search_files など）が表示されます。

グラウンディングされたエージェント プロンプトを実行する

エージェントがチャット インターフェースからライブ Workspace ファイルを直接読み取って合成できることを確認します。

プロンプト 1: 構造化された Google スプレッドシート データを抽出する

Read the 'Pricing Catalog' Sheet in my Google Drive and list our three most expensive items along with their specifications.

エージェントは sheets.get_spreadsheet を呼び出し、表形式のデータを解析して、正確な数値を含む上位の項目を返します。

プロンプト 2: Google ドキュメントからアーキテクチャ仕様を合成する

Read the 'PRD: Online Storefront' Google Doc in Drive. Summarize the architectural requirements and highlight any missing security considerations.

エージェントは docs.read_doc を呼び出して最新のリビジョンを取得し、機能、リスクポイント、推奨事項の実用的な概要を提供します。

6. エンタープライズ セキュリティ境界とガバナンスを確認する

エンタープライズ デプロイには、検証可能なセキュリティ境界が必要です。Gemini Enterprise と Antigravity がポリシー制約を適用する方法をテストします。

テスト 1: 厳格な管理許可リストの適用

デベロッパーが承認されていない MCP サーバーに接続できないことを確認します。

1. ~/.gemini/config/mcp_config.json を開き、承認されていないサーバー定義（People API など）を追加します。

{
  "mcpServers": {
    "people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
  }
}

2. Antigravity の [設定] > [カスタマイズ] で、[更新] をクリックします。
3. Antigravity は接続を停止します。承認されていないサーバーには Unauthorized / Blocked by Admin Policy 状態が表示され、初期化またはクエリできません。
4. mcp_config.json から承認されていないエントリを削除し、もう一度 [更新] をクリックします。

テスト 2: ユーザー ID と ACL のパリティ

Workspace MCP 統合では、標準のアクセス制御リスト（ACL）が適用されます。

• 権限昇格なし: エージェントは、認証されたユーザーの OAuth アクセス トークンの下でのみ動作します。
• アクセス適用: デベロッパーに特定の Google ドキュメントまたはドライブ フォルダを表示する権限がない場合、エージェントは HTTP 403 Forbidden エラーを受け取り、ファイルを検査できません。
• 監査ロギング: エージェントによって生成されたすべての API 呼び出しは、Google Cloud Audit Logs の認証済みユーザーの ID で記録されます。

7. クリーンアップ

この Codelab で作成したリソースをクリーンアップするには:

1. Google Cloud コンソールで、[API とサービス] ダッシュボード に移動します。
2. 有効になっている各 MCP サービス（drivemcp.googleapis.com、docsmcp.googleapis.com、sheetsmcp.googleapis.com）を選択し、[API を無効にする] をクリックします。
3. [Google Auth Platform] > [クライアント] で、WorkspaceMCPDemoClient OAuth クライアント認証情報を削除します。
4. [Gemini Enterprise] > [設定] > [AI デベロッパー ツール] で、不要になった場合は MCP サーバーの許可リストを無効にします。

8. 完了

おめでとうございます！Gemini Enterprise を使用して、Antigravity の Google Workspace MCP サーバーの一元化されたガバナンス、許可リスト、スコープ付き OAuth 認証を構成して確認しました。

学習した内容

• Gemini Enterprise でAI デベロッパー ツール を有効にし、MCP サーバーの許可リスト を定義しました。
• Google Cloud でバックエンドの Google Workspace API と MCP サービス を有効にしました。
• スコープ付きの内部 OAuth 2.0 ウェブ アプリケーション認証情報 を生成しました。
• Antigravity での正のデータ取得 と負のポリシー適用 を確認しました。
• 最小権限のセキュリティ境界 と監査ロギングを検証しました。

次のステップ: デベロッパーと共有する

エンタープライズ環境が構成され、保護されたら、コンパニオン デベロッパー ガイドをエンジニアリング チームと共有します。

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

リファレンス ドキュメント

• Gemini Enterprise の AI デベロッパー ツール
• Google Workspace MCP サーバーを構成する
• Antigravity Enterprise の概要
• Model Context Protocol（MCP）仕様