Skip to content
cccskills
FreePublished on GitHub

unity-mcp-setup

Unity MCPのセットアップと接続を行う。Unity EditorとClaude Codeの間でMCP接続を確立するための手順を実行する。

「Unity MCP セットアップ」「MCP接続」「Unity MCP設定」「UnityMCP」「MCP For Unity」「MCPが繋がらない」「Unity Editorと接続」といったリクエスト時に使用。新規セットアップとトラブルシューティングの両方に対応。

The English summary is being prepared. Showing the original description.

Works withUnity
See how to install

Files included (2)

  • SKILL.md2.9 KB
  • references/unity-mcp-setup-guide.md9.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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での設定

  1. Unity Editor下部の「MCP For Unity」タブ → Connectタブを開く
  2. ClientドロップダウンをClaude Codeに変更
  3. Claude CLI Path を確認: C:\Users\<user>\AppData\Roaming\npm\claude.cmd
  4. Client Project Dir をUnityプロジェクトルートに設定
  5. Configure ボタンを押す(Configured 緑丸になればOK)
  6. 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 connectUnity 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からやり直す。

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Unity カジュアルゲームを仕様駆動開発(Specification-Driven Development)で作成する。仕様を先に確定させ、設計・実装・テストを行うことで手戻りを最小化する。「ゲームを作って」「仕様駆動開発」「SDD」「ゲーム企画書」「機能仕様書」「技術仕様書」「テスト仕様書」「タスクリスト」「Unityゲーム開発」「カジュアルゲーム」といったリクエスト時に使用。Phase 1(企画書)からPhase 8(リリース)まで段階的にドキュメントを作成し、仕様に基づいて実装・テスト・検証を行う。

The English summary is being prepared. Showing the original description.

umezy/hcg-workflows6Updated Mar 18, 2026

ゲーム画面全てのスクリーンショットを撮影し、スクショとコードベースを分析して改善提案を行う。「レビュー」「改善提案」「ゲームレビュー」「スクショして改善」「画面チェック」「ビジュアルレビュー」「UI改善」「UX改善」「フィードバック」といったリクエスト時に使用。

The English summary is being prepared. Showing the original description.

umezy/hcg-workflows6Updated Mar 18, 2026

WebGL ビルド成果物を StatiCrypt で暗号化し、GitHub Pages にデプロイする。「デプロイ」「GitHub Pages」「公開して」「アップロード」といったリクエスト時に使用。パスワードは Build/ 内で管理し、リポジトリ作成からプッシュまでを自動化する。

The English summary is being prepared. Showing the original description.

umezy/hcg-workflows6Updated Mar 18, 2026

Unity プロジェクト向けにプロシージャル音声(SE・BGM)を C# Editor スクリプトで生成する。「音声を生成」「SEを作って」「BGMを作って」「サウンドアセット」「AudioGenerator」「効果音」「プロシージャルオーディオ」といったリクエスト時に使用。WAV ファイル(44100Hz/16bit/Mono)を Assets フォルダに直接出力し、外部ツール不要で完結する。

The English summary is being prepared. Showing the original description.

umezy/hcg-workflows6Updated Mar 18, 2026

Unity MCP を使った実装検証スキル。コンパイルエラー確認(L1)、Play Mode 動作確認(L2)、スクリーンショット目視確認(L3)の3段階で検証する。「検証して」「動作確認」「Play Mode で確認」「スクリーンショットで確認」「エラーチェック」といったリクエスト時、または他スキル(dev-game 等)から参照されて使用。

The English summary is being prepared. Showing the original description.

umezy/hcg-workflows6Updated Mar 18, 2026

Unity ゲームに DebugManager + McpRemoteControl を実装し、エージェント(Claude Code / MCP)が Play Mode 中のゲーム状態を自動制御できるようにする。God モード、画面遷移、スコア操作を MCP から直接実行し、受け入れテストを人手なしで自動化する。「デバッグ」「DebugManager」「God モード」「MCP リモート制御」「自動テスト」「受け入れテスト自動化」といったリクエスト時、または dev-game スキルの Phase 6(DebugManager 実装)・Phase 7(テスト検証)から参照されて使用。

The English summary is being prepared. Showing the original description.

umezy/hcg-workflows6Updated Mar 18, 2026

See all skills by umezy

Report a problem with this skill