# FAQ — Unity · AI Game Developer Wiki

Unity MCP に関するよくある質問への回答 - 対応する Unity バージョンと AI クライアント、Cloud モードとローカルモード、コスト、プライバシー、ビルド、CI、RQL。

このページは英語から機械翻訳されています。[英語の原文を読む](https://ai-game.dev/docs/wiki/unity/faq)。

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

## 一般

### Unity MCP とは何ですか？

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

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

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

### 対応している 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 クライアントの接続](https://ai-game.dev/ja/docs/wiki/unity/connecting-ai-clients)をご覧ください。

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

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

## セットアップ

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

デスクトップアプリです。それを使わない場合は、`unity-mcp-cli install-plugin` を実行するか、OpenUPM または `.unitypackage` インストーラーを使用します。詳しくは[インストール](https://ai-game.dev/ja/docs/wiki/unity/installation)をご覧ください。

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

**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 サーバーを実行し、すべてがお使いのマシン上に留まります。詳しくは[構成](https://ai-game.dev/ja/docs/wiki/unity/configuration#connection-modes)をご覧ください。

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

いいえ。ポートはプロジェクトパスから導出される（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](https://ai-game.dev/ja/docs/wiki/unity/tools-and-rql#old-names)をご覧ください。

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

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

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

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

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

はい。クラスに `[AiToolType]`、メソッドに `[AiTool]` を付けます。詳しくは[カスタムツール](https://ai-game.dev/ja/docs/wiki/unity/custom-tools)をご覧ください。

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

ウィンドウの **Extensions** セクションから該当する拡張機能をインストールするか、`unity-mcp-cli install-extension` を実行します。詳しくは[拡張機能](https://ai-game.dev/ja/docs/wiki/unity/extensions)をご覧ください。

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

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

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

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

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

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

Unity プロセスの環境変数に `UNITY_MCP_DISABLE=1` を設定するか、`UNITY_MCP_EXCLUDE_FROM_COMPILATION` 定義を使用してください。詳細は[設定](https://ai-game.dev/ja/docs/wiki/unity/configuration#ci)を参照してください。

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

はい。`unity-mcp-cli run-tool` はターミナルから任意のツールを呼び出し、`unity-mcp-cli exec` はエディター内で C# を実行します。詳細は[CLI リファレンス](https://ai-game.dev/ja/docs/wiki/unity/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` をコミットしてください。

## その他のヘルプ

- エラーについては[トラブルシューティング](https://ai-game.dev/ja/docs/wiki/unity/troubleshooting)をご覧ください。
- サイト全体の[FAQ](https://ai-game.dev/docs/faq)と [Unity ベストプラクティス](https://ai-game.dev/docs/best-practices/unity)もご覧ください。

---

Source (HTML): https://ai-game.dev/ja/docs/wiki/unity/faq

Machine-translated (ja) from the English page: https://ai-game.dev/docs/wiki/unity/faq