본문으로 건너뛰기
cccskills
무료GitHub에 공개

unity-mcp-setup

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

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

연동 도구Unity
설치 방법 보기

포함된 파일(2)

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

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

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からやり直す。

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

dev-game

무료

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

umezy/hcg-workflows62026년 3월 18일 업데이트

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

umezy/hcg-workflows62026년 3월 18일 업데이트

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

umezy/hcg-workflows62026년 3월 18일 업데이트

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

umezy/hcg-workflows62026년 3월 18일 업데이트

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

umezy/hcg-workflows62026년 3월 18일 업데이트

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

umezy/hcg-workflows62026년 3월 18일 업데이트

umezy의 스킬 모두 보기

이 스킬의 문제 신고