Claude Code と Unity を MCP でつなぐ方法【Windows 対応】

この記事では CoplayDev/unity-mcp を使って、Claude Code（VSCode 拡張）から Unity を直接操作できる環境を構築する手順を解説します。

できるようになること
仕組み
前提条件
セットアップ手順
動作確認
毎回の起動手順
利用できる主なツール
トラブルシューティング
参考リンク

できるようになること

接続が完了すると、Claude Code に自然言語で話しかけるだけで Unity を操作できます。

「GameScene の Hierarchy にある全 GameObject を一覧して」
「Player オブジェクトに Rigidbody コンポーネントを追加して」
「コンパイルエラーを確認して修正して」
「Assets/Scripts に新しい C# スクリプトを作成して」

仕組み

Unity Editor に入れたパッケージが Python サーバーを起動し、Claude Code がそこに HTTP 接続する構成です。

前提条件

必要なもの	最低バージョン
Unity	2021.3 LTS 以上
Python	3.10 以上
uv（Python パッケージマネージャー）	0.6 以上
Claude Code（VSCode 拡張）	最新版

セットアップ手順

Step 1 — uv をインストールする

PowerShell を開いて以下を実行します。

winget install --id=astral-sh.uv -e

インストール後は PowerShell を再起動して PATH を反映させてください。

Windows の注意点
winget でインストールした場合、実行ファイルのパスが通っていないことがあります。
新しいターミナルを開いて uv --version が表示されれば OK です。

Step 2 — Unity パッケージをインストールする

Unity Editor で対象プロジェクトを開く
メニュー: Window > Package Manager
左上の + → Add package from git URL...
以下の URL を貼り付けて Add をクリック

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

インポートとコンパイルが完了するまで待つ

Step 3 — Unity からサーバーを起動する

メニュー: Window > MCP for Unity
Start Server をクリック（localhost:8080 で HTTP サーバーが起動）
クライアントのドロップダウンで Claude Code を選択
Configure をクリック
ステータスが 🟢 Connected ✓ になれば成功

Step 4 — .mcp.json を設置する

プロジェクトのルートに .mcp.json を作成し、以下の内容を記述します。

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

Step 5 — Claude Code を再起動する

VSCode のコマンドパレット（Ctrl+Shift+P）から Developer: Reload Window を実行するか、Claude Code のセッションを再起動します。

初回は接続承認のダイアログが表示されることがあります。許可を選んでください。

動作確認

Claude Code に以下のように話しかけてみましょう。

Unity のシーン情報を取得して

Unity の情報が返ってくれば連携成功です。

利用可能な MCP ツールの一覧は、Claude Code 内で /mcp コマンドを実行すると確認できます。

毎回の起動手順

セットアップ完了後は、毎回以下の順番で起動します。

Unity Editor を起動してプロジェクトを開く
Window > MCP for Unity で Start Server をクリック
VSCode で Claude Code を起動

Unity が起動していない状態で Claude Code を立ち上げると接続エラーになります。
Unity 側でサーバーを起動してから Claude Code を再ロードすれば復旧します。

利用できる主なツール

カテゴリ	ツール例
シーン操作	`manage_scene`, `find_gameobjects`, `manage_gameobject`
アセット	`manage_asset`, `manage_prefabs`, `manage_material`, `manage_texture`
スクリプト	`create_script`, `manage_script`, `apply_text_edits`, `validate_script`
エディタ操作	`manage_editor`, `execute_menu_item`, `read_console`
ビルド・テスト	`manage_build`, `run_tests`
バッチ実行	`batch_execute`（複数操作を一括化・高速化）

完全な一覧は公式 README を参照してください。

トラブルシューティング

🔴 Disconnected のまま接続しない

Unity Editor のコンソールにエラーが出ていないか確認
ポート 8080 が別のアプリで使用されていないか確認

netstat -ano | findstr :8080

ポートが競合している場合は Window > MCP for Unity の Advanced Settings でポートを変更し、.mcp.json の URL も合わせて修正してください。

Claude Code 側で unityMCP が表示されない

VSCode をリロード（Developer: Reload Window）
.mcp.json の JSON 構文に誤りがないか確認

uv が見つからない・Python エラーが出る

winget install --id=astral-sh.uv -e

インストール後は VSCode ごと再起動して PATH を反映させてください。