AI に Unity を触らせる方法を調べると、まず MCP サーバーの記事が出てきます。ところが Unity 自身のマニュアルには、こう書いてあります。
Unity MCP server is deprecated. Use the Unity command-line interface (CLI) instead. — AI Assistant 2.18 マニュアル
公式が挙げている、CLI に移る理由
私はこれを読んで、このプロジェクトでは最初から MCP を使わないことにしました。
非推奨なのは「どの MCP」か
ここを取り違えると話が噛み合いません。移行ガイドが対象にしているのはエディター内 AI アシスタントパッケージの MCP サーバーに接続している場合だけです。
「5通りの方法」は、この3つの組み合わせ方が違うだけ。
| 非推奨か | |
|---|---|
| エディター内 AI アシスタントパッケージの MCP サーバー | 非推奨（移行対象） |
Unity CLI の unity mcp / unity command | 対象外 |
| GitHub で公開されている第三者製の MCP サーバー | 対象外 |
そもそも MCP を設定しないという選択
移行ガイドで一番効いたのはこの一文です。
The
unity commandandunity evalcommands drive the Editor directly, without MCP in between. They're faster and use fewer tokens than MCP. Use these commands if your agent can run shell commands.
Claude Code も Codex もシェルを実行できる。なら MCP を挟む理由がない。
実際の操作はこうなります。
unity command console_status --project-path <プロジェクト>
unity command recompile --project-path <プロジェクト>
unity command run_tests --mode EditMode --project-path <プロジェクト>
unity command eval 'return UnityEditor.EditorApplication.isPlaying;'
MCP を挟む
unity command を直接叩く
つなぎ方は3通りある
① MCP を設定してツールとして見せる ② CLI をシェルから叩く ③ エディター内のアシスタントを使う。②が一番速くて、影響範囲も小さいというのが公式の立場です。
罠：unity mcp configure claude は Claude Code ではない
それでも MCP を使う場合の話です。移行ガイドの例には claude と書かれています。Claude Code を使っている人がこれをそのまま打つと、別のアプリの設定ファイルに書かれます。
移行ガイドの例をそのまま打つ
unity mcp configure claude→ Claude Desktop の設定に書かれる
Claude Code に入れたいなら
unity mcp configure claude-code --dry-run→ Claude Code（
claude mcp add に委任）手元の CLI で一覧を出すと、こうなっていました。
| 指定する名前 | 実際のクライアント | 書き込み先 |
|---|---|---|
claude | Claude Desktop | AppData\Roaming\Claude\claude_desktop_config.json |
claude-code | Claude Code CLI | ファイルなし（claude mcp add に委任） |
codex | OpenAI Codex CLI | .codex\config.toml |
cursor | Cursor | .cursor\mcp.json |
vscode | VS Code（GitHub Copilot） | プロジェクトの .vscode\mcp.json |
ほかに windsurf・cline・copilot-cli・kiro・kimi・trae・zed・continue など、全部で17個ありました。
unity mcp configure --list # 名前と書き込み先を確認する
unity mcp configure claude-code --dry-run # 何が書かれるか見る
⚠️ --dry-run を先に
書き込み先がユーザー全体か、プロジェクトの中かは、クライアントによって違います。--list のパスを見れば分かるので、書く前に確認してください。 ユーザー全体に書くと、全プロジェクトのセッションに影響します。
料金：CLI は無料
CLI は無料。Unity AI のサブスクリプションは要らない。
移行ガイドにはっきり書かれています。
The CLI is free and separate from Unity AI. Installing the CLI doesn't require a Unity AI subscription.
料金ページの FAQ でも、MCP サーバーについて「無料・同時実行の上限なし」となっています。エディター内蔵のアシスタント（体験版から月額へ移行するもの）とは別物です。
移行の手順
手順 01
CLI を入れる
winget install Unity.CLI
手順 02
Pipeline を入れる
unity pipeline install
手順 03
MCP は入れない
unity command から始める
Windows では winget install Unity.CLI が MSIX で入るので、PATH に自動で追加されます。インストールスクリプト版は PATH を手で足すか、ターミナルを開き直す必要があります。
エディター側は unity pipeline install --project-path <プロジェクト> でローカル HTTP API が有効になります。Unity 6.0 以降が対象です。
まとめ
- エディター内蔵の Unity MCP は非推奨。公式が CLI を案内している
- 非推奨なのはその MCP だけ。CLI の
unity mcpと第三者製は別 - シェルを実行できるエージェントなら、MCP を挟まず
unity commandが速い（公式の言い分でもあり、実際そうだった） unity mcp configure claudeは Claude Desktop。Claude Code はclaude-code- CLI は無料。Unity AI のサブスクは要らない