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

引擎 · Godot

Godot可用

將 godot_mcp 外掛加入你的 C# Godot 專案，就能用 AI 操作編輯器。

Godot 4.3–4.5C# / .NET 8 (mono)
01

安裝外掛

有兩種方式可將外掛加入你的專案 — 挑選最適合你工作流程的一種。

推薦

CLI

透過 npm 上的 godot-cli 工具安裝。install-plugin 會從對應的 GitHub release 下載 godot_mcp 外掛、把兩個 NuGet 套件與擴充功能目錄內嵌項目加入你的 .csproj，並啟用外掛——重複執行也不會出問題。

1安裝 CLI

從 npm 全域安裝 godot-cli。

npm install -g godot-cli
2安裝外掛

下載外掛、把 NuGet 套件加入你的 .csproj，並在 project.godot 中啟用 godot_mcp。

godot-cli install-plugin ./MyGodotProject
3接好你的 AI 用戶端

為你的用戶端（例如 Claude Code）產生 MCP 設定。

godot-cli setup-mcp claude-code ./MyGodotProject
4開啟並等待

開啟專案，並等待編輯器就緒。

godot-cli open ./MyGodotProject

開啟後，你還可以讓腳本等到編輯器就緒再執行：godot-cli wait-for-ready ./MyGodotProject。

素材庫

從 Godot Asset Library 安裝 godot_mcp 外掛（或從 GitHub Releases 取得同一個 zip），然後加入兩個 NuGet 套件並啟用外掛。

在 Asset Library 查看
1安裝外掛

從 Godot 的 AssetLib 分頁取得 godot_mcp，或從 GitHub Releases 頁面下載 zip，然後放進專案的 addons/ 資料夾。

2加入 NuGet 套件

把兩個套件都加入你的專案 .csproj：com.IvanMurzak.ReflectorNet 版本 5.4.3 與 com.IvanMurzak.McpPlugin 版本 8.7.1，再加上 addons/godot_mcp/extensions.catalog.json 這個 EmbeddedResource（少了它，Extensions 面板會是空的）。完整的設定區塊請見 Godot-MCP README。

3啟用外掛

在編輯器中：Project → Project Settings → Plugins，然後啟用 godot_mcp。

4開啟並建置

重新開啟專案，讓 Godot 用新的套件建置 C# 方案。

02

連接

透過託管的雲端端點執行，或指向你自己的伺服器。

雲端

預設

使用裝置碼 OAuth 流程透過 ai-game.dev 連接 — 不必手動複製權杖。在 AI Game Developer 視窗中選擇 Cloud，點擊 Authorize，並在瀏覽器中核准裝置碼。可穿越防火牆運作，並提供使用情形分析。這是預設方式，也是我們對大多數使用者的建議。

自訂

想全部在本機執行？將外掛指向你自己的 gamedev-mcp-server 執行個體，而非託管端點。你的 AI 用戶端便會直接與你的機器通訊。各用戶端的設定片段請見 MCP 端點頁面。

需要用戶端設定片段（Claude、Cursor、Copilot、Gemini 等）？參閱 MCP 端點頁面 →

03

設定你的 AI 代理

選擇你使用的 AI 代理，並複製可將其連接至 Godot MCP 伺服器的 godot-cli 指令。

你的 AI 代理

在專案中執行以下指令，為 Godot 設定 Claude Code：

godot-cli setup-mcp claude-code ./MyGodotProject

設定完成後請重新啟動你的代理。新的 MCP 伺服器只有在代理完全重新啟動後才會被載入 — 請完全結束再重新開啟（不只是重新載入視窗）。

04

首次執行

開啟視窗、完成授權，然後試試你的第一個提示詞。

  1. 在 Godot 編輯器中開啟專案，並開啟 AI Game Developer 停駐面板。
  2. 選擇 Cloud 並點擊 Authorize 以完成裝置碼流程。
  3. 等到狀態轉為綠燈，再連接你的 AI 用戶端。
  4. 試試下方這類提示詞，看看它在編輯器裡如何運作。
範例提示詞
新增一個含 Camera3D 與 MeshInstance3D 立方體的 Node3D 場景，並存成 Main.tscn。

想要更多範例提示詞，以及有效 AI 請求的模式嗎？查看 Godot 最佳實務 →

Godot 外掛會為你的 AI 用戶端提供 99 個 MCP 工具。

瀏覽 Godot 工具目錄 →

想要更多工具嗎？瀏覽 Godot 擴充功能 →