← ブログへ

Claude Code で Unity MCP に接続する:インストールと設定

Unity MCP を導入し Claude CLI で接続:Package Manager インポート、有効化、ローカル MCP Server(ポート 6589)起動、CLI コマンドのコピーと実行、Hierarchy の確認。次の 5 ステップで Unity MCP をローカルの Unity プロジェクトに接続し、…

公開日
  • unity
  • mcp
  • claude-code
  • tutorial
  • unity-mcp
  • ai

このガイドでできること

次の 5 ステップで Unity MCP をローカルの Unity プロジェクトに接続し、Claude CLI からエディタを操作・プレビュー・デバッグできるようにします。

完了後にできること:

  • Package Manager の ディスクからパッケージを追加 で Unity MCP をインポートする
  • プラグインを有効化する(アカウントまたはアクティベーションコード — Mcp Panel に従う)
  • ローカルの Unity MCP Server(既定ポート 6589)を起動する
  • クイック設定 から CLI コマンド をコピーし、Claude CLI で実行して MCP 接続を確認する

ダウンロードページ:Unity MCP

本稿は Claude CLI を例にします。Gemini CLI はクイック設定で同名クライアントを選び、同様に CLI コマンドをコピーして実行します。

前提条件

項目内容
Unity2022.3+ / Unity 6 推奨(利用中ビルドのサポート表記に従う)
プラグインダウンロード済み・解凍済みの Unity MCP アーカイブ
有効化プラグインアカウント+パスワード、またはメール+アクティベーションコード(Mcp Panel 準拠)
AI IDEClaude CLI(Gemini CLI も同手順)
ローカル通信橋渡しは通常 127.0.0.1。ポートを公開しないこと

ステップ 1:Unity MCP をダウンロード

利用する Unity MCP の公式サイトまたは配布ページからプラグインを入手します。

ダウンロード例: [https://www.vberai.com/ja/game-engines/unity?ch=CQZLC2FG)

推奨手順:

  1. ダウンロードページを開き、Unity MCP アーカイブを取得する
  2. ローカルに保存し、固定フォルダへ解凍する(次ステップで package.json を選ぶ)
  3. 解凍先に package.json があることを確認してから Unity を開く

版やライセンスの差異は各ベンダーの公式説明に従ってください。

ステップ 2:プラグインをインポートする

  1. 対象の Unity プロジェクトを開く
  2. メニュー Window → Package Manager
  3. Package Manager 左上の 「+」 をクリック
  4. Add package from disk(ディスクからパッケージを追加)を選択
  5. ステップ 1 で解凍したフォルダ内の package.json を選んで確定

インポート成功後、Package Manager 一覧に Unity MCP が表示されます。

Package Manager で package.json を選択

ステップ 3:unity-mcp を有効化

  1. メニュー Window → Unity MCP → Mcp Panel
  2. 有効化画面で次のいずれか:
    • アカウント+パスワード でログイン
    • または メール+アクティベーションコード
  3. 有効化成功後、MCP Server 設定ページへ(次ステップ)

未有效化では通常サービスを起動できません。アカウントまたはコードがインストールしたプラグイン版と一致しているか確認してください。

Unity MCP Panel で有効化

ステップ 4:unity-mcp-server を起動

  1. 有効化後、Unity MCP Server 設定ページを開く
  2. 必要に応じて調整:
    • ポート:既定 6589
    • 言語:UI に合わせる
    • 起動状態:パネルのオプション(例:エディタ起動時自動起動)
  3. サービスを起動 をクリック
  4. パネルに Running(実行中)と表示されれば成功

ローカル MCP 橋渡しの準備完了 — 次は Claude CLI の設定です。

Unity MCP Server を Running まで起動

ステップ 5:Claude CLI を設定

  1. ツール管理 を開く
    • Unity MCP Server が公開するツール一覧を確認
    • AI に使わせる機能にチェック
  2. クイック設定 を開く
    • クライアント:Claude CLI(Gemini CLI も同名項目を選択、手順同じ)
    • Claude CLI / Gemini CLI は「自動設定」非対応 — パネルの CLI コマンド を コピー

クイック設定:Claude CLI を選び CLI コマンドをコピー

  1. システムターミナルを開き、コピーしたコマンドを貼り付けて実行(Claude CLI が入った環境で)
  2. Claude CLI に戻り、MCP 一覧に unity-mcp(またはパネル登録名)が表示されることを確認

Claude CLI で unity-mcp 設定成功

接続後のクイック確認

Claude CLI で read-only 確認から始めます。例:

現在 Unity で開いているシーンの Hierarchy ルートオブジェクトを列挙してください。

返答がエディタの Hierarchy と一致すれば橋渡しは正常です。続けて小さな write(一時 Empty GameObject を作成して削除)で権限とツール選択を確認してください。

よくある質問

Add package from disk で package.json が見つからない?
ステップ 1 で完全に解凍し、ルートの package.json を選んだか確認(ネストした別フォルダではない)。

有効化が失敗する?
アカウントまたはアクティベーションコードが有効か、期限切れでないか、メール紐付けが正しいか確認し、Mcp Panel から再試行。

起動したが Running にならない?
ポート 6589(または変更後)が空いているか、localhost がブロックされていないか。ステップ 3 の有効化完了を確認。

Claude CLI に unity-mcp が出ない?
Unity が Running か確認;クイック設定 で CLI コマンドを再コピー しターミナルで最後まで実行。Claude CLI を選んでいるか(Cursor ではない)。Gemini CLI も Gemini CLI 選択後にそのコマンドをコピー。

次のステップ

  • 自然言語でシーン照会や小変更を試し、ツール境界を把握
  • 大変更前にコミット;橋渡しは localhost のみ
  • 接続後のプロンプト例:Claude Code / Cursor と Unity MCP

こちらの記事もおすすめです

FigmaからUnity UIへ:VberAI Studioでデザインフレームをプレハブに変換

FigmaのレイアウトをUnity UI階層に変換—VberAI Studioでのインポート、自然言語編集、プレハブエクスポートと、Figma MCP・Unity MCPの連携方法。ほとんどのゲームUIは Figma で始まります。メニュー、HUDバー、ショップシート、モーダルスタックのフレーム。そのレイアウトを U…

  • figma-to-unity
  • figma-to-code
  • figma-ai
  • figma-design
続きを読む

Godot MCP vs 手書き:AI にエディタを任せる判断基準

Godot のシーン/シグナル慣例に沿い、VberAI Godot MCP が効く場面と、手書き GDScript を守るべき場面を短く整理する。Godot 4 の作業の大半はシーンツリー編集と GDScript です。手書きは正確だが反復が多い。Godot MCP は Cursor や Claude Code から…

  • godot-mcp
  • vberai
  • comparison
  • GDScript
続きを読む

VberAI Studio でできること:画像生成、原位スライス、換装、翻訳、切り抜き

VberAI Studio でできることを1ページで確認できます。AI画像生成、原位スライス、換装、UI翻訳、ピクセル化、切り抜き、シーケンスフレーム、オーディオ、3D、ビットマップフォントを扱い、Unity、Godot、Cocos へ書き出せます。VberAI Studio(Google AI Studio とは別…

  • vberai
  • ai-studio
  • game-ui
  • image-gen
続きを読む