本頁面由英文機器翻譯而成。閱讀英文原文。

常見問題

Unity MCP 常見問題解答：支援的 Unity 版本與 AI 用戶端、Cloud 與本機模式、費用、隱私、組建、CI 與 RQL。

更新於 2026年11月4日 以 Markdown 檢視

針對 Unity MCP（Unity 的 AI Game Developer 外掛）最常被問到的問題提供簡短解答。每個解答都附有詳細說明頁面的連結。

一般

Unity MCP 是什麼？

這是一款 Unity Editor 外掛，讓 AI 代理透過 Model Context Protocol 在你的專案中工作。代理可以讀取與修改場景、GameObject、元件、預製件與資源，撰寫並執行 C#、執行測試以及擷取畫面。請參閱概觀。

外掛是否免費且開源？

外掛以 Apache-2.0 授權開源，位於 Unity-MCP 儲存庫。Custom 模式會執行本機伺服器，不需要帳號。Cloud 模式則使用你的 ai-game.dev 帳號；方案請見價格頁面。

支援哪些 Unity 版本？

Unity 2022.3 及更新版本，包含 Unity 6。

支援哪些 AI 用戶端？

AI Game Developer 視窗內建 Claude Code、Claude Desktop、Cursor、Visual Studio Code（Copilot）、Visual Studio（Copilot）、Rider（Junie）、GitHub Copilot CLI、Gemini、Antigravity、Cline、Open Code、Codex、Kilo Code、Zoo Code 與 Unity AI 的設定工具，另外還有可自訂的項目，可支援任何其他 MCP 用戶端。請參閱連接 AI 用戶端。

我需要自備 AI 用戶端嗎？

不需要。AI Game Dev 桌面應用程式內含代理，會安裝外掛並完成連線。如果你已經在使用 Claude Code、Cursor 或其他 MCP 用戶端，也可以自備用戶端。

設定

最簡單的安裝方式是什麼？

使用桌面應用程式。若不使用，可執行 unity-mcp-cli install-plugin，或改用 OpenUPM 或 .unitypackage 安裝程式。請參閱安裝。

外掛視窗在哪裡？

Window > AI Game Developer — MCP，快速鍵 Ctrl+Alt+A（macOS 為 Cmd+Option+A），或 Scene View 工具列上的 AI 按鈕。

Cloud 與 Custom 模式有什麼差別？

在預設的 Cloud 模式下，Editor 與你的 AI 用戶端會連線到 https://ai-game.dev/mcp，你只需登入一次。在 Custom 模式下，外掛會依專案路徑衍生的連接埠啟動本機 MCP 伺服器，所有資料都留在你的電腦上。請參閱設定。

我需要自己選擇連接埠嗎？

不需要。連接埠由專案路徑衍生（範圍 20000 到 29999），因此每個專案的連接埠固定不變，且不同專案互不相同。你可以在 Server URL 中覆寫。

設定儲存在哪裡？

儲存在專案內的 UserSettings/AI-Game-Developer-Config.json。ai-game.dev 的登入資訊則依每台電腦儲存於 ~/.ai-game-dev/credentials.json。

我可以同時使用多個 Unity 專案嗎？

可以。每個專案都有各自的連接埠，而固定網址（https://ai-game.dev/mcp/p/<pin>）會將每個代理導向正確的 Editor。

使用方式

像 gameobject-create 這類工具跑到哪裡去了？

\1.0.0 版以 RQL 取代了過去一個動作一個工具的做法：rql-query、rql-mutate 與 rql-schema 涵蓋場景、GameObject、元件、資源、Console 與 Editor 狀態。請參閱工具與 RQL。

AI 可以復原它的變更嗎？

每次 rql-mutate 呼叫都會記錄為一個復原步驟，因此按 Ctrl+Z（Cmd+Z）即可還原。較大範圍的變更請使用版本控制。

為什麼代理只看得到少數幾個工具？

為了節省上下文。預設會顯示七個工具；其餘工具雖已安裝但會隱藏，只要以名稱呼叫仍可執行。可在視窗的 Tools > Open 下顯示更多。

我可以加入自己的工具嗎？

可以。在類別上標註 [AiToolType]，並在方法上標註 [AiTool]。請參閱自訂工具。

如何新增對 Cinemachine、ProBuilder 或 Tilemaps 的支援？

從視窗的 Extensions 區段安裝對應的擴充功能，或使用 unity-mcp-cli install-extension。請參閱擴充功能。

在 Play 模式下也能運作嗎？

可以。代理可以透過 RQL（例如 isPlaying 等 editor 成員）進入與離開 Play 模式。網域重新載入後連線會自動重新建立。

組建、CI 與隱私

外掛會被打包進我的遊戲組建嗎？

執行階段部分會編譯進玩家組建中，但組建本身絕不會自行連線。你必須在程式碼中透過 UnityMcpPluginRuntime.Initialize(...) 主動啟用，才能在遊戲中提供 AI 工具。若要完全排除此外掛，請加入 UNITY_MCP_EXCLUDE_FROM_COMPILATION 指令碼定義。請參閱設定。

如何讓它不參與 CI 測試執行？

在 Unity 程序的環境中設定 UNITY_MCP_DISABLE=1，或使用 UNITY_MCP_EXCLUDE_FROM_COMPILATION 定義。請參閱設定。

我可以在沒有 AI 用戶端的情況下用腳本操作嗎？

可以。unity-mcp-cli run-tool 可從終端機呼叫任何工具，而 unity-mcp-cli exec 則會在編輯器中執行 C#。請參閱 CLI 參考文件。

哪些資料會離開我的機器？

在 Custom 模式下使用 none 或 token 授權時，不會有任何資料經過 ai-game.dev：代理程式與 Unity 是透過本機伺服器溝通。你的 AI 用戶端仍會將對話傳送給它自己的模型供應商。在 Cloud 模式下，工具呼叫與結果會在代理程式與編輯器之間傳遞時經過 ai-game.dev 伺服器。

我要如何為團隊關閉更新彈出視窗？

在 Edit > Project Settings > AI Game Developer 中啟用 Disable update notifications for the entire team，並提交 ProjectSettings/AI-Game-Developer-UpdateSettings.asset。

更多協助