Unityのエディター内蔵MCPは非推奨になった。いまはCLIで動かす

AI に Unity を触らせる方法を調べると、まず MCP サーバーの記事が出てきます。ところが Unity 自身のマニュアルには、こう書いてあります。

Unity MCP server is deprecated. Use the Unity command-line interface (CLI) instead. — AI Assistant 2.18 マニュアル

私はこれを読んで、このプロジェクトでは最初から MCP を使わないことにしました。

非推奨なのは「どの MCP」か

ここを取り違えると話が噛み合いません。移行ガイドが対象にしているのはエディター内 AI アシスタントパッケージの MCP サーバーに接続している場合だけです。

そもそも MCP を設定しないという選択

移行ガイドで一番効いたのはこの一文です。

The unity command and unity eval commands 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;'

罠：unity mcp configure claude は Claude Code ではない

それでも MCP を使う場合の話です。移行ガイドの例には claude と書かれています。Claude Code を使っている人がこれをそのまま打つと、別のアプリの設定ファイルに書かれます。

unity mcp configure claude

unity mcp configure claude-code --dry-run

手元の CLI で一覧を出すと、こうなっていました。

ほかに windsurf・cline・copilot-cli・kiro・kimi・trae・zed・continue など、全部で17個ありました。

unity mcp configure --list          # 名前と書き込み先を確認する
unity mcp configure claude-code --dry-run   # 何が書かれるか見る

料金：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 サーバーについて「無料・同時実行の上限なし」となっています。エディター内蔵のアシスタント（体験版から月額へ移行するもの）とは別物です。

移行の手順

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 のサブスクは要らない