Claude Code 如何連接 Unity MCP：安裝與設定教學

本教學能幫你完成什麼

跟著下面五步，你可以把 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/game-engines/unity?ch=CQZLC2FG

建議：

1. 開啟下載頁，取得 Unity MCP 壓縮檔
2. 將壓縮檔存到本機，並解壓縮到固定目錄（下一步會選其中的 package.json）
3. 確認解壓縮後目錄中能看到 package.json，再進入 Unity

不同發行版的差異與授權說明，以其官網為準。

步驟 2：匯入外掛

1. 開啟目標 Unity 專案
2. 選單列點擊 視窗（Window）→ 套件管理員（Package Manager）
3. 在套件管理員面板點擊左上角 「+」
4. 選擇 「從磁碟新增套件」（Add package from disk）
5. 選取步驟 1 解壓縮目錄下的 package.json 檔案並確認

匯入成功後，Package Manager 列表中應能看到 Unity MCP 相關套件。

步驟 3：啟用 unity-mcp

1. 選單列點擊 視窗（Window）→ Unity MCP → Mcp Panel
2. 在啟用介面任選一種方式：
   • 輸入 帳號 + 密碼 登入啟用
   • 或輸入 電子郵件 + 啟用碼 完成啟用
3. 啟用成功後再進入 MCP Server 設定頁（下一步）

未啟用時通常無法正常啟動服務；請確認帳號或啟用碼對應目前外掛版本。

步驟 4：啟動 unity-mcp-server

1. 啟用成功後，進入 Unity MCP Server 設定頁面
2. 按需調整：
   • 連接埠：預設 6589
   • 語言：按介面習慣選擇
   • 啟動狀態：可按面板選項設定（例如是否隨編輯器自動啟動，以實際 UI 為準）
3. 點擊 「啟動服務」
4. 當面板出現 「執行中」 提示時，說明 Unity MCP Server 已啟動成功

此時本機已有可用的 MCP 橋接，接下來設定 Claude CLI。

步驟 5：設定 Claude CLI

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

3. 開啟系統終端機，貼上並執行剛複製的命令（在已安裝 Claude CLI 的環境中執行）
4. 回到 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