常見問題

針對大家最常詢問 Godot MCP 的問題提供快速解答。每個解答都附有詳細說明頁面的連結。

支援哪些 Godot 版本？#

Godot 4.3 以上版本，且需使用 .NET (mono) 版本。此 addon 以 Godot.NET.Sdk 4.3.0 為最低建置基準，其 CI 會在 Godot 4.3、4.4、4.5、4.6 與 4.7 上啟動測試。不支援 Godot 3。部分功能取決於版本：擷取執行階段錯誤時的多幀 GDScript 回溯需要 Godot 4.5；Dialogic、Phantom Camera 與 Terrain3D 擴充功能則需要 Godot 4.4。請參閱 安裝。

如果我的遊戲是用 GDScript，還需要 .NET 版本的 Godot 嗎？#

需要。此 addon 是以 C# 撰寫，因此需要 Godot 的 .NET 版本、.NET 8 SDK，以及專案中的 .csproj。你的遊戲本身可以維持使用 GDScript：代理程式會讀取、寫入與驗證 .gd 檔案，也能讀取與設定節點上的 GDScript 變數。

哪些 AI 用戶端可以搭配 Godot MCP？#

任何支援 HTTP 伺服器的 MCP 用戶端皆可。godot-cli setup-mcp 會為 Claude Code、Cursor、Visual Studio Code 與搭配 Copilot 的 Visual Studio、Rider (Junie)、GitHub Copilot CLI、Gemini、Antigravity、Cline、Open Code、Codex 與 Kilo Code 寫入設定檔，並為其他用戶端產生通用設定。Claude Desktop 與 claude.ai 則透過 Claude 自訂連接器連線。請參閱 連接 AI 用戶端。

要如何在 Godot 中使用 Claude Code？#

安裝 addon、登入並寫入設定，然後在專案資料夾中啟動 Claude Code：

godot-cli install-plugin ./MyGodotProject
godot-cli login
godot-cli setup-mcp claude-code ./MyGodotProject
godot-cli open ./MyGodotProject

在 Claude Code 中執行 /mcp，確認 Godot 工具已列出。請參閱 開始使用。

我可以在不使用雲端的情況下使用 Godot MCP 嗎？#

可以。將 dock 切換到 Custom 模式並點擊 Start Server：addon 會下載一次開源的 MCP 伺服器，在你的機器上執行並連線至它。使用 godot-cli setup-mcp <agent> --url http://localhost:8080 讓你的代理程式指向本機 URL。模型本身仍會在你的 AI 用戶端執行所在的環境中運作。請參閱 連接 AI 用戶端。

Godot MCP 是免費的嗎？#

此 addon 與 godot-cli 是以 Apache-2.0 授權的開源專案。其中兩個 NuGet 相依套件 RQL 與 Code-Exec 採用 PolyForm Shield License 1.0.0，允許用於商業產品，但不得用來建置與其競爭的產品。使用代管的 ai-game.dev 端點需要帳號；方案資訊請參閱網站 常見問題。你的 AI 用戶端（Claude、Copilot 等）則由其各自的供應商計費。

純 GDScript 專案也能從 CLI 使用嗎？#

當專案沒有 .csproj 時，godot-cli build 與 godot-cli open 會略過 C# 建置，但 addon 本身沒有它便無法編譯。請先透過 Project → Tools → C# → Create C# solution 建立 C# 方案，再執行 godot-cli install-plugin。

此 addon 會出現在我匯出的遊戲中嗎？#

此 addon 的編輯器工具只會在編輯器中編譯，且 RQL、Code-Exec 與 Roslyn 套件會從 ExportDebug 與 ExportRelease 建置中排除。遊戲只有在你的程式碼主動選擇啟用並呼叫 Connect() 時，才會對外提供 MCP 工具。請參閱 自訂工具。

代理程式可以復原它的變更嗎？#

可以。每次 rql-mutate 呼叫在編輯器中都是一個復原步驟，因此 Ctrl+Z 會像復原你自己的編輯一樣將它還原。失敗的變更不會造成任何修改，而 dry_run 可先預覽變更。建立或刪除腳本等檔案操作不屬於場景的復原歷程，因此請使用版本控制。

代理程式可以執行我的遊戲嗎？#

它可以透過 RQL 編輯器呼叫（PlayScene、StopScene）啟動與停止正在編輯的場景，並透過 gameLog 來源讀取遊戲輸出的內容。若要讓它讀取即時遊戲狀態或擷取的執行階段錯誤，請在遊戲中加入需主動啟用的執行階段元件。請參閱 工具 與 自訂工具。

我的權杖儲存在哪裡？#

雲端登入憑證位於 ~/.ai-game-dev/credentials.json（在 Windows 上以 DPAPI 保護，其他平台則為檔案模式 0600）。dock 本身的設定（包括所使用的任何權杖）位於 user://godot-mcp-config.json，以純 JSON 儲存。請勿提交或分享這兩個檔案。請參閱 設定。

我要如何新增更多工具？#

針對 AnimationPlayer、CSG、導覽或 TileMapLayer 等領域安裝擴充功能，或使用 [AiToolType] 與 [AiTool] 屬性以 C# 撰寫你自己的工具（自訂工具）。

AI Game Developer 也支援 Unity 和 Unreal 嗎？#

兩者都有相同的產品：Unity MCP 與 Unreal MCP。三者共用同一個 ai-game.dev 帳號與相同的 AI 用戶端。