Antigravity は Google のエージェント型エディタで、MCP サーバーの設定方法は Claude Desktop と同じ種類です。JSON ファイルにブロックを1つ置き、どのプログラムを起動すべきかをエディタに伝えます。ただし、ほかのクライアントと違う癖が1つあります。Antigravity はこのファイルを起動時にしか読みません。そのため、保存しても接続が見えないとき、多くの人はとっくに正しくなっているファイルの中で原因を探すことになります。設定までのクリック経路、コピーできるブロック、そしてそれがなければ何も起きない再起動を、以下にまとめました。
この記事の動画
動画（ドイツ語）は 本記事のドイツ語版 に埋め込まれています。
必要なもの
- 最新バージョンの Merlin Project、MCP サーバーがインストール済み、プロジェクトが共有済み
- Mac 版 Antigravity
Merlin 側はどのクライアントでも同じです。
- サーバーをインストールします。 Merlin Project の Merlin Project メニューから Install MCP Server を選びます。Merlin が小さなプログラムを Mac に置きます。AI クライアントと計画をつなぐ橋です。パスはインストーラーが表示します。
/usr/local/bin/merlinproject-mcpです。 - プロジェクトを共有します。 プロジェクトを開き、ツールバーの AI Tools をクリックします。AI ツールによるドキュメントの操作を許可 にチェックを入れると、アイコンが塗りつぶされて表示されます。共有はそのプロジェクト1つだけに適用され、ほかのプロジェクトはサーバーから見えないままです。クライアントが接続すると、アイコンは青に変わります。
ローカル · 読み取り専用 · 外部から到達不可。 サーバーはあなたが共有したプロジェクトしか読まず、データを一切変更せず、外部からは誰も到達できません。クラウド型のクライアントが読み取ったデータをどこまで見るかは、データ保護の記事で説明しています。
ステップ1: 設定を書き加える
設定ファイルへの道はエージェントセッションを通ります。
- Antigravity で エージェントセッション を開きます。
- サイドパネルの … メニューから MCP Servers を選びます。
- MCP ストアの上部で Manage MCP Servers、続いて View raw config をクリックします。
mcp_config.jsonが開きます。 - 次のブロックを書き加えて保存します。
merlin-project の設定ブロック mcp_config.json
{
"mcpServers": {
"merlin-project": {
"command": "/usr/local/bin/merlinproject-mcp"
}
}
}大切な点があります。書き加えるだけにしてください。すでに内容がある場合は何も削除しないでください。削除すると、設定済みのほかのサーバーを Antigravity が失います。
ステップ2: Antigravity を再起動する
保存して MCP の一覧を見ると、Merlin がありません。設定は入っているのに、Antigravity は接続を表示しません。理由はこうです。Antigravity はこのファイルを起動時にしか読みません。 アプリが動いているかぎり、何度保存してもあなたの追記を知りません。
だから2つ目のステップは完全な再起動です。ウィンドウを閉じるだけでは足りません。Cmd+Q で Antigravity を終了し、開き直してください。そのあと、接続済みサーバーの一覧に merlin-project が並びます。この手順を飛ばすと接続は見えず、とっくに正しいファイルの中で原因を探すことになります。
最初の質問: フェーズをチェックリストに
再起動のあとは質問できます。動画では、アクティビティのグループをチェックリストとして出力し、そのままチームへ渡せる形にしています。
プロンプト: フェーズをチェックリストにするにはどうすればよいですか？
アクティブなプロジェクトのグループ {PHASE} のすべてのアクティビティを、Markdown のチェックリストとして書き出してください。アクティビティごとに1行とし、チェックボックス、割り当てられたリソース、日程を入れてください。完了済みのアクティビティには完了の印を付けてください。リストはそのままメモや Wiki に貼り付けられるようにしてください。プレースホルダーをフェーズの名前、たとえば「4 Go-to-Market」に置き換えてください。Antigravity は計画からアクティビティ、割り当て、進捗を読み取り、チェックリストと表を返します。どちらもそのまま使えます。
再起動しても何も出ないとき
- JSON の確認。 カンマが1つ欠けるだけで、Antigravity はファイルを破棄します。このページからブロックをコピーしてください。
- パスの確認。 Merlin Project のインストーラーがパスを表示します。ファイル内の値と完全に一致している必要があります。
- 共有の確認。 Merlin で「AI Tools」からプロジェクトを共有していますか。
- 本当に終了しましたか。 赤い閉じるボタンではアプリは終了しません。Dock で Antigravity がまだ動いていないか確かめ、そのうえで Cmd+Q を押してください。
チェックリスト
練習にはサンプルプロジェクト Produktlaunch Phoenix が向いています。ほかの書き出し形式は プロンプトライブラリ にあります。すべてのセットアップ手順はこちらです。
- Claude Desktop: 1ファイルに1ブロック、再起動
- LM Studio: モデルをダウンロード、1ファイルに1ブロック
- Claude Code: コマンド1つ
- Codex: コマンド1つ
- Antigravity （この記事）: 1ファイルに1ブロック、完全な再起動
- ChatGPT: コピーブリッジまたはインテリジェントアシスタント
- どの AI クライアントが合うか
このブログ記事についてご質問やご意見がございましたら、ぜひフォーラムへのご投稿をお待ちしております。
