| name | unity-mcp-setup |
| description | Unity MCPのセットアップと接続を行う。Unity EditorとClaude Codeの間でMCP接続を確立するための手順を実行する。「Unity MCP セットアップ」「MCP接続」「Unity MCP設定」「UnityMCP」「MCP For Unity」「MCPが繋がらない」「Unity Editorと接続」といったリクエスト時に使用。新規セットアップとトラブルシューティングの両方に対応。 |
Unity MCP セットアップ
Unity MCPは2つのコンポーネントで構成される：
- Unity Editor側:
com.coplaydev.unity-mcp (MCP サーバー)
- Claude Code側:
mcpforunityserver (MCPクライアント)
セットアップ手順
1. Unityパッケージのインストール
Packages/manifest.json の dependencies に追加：
"com.coplaydev.unity-mcp": "https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity"
2. Unity Editorでの設定
- Unity Editor下部の「MCP For Unity」タブ → Connectタブを開く
- ClientドロップダウンをClaude Codeに変更
- Claude CLI Path を確認:
C:\Users\<user>\AppData\Roaming\npm\claude.cmd
- Client Project Dir をUnityプロジェクトルートに設定
- Configure ボタンを押す（Configured 緑丸になればOK）
- Start Session ボタンを押す（Session Active 緑丸になればOK）
3. Claude Code再起動
VSCodeで Ctrl+Shift+P → Developer: Reload Window
4. 接続確認
manage_scene(action="get_hierarchy")
重要な注意事項
- Claude Code側のMCPクライアントは手動で
claude mcp add しない。Unity Editorの Configure ボタンに任せる
coplay-mcp-server と mcpforunityserver は別パッケージ。正しいのは mcpforunityserver- 複数のMCPサーバーを登録しない。不要なものは
claude mcp remove で削除
トラブルシューティング
詳細な手順は references/unity-mcp-setup-guide.md の「トラブルシューティング」セクションを参照。
よくある問題
| 症状 | 対処 |
|---|
UnityMCPが claude mcp list に表示されない | Unity EditorのConfigureを再実行、またはClaude Code側で手動再登録 |
| Failed to connect | Unity EditorでSession Activeか確認。削除→再Configure |
| 間違ったパッケージ(coplay-mcp等)が登録済み | claude mcp remove で削除後、ConfigureでFix |
手動再登録コマンド（Configureが効かない場合）
claude mcp add --scope local --transport stdio UnityMCP \
-- "C:\Users\<user>\.local\bin\uvx.exe" \
--offline --prerelease explicit \
--from "mcpforunityserver>=0.0.0a0" mcp-for-unity
完全リセット
claude mcp remove --scope local UnityMCP
claude mcp remove --scope user UnityMCP
claude mcp remove --scope project UnityMCP
その後、ステップ2からやり直す。
