# Unity MCP — AI Game Developer Wiki

Unity MCPはClaude Code、Cursor、CopilotなどのAIエージェントをUnity Editorに接続します。インストール、セットアップ、ツール、拡張機能、CLIはこちらから。

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

Unity MCP は AI Game Developer の Unity プラグインです。AI を Unity Editor の中に組み込みます。Claude Code、Cursor、GitHub Copilot、Codex、Gemini などのエージェントが、シーン、GameObject、コンポーネント、プレハブ、アセットを読み取って変更し、C# スクリプトを書き、C# スニペットを実行し、EditMode テストと PlayMode テストを実行し、Console を読み、自分で確認できるスクリーンショットを撮影できます。この wiki では、プラグインのインストール方法、AI クライアントの接続方法、日々の使い方を説明します。

## Unity MCP とは

Unity MCP は Unity パッケージ `com.ivanmurzak.unity.mcp` で、Package Manager では **AI Game Developer — MCP** として表示されます。Unity Editor 内で(必要ならビルドしたゲーム内でも)動作します。AI クライアントが外部ツールを呼び出すためのオープン標準である Model Context Protocol(MCP)を通じて、一連のツールを公開します。チャットしているエージェントはこれらのツールを認識し、依頼された作業を実行するために呼び出します。

このプラグインは Apache-2.0 ライセンスのオープンソースで、[Unity-MCP リポジトリ](https://github.com/IvanMurzak/Unity-MCP)にあります。MCP ライブラリとリフレクションライブラリを Unreal MCP と Godot MCP と共有しているため、3 つのエンジンプラグインは同じように動作し、同じ ai-game.dev アカウントを使用します。

バージョン 1.0.0 以降、Editor での作業のほとんどは **RQL** を通じて行われます。RQL は Editor のデータに対するクエリ言語で、読み取りは `rql-query` ツール 1 つ、変更は `rql-mutate` ツール 1 つ、利用可能な内容の説明は `rql-schema` が担います。スクリーンショット、スクリプト、テスト、パッケージには、少数の専用ツールが用意されています。[ツールと RQL](https://ai-game.dev/ja/docs/wiki/unity/tools-and-rql) を参照してください。

## 各構成要素の関係

| 構成要素 | 役割 |
| --- | --- |
| Unity MCP プラグイン | Unity Editor 内で動作し、AI ツールを公開して MCP サーバーに接続します。 |
| MCP サーバー | ai-game.dev のホスト型サーバー(Cloud モード、デフォルト)、またはプラグインがダウンロードして起動するローカルの `gamedev-mcp-server`(Custom モード)。 |
| AI クライアント | Claude Code、Claude Desktop、Cursor、VS Code Copilot、Codex、Gemini、Rider など。同じサーバーに接続します。 |
| `unity-mcp-cli` | プラグインのインストール、サインイン、AI クライアント設定の書き込み、Unity の起動、ターミナルからのツール呼び出しを行う npm コマンドラインツール。 |
| AI Game Dev アプリ | プラグインをインストールし、Editor を開いて AI エージェントを実行するデスクトップアプリ。 |

**Cloud** モードでは、Editor と AI クライアントの両方が `https://ai-game.dev/mcp` に接続し、ai-game.dev アカウントで一度サインインします。**Custom** モードでは、プラグインがお使いのマシン上でローカル MCP サーバーを実行するため、すべてがお使いのコンピューター内に留まります。[設定](https://ai-game.dev/ja/docs/wiki/unity/configuration)では両方のモードを説明しています。

## 要件の概要

- Unity **2022.3** 以降(Unity 6 を含む)。
- **スペースを含まない**プロジェクトパス(パスにスペースが含まれている場合、プラグインは起動時にエラーをログに出力します)。
- 初回使用時のインターネットアクセス:プラグインは NuGet から .NET 依存関係をダウンロードし、Custom モードでは MCP サーバーのバイナリもダウンロードします。
- MCP に対応した AI クライアント、または [AI Game Dev アプリ](https://ai-game.dev/docs/app)。

## クイックスタート

最も簡単な方法はデスクトップアプリです:[ダウンロード](https://ai-game.dev/ja/download)してサインインし、Unity プロジェクトを開きます。プラグインのインストールと接続は自動で行われます。この流れについては[アプリの wiki](https://ai-game.dev/ja/docs/wiki/app)で説明しています。

ターミナルとお好みの AI クライアントを使いたい場合、次のコマンドで Unity プロジェクトをエージェントに接続できます:

```bash
npm install -g unity-mcp-cli
unity-mcp-cli install-plugin ./MyUnityProject
unity-mcp-cli login
unity-mcp-cli setup-mcp claude-code ./MyUnityProject
unity-mcp-cli open ./MyUnityProject
```

その後、エージェントに「半径 2 の円状に 3 つのキューブを作成して」のように依頼します。[はじめに](https://ai-game.dev/ja/docs/wiki/unity/getting-started)では、同じ手順を説明付きで解説しています。

## このセクションのページ

- [インストール](https://ai-game.dev/ja/docs/wiki/unity/installation):プラグインをインストールするすべての方法(アプリ、`unity-mcp-cli`、OpenUPM、`.unitypackage` インストーラー)とアンインストール方法。
- [はじめに](https://ai-game.dev/ja/docs/wiki/unity/getting-started):最初の接続と最初のプロンプト。
- [AI クライアントの接続](https://ai-game.dev/ja/docs/wiki/unity/connecting-ai-clients):Cloud とローカルのエンドポイント、サインイン、固定 URL、各エージェント用のコンフィギュレーター。
- [設定](https://ai-game.dev/ja/docs/wiki/unity/configuration):AI Game Developer ウィンドウ、接続モード、ポート、設定ファイル、環境変数によるオーバーライド、ビルド。
- [ツールと RQL](https://ai-game.dev/ja/docs/wiki/unity/tools-and-rql):エージェントが Editor でできること。
- [カスタムツール](https://ai-game.dev/ja/docs/wiki/unity/custom-tools):独自の C# メソッドを AI ツール、プロンプト、スキルに変換します。実行中のゲーム内でも可能です。
- [拡張機能](https://ai-game.dev/ja/docs/wiki/unity/extensions):Animation、Cinemachine、Input System、Navigation、ProBuilder、Terrain、Tilemap、Timeline などのオプションパッケージ。
- [unity-mcp-cli リファレンス](https://ai-game.dev/ja/docs/wiki/unity/cli):すべてのコマンドとフラグ。
- [トラブルシューティング](https://ai-game.dev/ja/docs/wiki/unity/troubleshooting):よくある問題の解決策。
- [FAQ](https://ai-game.dev/ja/docs/wiki/unity/faq):よくある質問への簡潔な回答。

## サイトのその他の情報

- [Unity ツールカタログ](https://ai-game.dev/docs/tools/unity)と [RQL リファレンス](https://ai-game.dev/docs/rql)。
- [Unity 拡張機能カタログ](https://ai-game.dev/docs/extensions/unity)。
- プロンプトとプロジェクト設定のための [Unity ベストプラクティス](https://ai-game.dev/docs/best-practices/unity)。
- サポートされているすべてのクライアント向けの設定スニペットを掲載した [MCP エンドポイント](https://ai-game.dev/ja/mcp-endpoint-info)。
- [認証](https://ai-game.dev/docs/auth)、[クイックスタート](https://ai-game.dev/ja/docs/quickstart)、[Unity エンジンページ](https://ai-game.dev/ja/engines/unity)。
- その他のエンジン:[Unreal MCP](https://ai-game.dev/ja/docs/wiki/unreal) と [Godot MCP](https://ai-game.dev/ja/docs/wiki/godot)。

- [**インストール** デスクトップアプリ、unity-mcp-cli、OpenUPM、.unitypackage インストーラーを使って Unity プロジェクトに Unity MCP（AI Game Developer）をインストールする方法。](https://ai-game.dev/ja/docs/wiki/unity/installation)
- [**はじめに** Unity MCPで最初のAIエージェントをUnity Editorに接続し、接続を確認して、Claude Code、Cursor、Copilotで最初のプロンプトを試しましょう。](https://ai-game.dev/ja/docs/wiki/unity/getting-started)
- [**AIクライアントの接続** Claude Code、Cursor、Copilot、Codex、GeminiなどのMCPクライアントを、ai-game.devのクラウドエンドポイントまたはローカルサーバー経由でUnity MCPに接続します。](https://ai-game.dev/ja/docs/wiki/unity/connecting-ai-clients)
- [**設定** AI Game Developer ウィンドウで Unity MCP を設定する方法 — Cloud モードと Custom モード、ローカルサーバー、ポート、トランスポート、認可、ツール、オーバーライド、CI について説明します。](https://ai-game.dev/ja/docs/wiki/unity/configuration)
- [**ツールとRQL** Unity MCPでAIエージェントがUnity Editor内でできること - RQLクエリとミューテーション、スクリーンショット、C#スクリプト、テスト、パッケージ、プロファイリング。](https://ai-game.dev/ja/docs/wiki/unity/tools-and-rql)
- [**カスタムツール** AiTool 属性を使って独自の Unity MCP ツール、プロンプト、リソース、スキルを C# で書き、メインスレッドで実行してビルド済みゲームでも使えるようにします。](https://ai-game.dev/ja/docs/wiki/unity/custom-tools)
- [**拡張機能** Unity MCPの拡張機能は、Animation、Cinemachine、Input System、Navigation、ProBuilder、Splines、Terrain、Tilemap、Timeline、パーティクルに対するAIサポートを追加します。](https://ai-game.dev/ja/docs/wiki/unity/extensions)
- [**unity-mcp-cli リファレンス** unity-mcp-cli のコマンドリファレンス。Unity MCP のインストール、サインイン、AI エージェント設定の書き込み、Unity のヘッドレス起動、ターミナルからのツールや C# の実行を行えます。](https://ai-game.dev/ja/docs/wiki/unity/cli)
- [**トラブルシューティング** Unity MCP のよくある問題を解決しましょう。AI クライアントにツールが表示されない、サインインや接続エラー、サーバーのダウンロード失敗、NuGet DLL エラー、ポート競合などを扱います。](https://ai-game.dev/ja/docs/wiki/unity/troubleshooting)
- [**FAQ** Unity MCP に関するよくある質問への回答 - 対応する Unity バージョンと AI クライアント、Cloud モードとローカルモード、コスト、プライバシー、ビルド、CI、RQL。](https://ai-game.dev/ja/docs/wiki/unity/faq)

---

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

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