FAQ

Unity 向け AI Game Developer プラグインである Unity MCP について、よく寄せられる質問に簡潔に答えます。各回答には詳細を説明したページへのリンクがあります。

一般#

Unity MCP とは何ですか？#

AI エージェントが Model Context Protocol を通じてプロジェクト内で作業できるようにする Unity Editor プラグインです。エージェントはシーン、GameObject、コンポーネント、プレハブ、アセットの読み取りと変更、C# の作成と実行、テストの実行、スクリーンショットの撮影ができます。詳しくは概要をご覧ください。

プラグインは無料でオープンソースですか？#

プラグインは Apache-2.0 ライセンスのオープンソースで、Unity-MCP リポジトリで公開されています。Custom モードはローカルサーバーを実行するため、アカウントは不要です。Cloud モードでは ai-game.dev アカウントを使用します。プランについては料金ページをご覧ください。

対応している Unity のバージョンはどれですか？#

Unity 2022.3 以降（Unity 6 を含む）。

どの AI クライアントで動作しますか？#

AI Game Developer ウィンドウには、Claude Code、Claude Desktop、Cursor、Visual Studio Code（Copilot）、Visual Studio（Copilot）、Rider（Junie）、GitHub Copilot CLI、Gemini、Antigravity、Cline、Open Code、Codex、Kilo Code、Zoo Code、Unity AI の設定ツールがあり、その他の MCP クライアント向けのカスタム入力も用意されています。詳しくはAI クライアントの接続をご覧ください。

自分の AI クライアントは必要ですか？#

いいえ。AI Game Dev デスクトップアプリにはエージェントが含まれており、プラグインをインストールして接続します。すでに Claude Code、Cursor、その他の MCP クライアントを使用している場合は、ご自身のクライアントをご利用ください。

セットアップ#

最も簡単なインストール方法は何ですか？#

デスクトップアプリです。それを使わない場合は、unity-mcp-cli install-plugin を実行するか、OpenUPM または .unitypackage インストーラーを使用します。詳しくはインストールをご覧ください。

プラグインのウィンドウはどこにありますか？#

Window > AI Game Developer — MCP、ショートカット Ctrl+Alt+A（macOS では Cmd+Option+A）、または Scene View ツールバーの AI ボタンです。

Cloud モードと Custom モードの違いは何ですか？#

デフォルトの Cloud モードでは、Editor と AI クライアントが https://ai-game.dev/mcp に接続し、一度サインインします。Custom モードでは、プラグインがプロジェクトパスから導出されたポートでローカル MCP サーバーを実行し、すべてがお使いのマシン上に留まります。詳しくは構成をご覧ください。

ポートを自分で選ぶ必要はありますか？#

いいえ。ポートはプロジェクトパスから導出される（20000～29999 の範囲）ため、プロジェクトごとに安定しており、プロジェクト間で異なります。Server URL で上書きできます。

設定はどこに保存されますか？#

プロジェクト内の UserSettings/AI-Game-Developer-Config.json に保存されます。ai-game.dev へのサインイン情報はマシンごとに ~/.ai-game-dev/credentials.json に保存されます。

複数の Unity プロジェクトを同時に使用できますか？#

はい。各プロジェクトには独自のポートがあり、固定 URL（https://ai-game.dev/mcp/p/<pin>）によって各エージェントが適切な Editor にルーティングされます。

使い方#

gameobject-create のようなツールはどこへ行ったのですか？#

バージョン 1.0.0 では、1 アクション 1 ツールの形式のツールが RQL に置き換えられました。rql-query、rql-mutate、rql-schema がシーン、GameObject、コンポーネント、アセット、Console、Editor の状態をカバーします。詳しくはツールと RQLをご覧ください。

AI は自分の変更を元に戻せますか？#

各 rql-mutate 呼び出しは 1 つの Undo ステップとして記録されるため、Ctrl+Z（Cmd+Z）で元に戻せます。それ以上の変更にはバージョン管理を使用してください。

エージェントに一部のツールしか表示されないのはなぜですか？#

コンテキストを節約するためです。デフォルトでは 7 つのツールが表示され、残りはインストールされているものの非表示で、名前で呼び出せば実行されます。ウィンドウの Tools > Open で表示数を増やせます。

独自のツールを追加できますか？#

はい。クラスに [AiToolType]、メソッドに [AiTool] を付けます。詳しくはカスタムツールをご覧ください。

Cinemachine、ProBuilder、Tilemaps のサポートを追加するにはどうすればよいですか？#

ウィンドウの Extensions セクションから該当する拡張機能をインストールするか、unity-mcp-cli install-extension を実行します。詳しくは拡張機能をご覧ください。

Play モードでも動作しますか？#

はい。エージェントは RQL（isPlaying などの editor メンバー）を通じて Play モードに出入りできます。ドメインリロード後、接続は再接続されます。

ビルド、CI、プライバシー#

プラグインはゲームのビルドに含まれてしまいますか？#

ランタイム部分はプレイヤービルドにコンパイルされますが、ビルドが勝手に接続することはありません。ゲーム内に AI ツールを組み込むには、コードから UnityMcpPluginRuntime.Initialize(...) を呼び出してオプトインします。プラグインを完全に除外するには、UNITY_MCP_EXCLUDE_FROM_COMPILATION スクリプト定義を追加します。詳しくは構成をご覧ください。

CI のテスト実行時に含めないようにするにはどうすればよいですか？#

Unity プロセスの環境変数に UNITY_MCP_DISABLE=1 を設定するか、UNITY_MCP_EXCLUDE_FROM_COMPILATION 定義を使用してください。詳細は設定を参照してください。

AI クライアントなしでスクリプトから操作できますか？#

はい。unity-mcp-cli run-tool はターミナルから任意のツールを呼び出し、unity-mcp-cli exec はエディター内で C# を実行します。詳細はCLI リファレンスを参照してください。

どのデータがマシン外に送信されますか？#

none または token 認証を使うカスタムモードでは、ai-game.dev を経由するものは何もありません。エージェントと Unity はローカルサーバーを介して通信します。ただし AI クライアントは、会話をその独自のモデルプロバイダーに送信します。クラウドモードでは、ツール呼び出しとその結果は、エージェントとエディターの間を移動する際に ai-game.dev サーバーを経由します。

チーム全体で更新ポップアップを無効にするにはどうすればよいですか？#

Edit > Project Settings > AI Game Developer で Disable update notifications for the entire team を有効にし、ProjectSettings/AI-Game-Developer-UpdateSettings.asset をコミットしてください。

その他のヘルプ#

• エラーについてはトラブルシューティングをご覧ください。
• サイト全体のFAQと Unity ベストプラクティスもご覧ください。