Antigravity IDEのMCPサーバー設定ガイド

Antigravity IDEのMCPサーバーでできること

Model Context Protocol（MCP）は、エージェントが外部ツールや外部コンテキストを共通の方法で利用するための規格です。MCPサーバーは、データベースのスキーマ、ドキュメント、課題管理、クラウド資源、ファイル解析、外部APIなどをツールとして公開できます。Antigravityは設定されたローカルプロセスを起動するか、指定されたリモートエンドポイントへ接続し、利用可能なツールを読み込みます。

MCPサーバーの追加は、テーマの追加とは危険度が異なります。ローカルstdioサーバーは端末上でコマンドを実行します。リモートサーバーはデータを受け取り、OAuthやトークンを求める場合があります。追加前に、提供元、読み取るデータ、書き込み可能な操作、ワークスペース外へのアクセスが本当に必要かを確認してください。

この手順はGoogleの現行ドキュメントに合わせ、Antigravity IDEとAntigravity CLIを区別しています。IDEにはMCP StoreとJSON編集があります。CLIには対話型の/mcp管理画面がありますが、CLIで見える状態だけではデスクトップIDEが同じ設定を読み込んだとは判断できません。

グローバル設定とプロジェクト設定の選び方

必要な範囲だけに限定します。複数案件で常用する個人ツールはグローバル、共有・レビュー・削除をプロジェクト単位で行いたいサーバーはワークスペース設定が向いています。

MCP Storeからサーバーをインストールする

実際のプロジェクトを開き、ログインと初期化が終わるまで待ちます。エージェントパネル上部の3点メニューからMCP Serversを選びます。対応サーバーにカーソルを合わせてInstallを選ぶか、詳細を先に読みます。公式の認証フローを完了し、一覧に戻って表示と状態を確認します。

最初は1台だけ追加してください。同時に多くのサーバーを入れると、どのプロセス、認証情報、ツール定義が失敗したか切り分けにくくなります。エージェントが選ぶツールも増えます。提供元が明確な1台、1つの認証、1つのテスト要求から始める方が安全です。

1. 手順1 — エージェントパネルの3点メニューを開きます。
2. 手順2 — MCP Serversを選び、提供元と要求権限を確認します。
3. 手順3 — 1台をインストールし、公式認証を終えて再読み込みします。
4. 手順4 — 安全な読み取りを依頼し、結果と許可内容を確認します。

mcp_config.jsonで独自サーバーを追加する

Storeにない場合はManage MCP ServersからView raw configを開きます。公式に案内されているグローバルファイルは~/.gemini/config/mcp_config.json、プロジェクト用は.agents/mcp_config.jsonです。ルートには1つのmcpServersオブジェクトを置きます。command、args、エンドポイント、認証方式は必ずサーバー提供元の一次資料から取得します。

下の例は意図的に動作しません。stdioではcommandとargsでプロセスを起動します。現行のリモート設定ではGoogleはserverUrlを案内しており、古いurlやhttpUrlは認識されない可能性があります。パッケージ名やCDNの規則からURLを推測せず、秘密鍵をGitへ保存しないでください。

{
  "mcpServers": {
    "example-server": {
      "command": "OFFICIAL_COMMAND",
      "args": ["OFFICIAL_ARGUMENT"]
    },
    "example-remote": {
      "serverUrl": "https://OFFICIAL_EXAMPLE_ENDPOINT/mcp"
    }
  }
}

これは構造例であり、実在する接続先ではありません。実行ファイル、URL、ヘッダー、OAuth設定は選んだサーバーの公式資料だけから取得してください。

MCPサーバーを再読み込みして確認する

有効なJSONを保存し、サーバー一覧へ戻って再読み込みします。正しく読まれると、サーバー名とツールまたはリソースを確認できます。最初から書き込みを依頼せず、利用可能なリソースの一覧、機密性のないテスト文書の読み取り、ツール名の表示などから始めます。

認証がある場合は、利用中のアカウントと許可範囲を確認します。緑色の状態表示は接続を示すだけで、機密データへの利用が安全という意味ではありません。ツール名、引数、返された出典を確認してから、許可を記憶させるか判断します。

• 読み込み — 期待したサーバー名が表示され、ツール一覧を確認できます。
• 認証 — アカウントと許可範囲が目的のプロジェクトに一致します。
• 根拠 — 読み取りテストが想定した情報源を返します。
• 復旧 — 設定の無効化、トークン失効、項目削除の方法が分かります。

MCPのセキュリティと権限ルール

各サーバーを、データ境界をまたぐコードとして扱います。一次提供元または内容を確認できるリポジトリを優先し、可能ならバージョンを固定します。出所不明の手順にあるダウンロード即実行コマンドは避けます。データベースやクラウドには、本番所有者ではなく最小権限の開発用アカウントを使います。

プロジェクト設定に置いても自動的にサンドボックス化されるわけではありません。プロセスはOSアカウントが許可する範囲を読める可能性があります。秘密情報をプロンプトやコミット対象JSONに入れません。書き込み、削除、デプロイ、決済、メッセージ送信、アカウント管理は、明確な運用規則ができるまで毎回レビューします。

Antigravity IDEとWSLのMCPエラーを直す

主な原因は、設定範囲の違い、JSONエラー、PATH、認証、WindowsとWSLのパス混在です。一度に1項目だけ変更します。

再読み込みしてもサーバーが表示されない

JSONを検証し、mcpServersがルートにあるか、Manage MCP Serversが示したファイルを編集したか確認します。別のグローバルまたはローカル設定も探します。通常の再読み込みが失敗してからIDEを再起動します。

通常のターミナルでは動くがIDEでは動かない

GUIプロセスのPATH、ホーム、シェル、環境変数が異なる場合があります。提供元が対応していれば実行ファイルを絶対パスで指定し、システム環境を変えた後はAntigravityを開き直します。

WSLからMCPを起動できない

どちらのOSがプロセスを起動するか決めます。Windows版IDEからLinuxコマンドを動かす場合はwsl.exeを明示し、その内部ではLinuxパスを使います。WSLプロセスへC:\をLinuxパスのように渡しません。同じコマンドをIDE外で先に試します。

リモート接続はできるがツールがない

公式エンドポイント、認証、トランスポートを確認します。現行設定はserverUrlを使います。製品紹介ページや管理画面のURLはMCPエンドポイントではありません。

起動と停止を繰り返す

秘密情報を出さずにプロセスを直接実行しstderrを確認します。ランタイム不足、非対応バージョン、stdoutへの余計なログ、期限切れ認証が代表例です。

最新版とダウンロード元の確認

本サイトはソフトウェアのダウンロード情報を扱うため、公開前に最新版を確認しました。2026年7月24日時点でGoogle公式changelogは2026年6月25日付のv2.2.1を掲載していました。サイト側もすでにv2.2.1だったため、バージョン番号の更新は不要でした。このページは未確認の容量、チェックサム、安全性診断、固定パッケージURLを作りません。

ダウンロードボタンは検証済みの公式ページへ移動します。段階配信の場合があるため、インストール時にもう一度確認してください。現在のMCPパスとリモート設定形式は、下記の公式ドキュメントを最終基準とします。