Antigravity MCPの設定と活用法：サーバー追加からトラブル解決まで

Antigravity の MCP 対応、どこまでできるのか？

開発プラットフォームとしての全体像

室谷代表取締役

Antigravity、単なるエージェント管理ツールじゃなくて、2.0になって独立したアプリとして動くようになったんですよね。macOS・Windows・Linuxで動くし、IDEなしでエージェントを並行運用できる。

開発者向けの製品というより、もう"開発の基盤"ですよ。

テキトー教師.AI認定講師

たしかに、最初に触ったとき「IDEの中に入ってるヘルパー」だと思ってたら、独立したアプリとして起動してびっくりしました。しかも定期的にタスクを回す予定実行までできると聞いて。

室谷代表取締役

予定実行って、夜中にコード生成回して朝にはレビュー待ちが揃ってる、みたいな運用ですよね。時間単価で考えると相当な生産性の差になる。

テキトー教師.AI認定講師

そう、ここ数年で"エージェントをどう並行運用するか"が開発の中心になりつつある気がします。

MCP がもたらす外部ツール連携のイメージ

室谷代表取締役

で、ここに MCP が乗っかってくると、エージェントの"できること"が一気に広がるんですよ。外部ツールとやりとりする窓口が標準化されるんで、プロジェクトごとに連携先を切り替えられる。

テキトー教師.AI認定講師

そうですね。MCP のいいところは、"このツールにはこのコードで接続"みたいな個別実装をしなくて済むこと。

設定ファイルにサーバーを足すだけで、エージェントが使える外部機能が増える。初めての人でも「あ、これ追加するだけなんだ」ってなりやすい部分です。

室谷代表取締役

外部連携の事例がBlenderとかFigma、Unityあたりにも広がってますからね。エージェントが3Dモデル触ったり、デザインデータ参照したり。

これ、制作系の現場だとROIが跳ねるんですよ。

IDE版とアプリ版、どちらで設定する？

テキトー教師.AI認定講師

ただ、ここで最初に戸惑うのが「設定する場所」。独立アプリ版と、IDE版でどっちを使えばいいんだろうって。

室谷代表取締役

両方あって、それぞれ役割が違うんですよ。IDE版はコードベースを深く見ながらエージェントを動かす開発者向け、独立アプリ版は複数のエージェントをまとめて管理したい人向け。

テキトー教師.AI認定講師

ああ、開発フローにどっぷり浸かるならIDE版、並行運用がメインなら独立アプリ版、みたいな使い分けですね。"どっちが正解"ではなくて、場面で選ぶ感じ。

室谷代表取締役

そう。どちらでもMCPの設定はできる構造になってるはずなんで、自分が普段開いてる方を起点にするのがいいと思います。

MCP サーバーを追加する前に知っておきたい基本

MCP とは何か：エージェントに道具を渡す仕組み

テキトー教師.AI認定講師

MCPを一言で説明すると、「エージェントに道具を持たせるための共通レール」なんですよ。Blender を操作したい、Figma のデータを読ませたい、みたいな時に、ツールごとに独自APIを覚えさせるんじゃなくて、この規格に沿って渡せば動く。

室谷代表取締役

なるほど。つまり、エージェント側が「この道具はこう使う」って理解できる窓口を、ツール側が統一して用意する感じですね。

これがあると、新しいサービスを組み込むたびにゼロから教え込む手間が消える。

テキトー教師.AI認定講師

そうです。最初に戸惑うのが「MCPって何が解決してくれるの？」ってところなんですけど、ここが分かると設定の意味も見えてきますよ。

サーバー追加でできること／できないこと

テキトー教師.AI認定講師

サーバーを追加すると、そのツールの操作権限をエージェントに渡せます。たとえば Blender 系のMCPを入れると、シーンの操作やデータ取得を指示できるようになる。

ただ、あくまで「できるようになる」だけで、すべて自動で完璧にやってくれるわけじゃない。

室谷代表取締役

そこ、大切ですよね。できることとできないことを事前に押さえておかないと、期待値だけが先行して「思ってたのと違う」になりがち。

経営目線で言うと、これはツール導入のROIと同じで、何を自動化したいかを先に決めてから導入するかどうかを判断するのが正しい順番です。

テキトー教師.AI認定講師

たしかに。最初に「とりあえず全部繋いでみよう」となる人も多いんですけど、使う用途が決まってないと、結局どのサーバーが役に立ったのか分からなくなっちゃうんですよ。

MCP 設定を始める前に確認したい環境条件

テキトー教師.AI認定講師

設定を始める前に確認したいのが、自分の環境で Antigravity が動いているかどうか。公式のドキュメントでは macOS、Windows、特定のLinuxディストリビューションに対応しています。

あとはChromeブラウザとGmailアカウントが必要になるケースもあるので、そこは事前に用意しておきたいですね。

室谷代表取締役

環境まわりで詰まるのはもったいないですからね。私の現場でも、新メンバーが最初にハマるのはだいたいここです。

「アプリは入れた、MCPの設定ファイルも書いた、なのに動かない」ってなってから見ると、OSの対応状況を確認していなかった、みたいな。

テキトー教師.AI認定講師

そうそう。入れる前に公式の最新情報を確認するのが一番の近道です。

あと、この先の設定作業に入る前に「どのプロジェクトで何をさせたいか」を一言で言えるようにしておくと、サーバー選びもスムーズになりますよ。

mcp_config.json の書き方とサーバー追加の流れ

設定ファイルの基本構造と記入例

テキトー教師.AI認定講師

Antigravity でも MCP サーバーを使うには、設定ファイルにサーバー情報を足していくのが基本です。フォーマットは他の MCP 対応ツールと似ていて、サーバー名をキーに、起動コマンドや引数、環境変数を書く形ですね。

室谷代表取締役

そうそう。MYUUU の現場だと、エンジニアがこの設定ファイルをテンプレートとして共有してますね。

1台書けば他のメンバーが同じ構成をコピーできるから、チーム展開が速いんですよ。

テキトー教師.AI認定講師

実際に書くときは、こんな形になります。

{
  "mcpServers": {
    "example-server": {
      "command": "npx",
      "args": ["-y", "example-mcp"]
    }
  }
}

室谷代表取締役

この設定ファイル、ある意味「サーバーの住所」みたいなもの。住所が間違ってると接続できないんで、書き間違えはここでつまずきますよね。

サーバー追加時に最初に戸惑うポイント

テキトー教師.AI認定講師

最初に戸惑うのは、設定ファイルをどのディレクトリに置くか、ですね。プロジェクト単位なのか、ユーザー単位なのかで読み込まれる場所が変わるとか、環境によっても違うので、まず公式の手順を確認するのが近道です。

室谷代表取締役

そうなんですよ、場所が違うと「書いたはずなのに反映されない」ってなる。システム開発でも、設定ファイルの置き場の統一って地味に大事で、そこを決めておくと運用コストが下がるんですよね。

テキトー教師.AI認定講師

あとは、起動コマンドの指定。MCP サーバーは node で動くものも多いので、該当のランタイムが入ってないと動かない、というケースもよくあります。

エラーメッセージだけ見ると原因が分かりにくいですから。

室谷代表取締役

環境変数も盲点ですね。APIキーを env に書くなら、チームで共有するときは管理に気をつけないと。

ROI で考えると、ここで事故ると後で大きなコストになります。

設定を反映して接続を確認する手順

テキトー教師.AI認定講師

設定を書き換えたら、サーバーを起動し直して接続を確認します。多くのツールでは設定変更後に再読み込みが必要なので、まずそこをやってみるのが手順の基本です。

室谷代表取締役

うちのチームでも「設定変えたのに効いてない」って相談はよく来ます。再起動してないだけ、というケースが大半ですね。

まずリロード、次にログ、という順番で見るのが効率的です。

テキトー教師.AI認定講師

接続確認では、MCP サーバーの一覧に表示される状態を見るのが分かりやすいです。ツールによっては「接続済み」みたいな表示になるので、そこで確認できます。

室谷代表取締役

ちゃんと接続できれば、あとはプロジェクトごとにどう使うか、という話に進めます。次に Blender や Figma など用途別の話につながっていきますね。

Blender / Figma / Unity などプロジェクト別 MCP 活用法

デザインツールとの連携で変わる制作フロー

テキトー教師.AI認定講師

うちの現場でも、Figma と MCP をつないでデザインの状態をそのまま読み込む使い方が増えてます。手動で書き出す手間が消えるので、作り手の感覚としては「画像をコピペする感覚」に近い。

ただ、最初に戸惑うのは接続先をどう指定するか、ですね。

室谷代表取締役

そこ、わかります。MCP 自体は仕組みとして「何にでもつながる」んですけど、接続先が多すぎると逆に選べなくなる。

うちの現場でも「まずは一つのツールに絞って、慣れたら広げる」って運用にしてます。

テキトー教師.AI認定講師

同じ場所で「まず一択」ってアドバイスしてます。Figma を選ぶなら Figma のファイル整理から始めるのがおすすめで、Blender だったらアセット管理を任せるのが分かりやすい。

室谷代表取締役

そうやってプロジェクト単位で役割を固定すると、チームの導入コストも下がります。ROI で見ても、最初から全部つなぐより段階的に増やす方が早いんですよね。

ゲーム開発（Unity）で MCP を使う場面

テキトー教師.AI認定講師

Unity との連携だと、シーンの状態やコンポーネントの情報を取ってくる用途が定番です。エディタを開かずに「今の設定どうなってる？」って確認できるので、コードを書くときの脳内コンテキストが途切れない。

あと、エラーが出たときにログを読ませるのも効果的。

室谷代表取締役

なるほど。ゲーム開発ってイテレーションの速さが命なので、確認のたびにエディタを往復する時間がもったいない。

US のスタジオだと、こういう「確認作業の自動化」を当たり前に取り入れてますね。

テキトー教師.AI認定講師

そうそう。「まずは動かして試す」ために、MCP 経由でプロジェクトの状態を参照できると、手元の操作に集中できます。

最初に接続するところさえクリアできれば、あとは自然に使えるようになりますよ。

室谷代表取締役

最初の接続設定でつまずく人が多いんですか？

テキトー教師.AI認定講師

実はそこが一番多いつまずきポイントですね。接続先の指定や権限まわりで「あれ、動かない」となりがち。

でも、一度通ればあとは安定します。

外部サービス（NotebookLM など）とつないでみる

テキトー教師.AI認定講師

開発ツール以外だと、NotebookLM みたいな外部サービスも MCP 経由で呼べるのが面白いところです。ドキュメントを調べる文脈で「この情報、先に NotebookLM にまとめさせてから読み込む」みたいな使い方も出てきます。

室谷代表取締役

それは便利そうですね。プロジェクトに応じて「どのサービスを MCP で呼ぶか」を決めておくと、チームの標準フローに落とし込みやすい。

個人的には、まずは自分が一番触るツールをつないでみるのがいいと思ってます。

テキトー教師.AI認定講師

その感覚、大事です。とりあえず興味のあるものを一つ選んで試してみると、次に「あれもこれもつなぎたい」ってなったときに、どう広げるかの判断ができるようになります。

Antigravity の MCP 周りも、一度流れをつかめば応用は自由ですから。

室谷代表取締役

何より、つなぐことで「こんなことできるんだ」という発想が生まれるのが大きい。その発想が新しい制作フローのきっかけになるので、まずは気軽に遊んでみるのが一番ですね。

MCP サーバーが動かないときのトラブルシューティング

設定ミスでよくあるパターン

テキトー教師.AI認定講師

MCP サーバーを追加したのに動かない、という相談は本当によく聞きます。原因の大半は、設定ファイルの書き方ミスか、パスの通し忘れなんですよね。

室谷代表取締役

うちの現場でもそれ、めちゃくちゃあります。結局、人間が手で書いてるところがボトルネックになる。

テキトー教師.AI認定講師

たとえば、JSON のカンマが一つ足りないだけで、サーバー自体が読み込まれない。最初に戸惑うのは、エラーが「サーバーが見つかりません」みたいな、ちょっと違う形で出ることですね。

室谷代表取締役

だからこそ、設定を書き終えたら、まず一度 Antigravity を再起動してから動かす癖をつけるのが早いです。

接続失敗時のログと切り分け方

室谷代表取締役

動かないときに大事なのは、切り分け作業ですね。Antigravity 側のログと、MCP サーバー側のログ、どっちで失敗してるかを分けると、原因が絞りやすい。

テキトー教師.AI認定講師

たしかに。接続失敗の多くは、サーバーの起動が間に合ってないか、認証情報が正しく渡ってないかのどっちかです。

室谷代表取締役

うちのチームの動き方で言うと、まず MCP サーバー単体で動くことを確認してから、Antigravity に繋ぐ順番にしてます。こうすると、切り分けが一気に楽になるんですよね。

テキトー教師.AI認定講師

あとは、ログに表示されるエラーコードをそのまま検索するより、前後のログをまとめて見た方が、原因に辿り着きやすいです。

セキュリティと権限設定のベストプラクティス

テキトー教師.AI認定講師

動くようになった後で重要になるのが、権限の設定です。MCP サーバーによっては、ファイルやコマンドへのアクセス権を別途付与しないと動かないことがあります。

室谷代表取締役

ここは緩めにすると事故るので、最初は最小限の権限だけ渡して、足りない分を足していくのが安全です。ROI で考えると、後から権限を絞るより、最初に絞っておく方がトータルの手間が少ない。

テキトー教師.AI認定講師

特に、社内のデータを扱うようなサーバーだと、アクセスできる範囲を限定しておかないと、AI が予想外の場所まで読んじゃうことがありますからね。

室谷代表取締役

そういう事故を防ぐためにも、設定ファイルの変更は Git で管理しておくのがいいです。誰がいつ変えたか追える状態にしておくのが、実は一番のセキュリティ対策だったりします。

テキトー教師.AI認定講師

まさに。再現できる状態を残しておけば、トラブルが起きてもすぐ戻せるので、安心感が全然違いますから。

MCP 導入の費用対効果を考える

開発効率の向上は「時給換算」で見える

室谷代表取締役

社内でMCPの導入を検討するとき、最初に考えるのは「これって本当に作業時間が減るの？」という一点ですね。抽象的に「便利」と言っても説得力がないので、うちの現場では「時給換算で何分浮いたか」で測るようにしています。

テキトー教師.AI認定講師

たしかに、初めて触る人からすると「MCPって何が便利なの？」というのが正直なところですよね。でも、実際に設定してみると、ファイルを開いてコピーして貼り付けて……という作業が一気に飛ぶ感覚があります。

室谷代表取締役

その「飛ぶ感覚」を数字にすると説得力が出るんですよ。1日30分の節約でも、月にすると10時間。

時給3000円なら月3万円の価値です。AntigravityのMCP設定にかかる初期工数を考えると、1週間も経てばペイする計算になりますね。

テキトー教師.AI認定講師

なるほど、その計算は実務でありがたいです。最初に戸惑うのは「どのサーバーを追加すればいいんだろう」という選定の部分だけなので、そこさえ越えれば確かに時間は戻ってきます。

導入コストと運用コストのバランス

室谷代表取締役

導入コストで言うと、MCPサーバーの設定自体は設定ファイルに記述を足すだけですから、正直そんなに手間じゃないですよね。問題は運用コストのほうで、サーバーが増えると管理する対象も増える。

ここは結構シビアに見ないといけない。

テキトー教師.AI認定講師

実はそうなんですよ。1個2個なら簡単なんですけど、プロジェクトごとにサーバーを追加していくと「どの設定がどこに書いてあったっけ」ってなる人は多いです。

ただ、Antigravityだと設定ファイルを1か所にまとめて管理できるので、その混乱はかなり減ると思います。

室谷代表取締役

そこは整理のルールが効いてきますね。うちでは「プロジェクト単位で必要なサーバーだけを有効にする」という運用にしています。

全部を常時オンにすると、起動も遅くなるし、エージェントの判断も散らかる。ROIで考えると、絞るほうが結果的に速いんですよね。

テキトー教師.AI認定講師

最初に全部入れたくなる気持ちは分かるんですけど、確かに必要最小限が正解です。追加のしやすさが分かれば、あとから足すのは怖くないので、まずは少なめから始めるのがいいと思います。

チームで MCP を運用するときのルール

室谷代表取締役

チームで使うとなると、個人の設定がそのまま共有されるわけじゃないので、どこまでを共通化するかという話になりますね。うちの現場では、まずは設定ファイルをテンプレート化して共有し、各自が自分のプロジェクト用にカスタマイズする形にしています。

テキトー教師.AI認定講師

チームで使うときにありがちなのが、誰かの環境で動いた設定が別の人の環境では動かない、というケースです。これはMCPに限らない話ですけど、チームで運用するなら「どのサーバーを入れるか」の基準を決めておくとトラブルが減ります。

室谷代表取締役

そうそう、ここが結構大事で。新しいサーバーを試すときは「個人の環境で試してから共有する」という流れにしています。

これをやらないと、知らない間に誰かが設定を変えていて「昨日まで動いてたのに」ってなるんで。

テキトー教師.AI認定講師

その流れ、現場感覚で言うとすごく分かります。最初に「共有設定を触るときは一言」のルールさえあれば、混乱はだいぶ防げますからね。

まとめ：Antigravity で MCP を使いこなすために

まずは小さなサーバーから試す

テキトー教師.AI認定講師

ここまでの話を整理すると、最初は規模が小さいMCPサーバーから入るのが失敗しないコツですね。設定ファイルの書き方に慣れる意味でも、1つだけ動かすところから始めるのがおすすめです。

室谷代表取締役

そうですね。開発現場でも、いきなり何個も並列で入れようとして動かなくなるケースをよく見ます。

まずは最小構成で動くことを確認して、そこから足していくのが結局いちばん早いんですよ。

テキトー教師.AI認定講師

最初に戸惑うのが「どこに何を書けばいいのか」というところなんですが、公式の入門用チュートリアルを一通りなぞれば、設定ファイルの基本的な書き方はつかめると思います。

室谷代表取締役

経営目線で言うと、導入初期の試行錯誤にかける時間もROIで考えたいところです。小さく始めて効果を測れば、続けるかどうかの判断もしやすい。

公式ドキュメントとコミュニティの使い分け

テキトー教師.AI認定講師

詰まったときに頼りになるのは、公式ドキュメントと実際に触っている人たちの情報ですね。公式は正確だけど記述が淡白なこともあって、現場の工夫みたいな話は実践者の投稿の方が参考になる場面もあります。

室谷代表取締役

海外だとこの辺の使い分けが自然にできてるんですよね。まず公式で仕様を確認して、その上で実践例を探す。

逆順だと間違った情報を覚えやすい。

テキトー教師.AI認定講師

たしかに。特にバージョンアップで挙動が変わったときは、古い情報のまま設定を触るとハマりがちです。

最終的には公式の情報を基準にするのが安全だと思います。

室谷代表取締役

そのうえで、自分で試した結果をメモに残しておくといいですよ。あとで「なんでこれで動いてたんだっけ」とならないように。

次の一歩につながるチェックリスト

テキトー教師.AI認定講師

最後に、これから始める人向けのチェックリストをまとめてみました。

• 対応OSを確認してAntigravityをインストールする
• 公式の入門コンテンツで基本操作をひと通り触る
• 必要最小限のMCPサーバーを1つ追加して動作確認する
• 設定ファイルのバックアップを取ってから変更する
• 動かないときは公式ドキュメントで最新情報を確認する

室谷代表取締役

いいリストですね。僕が追加するなら「1週間単位で効果を振り返る」を入れておきたい。

ツールを入れること自体が目的になってないかは、定期的に見直した方がいいです。

テキトー教師.AI認定講師

そうして振り返りまでできれば、Antigravity でのMCP活用は次のステップに進めますね。まずは1つ動かすところから始めてみてください。

よくある質問

Q1. Antigravity で MCP を使うのと、直接プロンプトで指示するのはどっちがいい？

室谷代表取締役

プロンプトだけだと外部ツールを操作させるたびに、いちから説明する羽目になりますよ。MCP はその接続口を固定してくれるから、指示のコストが下がる。

これマジで体感値なんですけど、繰り返し作業ほど差が出ますね。

テキトー教師.AI認定講師

初めて触る人は「直接言えばいいんじゃない？」って思うんですよね。ただ、Blender みたいに奥が深いツールだと、操作手順を言語化するだけで一苦労。

MCP 経由だとツール側の機能を直接呼べるんで、会話の往復が減る感覚があります。

Q2. MCP サーバーを追加するとき、セキュリティで気をつけることは？

テキトー教師.AI認定講師

MCP サーバーって要するに外部のプログラムを呼び出すための窓口ですから、信用できないものは怖いですよね。公式なり有名どころのものじゃないと、何が走るか分かったもんじゃない。

室谷代表取締役

ああ、そこは大事ですよね。権限周りをきっちり設定できるかどうか、結局そこにかかってます。

信頼できるところから取ってくるのは当然として、自分で中身を確認できるかも効きますよ。

Q3. チームで MCP 設定を共有するときのコツは？

室谷代表取締役

チーム開発だと設定ファイルをリポジトリに入れるかどうか、みたいな話がありますよね。環境差分を考えると、テンプレートだけ共有して、各自のローカルで調整するのが安全だと思うんですけど。

テキトー教師.AI認定講師

そうですね。個々のプロジェクトディレクトリに置くタイプと、ユーザー単位で持つタイプとで動きが違ったりするんで、最初に「今どっちに書いてるのか」を意識しておくとハマりにくいです。

現場でよく聞くのは、設定を共有したら「俺の環境では動かない」ってなるパターンですね。

Q4. 別のエディタから乗り換えても、MCP 設定はそのまま使える？

テキトー教師.AI認定講師

MCP 自体は標準化された仕組みなんで、概念はそのまま持ち込めることが多いです。ただ、設定ファイルの書き方や置き場所がエディタによって微妙に違うこともあるので、まるっとコピペじゃいかない場合もありますね。

室谷代表取締役

そうそう、フォーマットは似てるけど若干違う、みたいなのはある。Antigravity を導入するタイミングで、既存の設定を見直すくらいの気持ちでいいんじゃないですかね。

移行のついでに整理する、みたいな。

Q5. MCP サーバーが増えて管理が大変にならない？コツは？

室谷代表取締役

使わないものを常駐させてると、動きが重くなったりセキュリティリスクが増えたりしますから、プロジェクトに必要な最小限に絞るのが基本ですね。

テキトー教師.AI認定講師

まさにそこ。最初に触ってみるときはいくつか追加して試すんですけど、本番運用では「今のプロジェクトに本当にこれが必要か」を都度確認するのが近道です。

自分の中のルールを作っておくといいですよ。

まとめ

室谷代表取締役

結局、Antigravity での MCP 導入って、最初のセットアップさえ乗り越えれば、日々の作業効率が段違いになるんですよね。時給で換算すると、すぐに元が取れる計算ですし。

テキトー教師.AI認定講師

そう思います。mcp_config.json の書き方や動かないときの対処も、慣れてしまえば難しくない。

大事なのは「最初から完璧を目指さない」ことです。1個だけサーバーを入れて試して、そこから増やしていくのが近道ですね。

室谷代表取締役

あとは、費用対効果のところでも話しましたけど、まずは無料の範囲で試せるものから触ってみるのが一番です。使ってみて初めて見えてくる課題もありますから。

テキトー教師.AI認定講師

ですね。最初の壁を越えたあとのイメージがつかめれば、あとは自分好みにカスタマイズしていくだけです。

ぜひ今日から一歩踏み出してみてください。