Unity MCP インストール手順：Package Manager から追加して AI IDE に接続

このガイドでできること

次の 5 ステップで Unity MCP（VberAI Pro）をローカルの Unity プロジェクトに接続し、Cursor（または他の MCP 対応 AI IDE。手順は同趣旨）からエディタを操作・プレビュー・デバッグできるようにします。

完了後にできること：

• Package Manager の ディスクからパッケージを追加 で Unity MCP をインポートする
• VberAI アカウント、またはメール＋アクティベーションコードで有効化する
• ローカルの Unity MCP Server（既定ポート 6589）を起動する
• クイック設定 → 自動設定 で Cursor に登録し、接続を確認する

製品ページ：VberAI Unity MCP

本稿は Cursor を例にします。Claude Code、Windsurf、Cline なども流れは同様です。

前提条件

項目	内容
Unity	2022.3+ / Unity 6 推奨（公式の最新サポート表記に従う）
プラグイン	公式サイトの Unity MCP Pro アーカイブ（解凍済み）
有効化	VberAI アカウント＋パスワード、またはメール＋アクティベーションコード
AI IDE	Cursor 推奨。他の MCP クライアントでも可
ローカル通信	橋渡しは通常 127.0.0.1。ポートを公開しないこと

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

VberAI 公式サイトから Pro を入手します。

ダウンロードページ： https://www.vberai.com/game-engines/unity?ch=CQZLC2FG

推奨手順：

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

OSS / Pro の違いと料金は公式の最新説明に従ってください。

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

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

成功後、一覧に Unity MCP 関連パッケージが表示されます。

ステップ 3：unity-mcp を有効化する

1. メニュー Window → Unity MCP → Mcp Panel
2. 有効化画面で次のいずれか：
   • VberAI アカウント＋パスワード
   • メール＋アクティベーションコード
3. 成功後、MCP Server 設定ページへ進む（次ステップ）

未有効化だとサービスは通常起動しません。プランやコードが現行 Pro に対応しているか確認してください。

ステップ 4：unity-mcp-server を起動する

1. 有効化後、Unity MCP Server 設定を開く
2. 必要に応じて調整：
   • ポート：既定 6589
   • 言語：UI の好みに合わせる
   • 起動：パネルのオプションに従う（エディタ連動の自動起動など）
3. サービスの起動 をクリック
4. 「実行中」 と表示されたら起動成功です

これでローカル MCP 橋渡しが用意できました。次に AI IDE へ渡します。

ステップ 5：AI IDE を一括設定する（Cursor の例）

1. ツール管理 を開く
   • 公開ツール一覧を確認し、使わせたいものだけをオンにする
2. クイック設定 を開く
   • IDE（例：Cursor）を選ぶ
   • 自動設定 をクリック
   • 設定済み 状態になることを確認する
3. Cursor を開く
   • MCP / ツール一覧に unity-mcp が接続されているはずです
   • 出ない場合は Cursor で 再読み込み（MCP Reload）して再確認する

他の IDE もクイック設定でクライアントを切り替えるだけです。

接続後の簡単な確認

Cursor ではまず読み取り専用の確認から始めます。例：

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

Hierarchy と一致すれば橋渡しは正常です。続けて小さな書き込みで権限とツール選択を確認してください。

よくある質問

ディスクから追加で package.json が見つからない？
ステップ 1 で完全に解凍し、解凍ルート直下の package.json を選んでいるか確認（二重ネストに注意）。

有効化が何度も失敗する？
Pro 権限やコードの有効期限・メール紐付けを公式アカウントで確認してから再試行してください。

起動しても「実行中」にならない？
ポート 6589（または変更ポート）が空いているか、localhost をブロックしていないかを確認。ステップ 3 の完了も確認します。

Cursor に unity-mcp が出ない？
Unity 側が 実行中 か確認し、クイック設定→自動設定をやり直し、Cursor で MCP を再読み込みします。

次のステップ

• 自然言語でシーン照会や小さな編集を試し、ツールの境界を把握する
• 大きな変更の前にコミットする。橋渡しは localhost のみ
• デザインからエンジン UI は VberAI AI Studio と組み合わせ、その後 MCP で反復する

背景は Unity MCP 動画ガイド、Claude Code / Cursor で Unity MCP も参照できます。