Claude Code 如何連接 Unity MCP:安裝與設定教學
逐步安裝 Unity MCP 並在 Claude CLI 中完成連線:Package Manager 匯入、啟用、啟動本機 MCP Server(預設 6589),複製 CLI 命令並執行,驗證 Hierarchy 讀寫。跟著下面五步,你可以把 Unity MCP 接到本機 Unity 專案,並讓 Claude CL…
- unity
- mcp
- claude-code
- tutorial
- unity-mcp
- ai
本教學能幫你完成什麼
跟著下面五步,你可以把 Unity MCP 接到本機 Unity 專案,並讓 Claude CLI 直接操作、預覽、除錯編輯器——而不只是改磁碟上的腳本檔案。
完成後你應能:
- 透過 Package Manager「從磁碟新增套件」匯入 Unity MCP
- 完成外掛啟用(帳號或啟用碼,以面板為準)
- 啟動本機 Unity MCP Server(預設連接埠 6589)
- 用「快速設定」複製 CLI 命令,在 Claude CLI 中執行並完成 MCP 連線
下載頁:Unity MCP
本文以 Claude CLI 為例;Gemini CLI 在「快速設定」裡選對應客戶端,同樣複製 CLI 命令執行。
前置條件
| 項目 | 說明 |
|---|---|
| Unity | 建議 2022.3+ / Unity 6(以官網目前支援說明為準) |
| 外掛套件 | 已下載並解壓縮的 Unity MCP 壓縮檔 |
| 啟用方式 | 外掛帳號 + 密碼,或電子郵件 + 啟用碼(以 Mcp Panel 為準) |
| AI IDE | Claude CLI(Gemini CLI 流程相同) |
| 本機網路 | MCP 橋接通常跑在 127.0.0.1,勿把連接埠暴露到公網 |
步驟 1:下載 Unity MCP
從所用 Unity MCP 的官網或發行頁下載外掛套件:
範例下載頁: [https://www.vberai.com/zh-TW/game-engines/unity?ch=CQZLC2FG)
建議:
- 開啟下載頁,取得 Unity MCP 壓縮檔
- 將壓縮檔存到本機,並解壓縮到固定目錄(下一步會選其中的
package.json) - 確認解壓縮後目錄中能看到
package.json,再進入 Unity
不同發行版的差異與授權說明,以其官網為準。
步驟 2:匯入外掛
- 開啟目標 Unity 專案
- 選單列點擊 視窗(Window)→ 套件管理員(Package Manager)
- 在套件管理員面板點擊左上角 「+」
- 選擇 「從磁碟新增套件」(Add package from disk)
- 選取步驟 1 解壓縮目錄下的
package.json檔案並確認
匯入成功後,Package Manager 列表中應能看到 Unity MCP 相關套件。

步驟 3:啟用 unity-mcp
- 選單列點擊 視窗(Window)→ Unity MCP → Mcp Panel
- 在啟用介面任選一種方式:
- 輸入 帳號 + 密碼 登入啟用
- 或輸入 電子郵件 + 啟用碼 完成啟用
- 啟用成功後再進入 MCP Server 設定頁(下一步)
未啟用時通常無法正常啟動服務;請確認帳號或啟用碼對應目前外掛版本。

步驟 4:啟動 unity-mcp-server
- 啟用成功後,進入 Unity MCP Server 設定頁面
- 按需調整:
- 連接埠:預設
6589 - 語言:按介面習慣選擇
- 啟動狀態:可按面板選項設定(例如是否隨編輯器自動啟動,以實際 UI 為準)
- 連接埠:預設
- 點擊 「啟動服務」
- 當面板出現 「執行中」 提示時,說明 Unity MCP Server 已啟動成功
此時本機已有可用的 MCP 橋接,接下來設定 Claude CLI。

步驟 5:設定 Claude CLI
- 點擊 「工具管理」
- 查看 Unity MCP Server 暴露的工具列表
- 按需要勾選你希望 AI 使用的能力
- 點擊 「快速設定」
- 選擇目標客戶端:Claude CLI(Gemini CLI 選同名項即可,流程相同)
- Claude CLI / Gemini CLI 不支援「自動設定」——需點擊 複製 面板上的 CLI 命令

- 開啟系統終端機,貼上並執行剛複製的命令(在已安裝 Claude CLI 的環境中執行)
- 回到 Claude CLI,確認 MCP 列表中已出現 unity-mcp(或面板註冊的等價名稱)

連線成功後的快速驗證
在 Claude CLI 中可先做一次唯讀確認,例如:
列出目前 Unity 開啟場景的根節點(Hierarchy 頂層物件)。
若回覆與編輯器 Hierarchy 一致,說明橋接正常。再嘗試小範圍寫入(如新建臨時空物件並刪除),確認權限與工具勾選符合預期。
常見問題
「從磁碟新增套件」找不到 package.json?
確認步驟 1 已完整解壓縮,且選取的是解壓縮目錄根層的 package.json,而不是多餘巢狀目錄裡的檔案。
啟用一直失敗?
核對帳號或啟用碼是否有效、是否過期、電子郵件是否綁定正確,然後回到 Mcp Panel 重試。
點了「啟動服務」但沒有「執行中」?
確認連接埠 6589(或你改過的連接埠)未被占用;關閉防火牆對 localhost 的誤攔後再試。確認步驟 3 已啟用成功。
Claude CLI 裡看不到 unity-mcp?
確認 Unity 服務仍為「執行中」;回到「快速設定」重新 複製 CLI 命令 並在終端機完整執行一次;確認選的是 Claude CLI 而非 Cursor。Gemini CLI 同理,需選 Gemini CLI 後複製對應命令。
下一步
- 用自然語言做一次場景查詢或小改動,熟悉工具邊界
- 大改前先提交版本;橋接僅保留在本機 localhost
- 連上後的提示寫法見 用 Claude Code 與 Cursor 操作 Unity MCP
繼續閱讀
你可能還會喜歡這些文章
VberAI 原位切圖:遊戲 UI 設計圖一鍵導入 Unity / Godot / Cocos
VberAI Studio 對整屏遊戲 UI 設計圖做原位切圖,保留佈局與尺寸,一鍵匯出到 Unity、Godot、Cocos。VberAI Studio(≠ Google AI Studio)支援原位切圖:把整屏遊戲 UI 設計圖拆成獨立 UI 元素,保留原圖佈局與尺寸,再一鍵匯出到 Unity / Go
- vberai
- ai-studio
- inplace-slice
- game-ui
Godot MCP vs 手寫腳本:什麼時候該讓 AI 操控編輯器
對照 Godot 場景組織與信號規範,說明 VberAI Godot MCP 適合加速原型與樣板,以及何時應堅持手寫 GDScript。在 Godot 4 裡做功能,多數時間花在改場景樹與寫/改 GDScript。手寫精確但重複多;Godot MCP 讓 Cursor、Claude Code 等客戶端用自然語言操作
- godot-mcp
- vberai
- comparison
- GDScript
Unity遊戲引擎MCP插件:提升你的遊戲開發工作流程
本文詳解VberAI YouTube頻道展示的Unity遊戲引擎MCP插件示範,教你如何透過自然語言指令生成和修改遊戲物件、腳本及場景。在本文中,我們將詳解VberAI YouTube頻道上展示的Unity遊戲引擎MCP插件示範。該影片展示了如何使用模型上下文協定(MCP)將Unity與AI驅動工具連接,使你能夠透
- video
- tutorial
- unity
- mcp