このページは英語から機械翻訳されています。英語の原文を読む。

Unity MCP

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

2026年11月4日に更新 Markdownで表示

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 リポジトリにあります。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 を参照してください。

各構成要素の関係

構成要素役割
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 サーバーを実行するため、すべてがお使いのコンピューター内に留まります。設定では両方のモードを説明しています。

要件の概要

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

クイックスタート

最も簡単な方法はデスクトップアプリです:ダウンロードしてサインインし、Unity プロジェクトを開きます。プラグインのインストールと接続は自動で行われます。この流れについてはアプリの wikiで説明しています。

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

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 つのキューブを作成して」のように依頼します。はじめにでは、同じ手順を説明付きで解説しています。

このセクションのページ

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

サイトのその他の情報