UnityMCPとは｜AIでUnityエディタを操作するMCPサーバーと導入手順【2026年版】

UnityMCP（Unity MCP）は、Claude CodeやCursorといったAIコーディングエージェントを、実行中のUnityエディタに接続するためのMCP（Model Context Protocol）サーバーです。エージェントがシーンの検査、GameObjectの生成、C#スクリプトの編集、コンソールのエラー読み取りと修正までを自然言語の指示で行えるようにする、いわば「AIとUnityエディタをつなぐ橋渡し役」です。ここで押さえるべき最重要ポイントは、UnityMCPはゲーム実行時にNPCを喋らせるランタイムAIではなく、開発作業（エディタ操作）を自動化する開発者向けツールだという点です。本記事では正しい定義・仕組みから、Unity公式版とオープンソース各版の違い、Claude Code・Cursorとの実際の接続手順までを整理します。

まとめ：UnityMCPの要点

• 正体：AIエージェント（Claude Code / Cursor / Windsurf / VS Code Copilot 等）をUnityエディタに接続するMCPサーバー。開発時のエディタ操作自動化が目的で、ゲーム内ランタイムAIではない。
• できること：シーン・GameObject生成、C#スクリプト編集、アセット管理、コンソールのエラー読み取りと自動修正、テスト実行、ビルド設定操作。
• 2系統：公式（com.unity.ai.assistant／Unity 6以降／サブスク要・ただしMCP操作はAIクレジット非消費）と、オープンソース（筆頭はCoplayDev/unity-mcp＝旧justinpbarnett版、約12,600スター）。
• 構成：C#エディタブリッジ ＋ MCPサーバープロセス（Python/TypeScript）＋ MCPクライアント（AIエージェント）の3層。トランスポートはstdio／HTTP（一部OSSはTCP/IP）。
• 始め方：Unity側にパッケージを導入し、AIクライアントのmcpServers設定にサーバーを登録するだけ。ChatGPTやGeminiでもMCP対応クライアント経由で利用できる。

UnityMCPとは何か｜AIエージェントでUnityエディタを操作する仕組み

UnityMCPの正体と、ゲーム内AIとの違い

MCP（Model Context Protocol）は、AIエージェントが外部ツールと安全にやり取りするための共通規格です。UnityMCPはこの規格をUnity向けに実装したもので、MCP互換のAIエージェントがUnityエディタに接続し、呼び出し可能なツール群としてエディタを操作できるようにします。Unity公式は「エージェントはシーンの検査、コンソール出力の読み取り、スクリプトの編集、エディターアクションの実行ができる」と説明しています。CoplayDev版も「AIアシスタントとUnityエディタの橋渡し役として、アセット管理・シーン制御・スクリプト編集・タスク自動化のツールをLLMに与える」と定義しています。

混同されやすいのが「ゲーム内でNPCを喋らせるAI」との違いです。UnityMCPが動くのは開発時のエディタであって、ビルドしたゲームの実行時ではありません。プレイヤーの発話をゲーム内アクションへ変換するランタイム推論エンジンではなく、開発者の代わりにUnityエディタを操作してゲームを「作る」ためのツールだと捉えると誤解がありません。

UnityMCPが自動化するエディタ操作

実際に自動化できる主な作業は次のとおりです。とくにコンソールのエラーを読み取り、原因のスクリプトを同一セッション内で修正する「エラー→修正」のループは、Unityとコードエディタの往復コピペをなくす代表的なユースケースです。

• シーン・GameObjectの生成と階層操作、コンポーネント値の変更
• C#スクリプトの読み取り・編集・新規作成
• プロジェクト内アセットの検索・管理
• コンソールの警告／エラーの読み取りと、原因スクリプトの自動修正
• テスト実行、ビルド設定の変更、エディターアクションの実行

UnityMCPのアーキテクチャ（3層構成）

実装は異なっても、Unity MCPの基本構成は3層に整理できます。中央のサーバープロセスがルーティングとセッション管理を担い、Unity側のブリッジと通信します。

MCPの3つのプリミティブのうち、Unity MCPが主に露出するのはtools（ManageScene・ManageGameObject・ReadConsoleのようなエディタ操作関数）です。シーン階層やコンソール内容を読み取るresourcesも提供されます。クライアントとサーバー間のトランスポートはstdioとHTTPが一般的で、CoderGamester版などはEditorとの通信にTCP/IPを使います。MCP自体の全体像はMCPとは何かで解説しています。

公式UnityのMCP Server（AI Assistant同梱）

Unityは公式のMCP Serverを提供しており、AI Assistantパッケージcom.unity.ai.assistantに含まれます。オープンソース版と違い、Unityが動作を保証する点が利点です。

対応バージョンと料金（Unity 6以降・サブスク要）

公式MCP ServerはUnity 6（6000.0）以降で利用できます。料金面の要点は次のとおりです。パッケージは2026年7月時点でプレリリース（2.x-pre系）です。

• Unity Personalは有効なUnity AIサブスクリプションが必要（無料トライアルは14日間・1,000クレジット、以後は月額$10で1,000クレジット/月）。
• Unity Pro / Enterprise / IndustryはUnity MCP Serverアクセスを含む。
• MCP経由のエディタ操作はUnity AIクレジットを消費しない（クレジットを使うのはAssistantのLLM生成側）。

公式版の有効化手順

Unity 6でパッケージ導入後、次の手順で有効化します。対応クライアントはウィザードから自動構成できます。

• Edit → Project Settings → AI → Unity MCP Server を開く。
• Unity BridgeがRunning（緑）であることを確認する（停止時はStart）。
• Integrationsで接続したいクライアント（Claude Code / Cursor / Windsurf / Claude Desktop）を選びConfigureを実行する。
• エージェントが初回接続するとUnityがPending Connectionを表示するのでAcceptする。

オープンソースのUnity MCPサーバー比較と選び方

公式版以外にも、AIエージェント連携の実装は複数あります。スター数・ライセンス・対応クライアントで性格が分かれるため、代表的な3つを比較します（スター数はGitHub API実測・2026年7月時点）。

迷ったら、スター数が最も多く実績のあるCoplayDev/unity-mcpから始めるのが無難です。原作はjustinpbarnett氏で、現在はCoplay社（後にAuraへリブランド）へ引き継がれ継続開発されています。MIT・Python構成で、Claude Code/Desktop・Cursor・VS Code・Windsurf・Cline・Gemini CLIなど幅広いクライアントに対応します。完全ローカルで完結させたい場合はクラウドログインが必須のIvanMurzak版は避けるのが判断基準になります。Unityの動作保証や既存のUnity AI契約がある組織なら、公式版が第一候補です。

導入手順｜Claude Code・Cursorと接続する（CoplayDev版）

Unity側パッケージの導入

Unity Package Manager（UPM）のGit URL、またはOpenUPMで導入します。前提としてPython 3.10以上とuvが必要です（自動構成ウィザードが未導入なら案内されます）。UPMの「Add package from git URL」に次を入力します。

https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main

OpenUPMを使う場合は次のコマンドです。

openupm add com.coplaydev.unity-mcp

MCPクライアントの設定（Claude Code / Cursor / ChatGPT・Gemini）

Unity側で「Window → MCP for Unity → Configure All Detected Clients」を実行すると、検出したクライアントの設定を自動で書き込めます。手動設定する場合、Cursor・Windsurf・VS Code（HTTP接続）のmcpServersには次を追加します。

{ "mcpServers": { "unityMCP": { "url": "http://localhost:8080/mcp" } } }

Claude Desktop（stdio接続）の場合は次のようにuvxでサーバーを起動します。

{ "mcpServers": { "unityMCP": { "command": "uvx", "args": ["--from", "mcpforunityserver", "mcp-for-unity", "--transport", "stdio"] } } }

MCPはクライアント非依存の規格なので、「ChatGPTで使いたい」「Geminiで使いたい」という場合も、MCPに対応したクライアントを介して接続するのが基本です。GeminiはGemini CLIがMCPに対応し、ChatGPT系はCodex CLIやデスクトップアプリのコネクタ経由でMCPサーバーを追加できます。Cursorを使う場合の全体像はCursor Proとはを参照してください。

導入前に押さえるリスクと権限管理

AIエージェントにエディタ操作の権限を渡すツールである以上、便利さと引き換えのリスクがあります。次の点を前提に運用してください。

• 破壊的操作の可能性：エージェントはスクリプト書き換えやアセット削除も実行できる。必ずGitなどのバージョン管理下で使い、重要な操作は実行前に内容を確認する。
• 接続の明示承認：公式版は初回接続でAcceptを求め、審査済みクライアントに限定するガードがある。素性の不明なクライアントを無制限に許可しない。
• 料金とログイン：公式版はUnity AIサブスクが前提。OSS版もLLM側のAPI費用は別途かかる。IvanMurzak版はクラウドログインが必須で、完全ローカル完結ではない。

MCPサーバー全般のセキュリティ論点は、Playwright MCPのセキュリティでCVE事例とあわせて整理しています。

よくある質問

UnityMCPの公式版はありますか？

あります。UnityのAI Assistantパッケージcom.unity.ai.assistantに公式のMCP Serverが同梱されており、Unity 6（6000.0）以降で利用できます。オープンソース版とは別物で、Unityが動作を保証します。

UnityMCPは無料で使えますか？

オープンソース版（CoplayDev/unity-mcp等）はMITやApache-2.0で無料ですが、接続するAIエージェント側のAPI費用は別途かかります。公式版はUnity Personalの場合Unity AIサブスクリプション（無料トライアル後は月額$10で1,000クレジット）が必要です。ただしMCP経由のエディタ操作自体はAIクレジットを消費しません。

ChatGPTやGeminiでもUnityMCPは使えますか？

使えます。MCPはクライアント非依存の規格のため、MCPに対応したクライアントを介せばモデルを問いません。GeminiはGemini CLI、ChatGPT系はCodex CLIやデスクトップのコネクタからMCPサーバーとして追加できます。Claude Code・Cursor・Windsurf・VS Code Copilotも対応しています。

UnityMCPでゲーム内のAIキャラクターを動かせますか？

用途が異なります。UnityMCPは開発時にエディタを操作するツールで、ビルドしたゲームの実行時にNPCを推論・会話させるランタイムAIではありません。ゲーム内AIを実装したい場合は、Unity SentisやML-Agentなど別の仕組みを使います。

com.unity.ai.assistantとUnityMCPの関係は？

com.unity.ai.assistantはUnityのAI Assistant機能を提供するパッケージで、その中に公式のMCP Serverが含まれます。つまりUnityの公式MCPは、このAI Assistantパッケージの一機能として提供されています。

関連記事

• MCP（Model Context Protocol）とは？AIと外部ツールをつなぐ標準規格の仕組みをわかりやすく解説
• Serena MCPとは？仕組み・導入手順・Claude Code連携を実務目線で解説
• GitHub Remote MCP Serverとは？ローカル版との違い・接続手順・OAuth/PAT認証を解説
• Cursor Proとは｜料金プラン・無料版との違い・できることを解説【2026年版】
• Playwright MCPのセキュリティ｜危険性とCVE-2025-9611対策