云端
默认使用设备码 OAuth 流程通过 ai-game.dev 连接——无需手动复制令牌。在 AI Game Developer 窗口中选择 Cloud,点击 Authorize,然后在浏览器中批准设备码。可跨防火墙使用,并提供用量分析。这是默认方式,也是我们为大多数用户推荐的方式。
本页由英文机器翻译而成。阅读英文原文。
把 godot_mcp 插件添加到你的 C# Godot 项目,用 AI 驱动编辑器。
两种方式把插件装进你的项目——选适合你工作流的那种。
通过 npm 上的 godot-cli 工具安装。install-plugin 会从匹配的 GitHub Release 下载 godot_mcp 插件,向你的 .csproj 添加两个 NuGet 包和扩展目录嵌入资源,并启用插件——整个过程是幂等的。
从 npm 全局安装 godot-cli。
npm install -g godot-cli下载插件,将 NuGet 包添加到你的 .csproj,并在 project.godot 中启用 godot_mcp。
godot-cli install-plugin ./MyGodotProject为你的客户端生成 MCP 配置(例如 Claude Code)。
godot-cli setup-mcp claude-code ./MyGodotProject打开项目并等待编辑器就绪。
godot-cli open ./MyGodotProject打开后,你还可以根据编辑器就绪状态来控制脚本是否运行:godot-cli wait-for-ready ./MyGodotProject。
从 Godot 资源库安装 godot_mcp 插件(或从 GitHub Releases 下载同一个 zip),然后添加两个 NuGet 包并启用插件。
在资源库中查看从 Godot 的 AssetLib 标签页获取 godot_mcp,或从 GitHub Releases 页面下载 zip,并将其放入项目的 addons/ 文件夹。
将两个包都添加到你的项目 .csproj:com.IvanMurzak.ReflectorNet 版本 5.4.3 和 com.IvanMurzak.McpPlugin 版本 8.7.1,以及 addons/godot_mcp/extensions.catalog.json EmbeddedResource(没有它,扩展面板会为空)。确切内容见 Godot-MCP README。
在编辑器中打开 Project → Project Settings → Plugins,然后启用 godot_mcp。
重新打开项目,让 Godot 使用新包构建 C# 解决方案。
通过托管的云端端点运行,或指向你自己的服务器。
使用设备码 OAuth 流程通过 ai-game.dev 连接——无需手动复制令牌。在 AI Game Developer 窗口中选择 Cloud,点击 Authorize,然后在浏览器中批准设备码。可跨防火墙使用,并提供用量分析。这是默认方式,也是我们为大多数用户推荐的方式。
更想全部在本地运行?把插件指向你自己的 gamedev-mcp-server 实例,而不是托管端点。这样你的 AI 客户端会直接与本机通信。各客户端的配置片段见 MCP 端点页面。
需要客户端配置片段(Claude、Cursor、Copilot、Gemini 等)?查看 MCP 端点页面 →
选择你使用的 AI 智能体,复制把它接入 Godot MCP 服务器的 godot-cli 命令。
在你的项目中运行以下命令,为 Godot 配置 Claude Code:
godot-cli setup-mcp claude-code ./MyGodotProject在你的项目中运行以下命令,为 Godot 配置 Claude Desktop:
godot-cli setup-mcp claude-desktop ./MyGodotProject在你的项目中运行以下命令,为 Godot 配置 Cursor:
godot-cli setup-mcp cursor ./MyGodotProject在你的项目中运行以下命令,为 Godot 配置 VS Code (Copilot):
godot-cli setup-mcp vscode-copilot ./MyGodotProject在你的项目中运行以下命令,为 Godot 配置 Visual Studio (Copilot):
godot-cli setup-mcp vs-copilot ./MyGodotProject在你的项目中运行以下命令,为 Godot 配置 GitHub Copilot CLI:
godot-cli setup-mcp github-copilot-cli ./MyGodotProject在你的项目中运行以下命令,为 Godot 配置 Codex:
godot-cli setup-mcp codex ./MyGodotProject在你的项目中运行以下命令,为 Godot 配置 Gemini:
godot-cli setup-mcp gemini ./MyGodotProject在你的项目中运行以下命令,为 Godot 配置 Cline:
godot-cli setup-mcp cline ./MyGodotProject在你的项目中运行以下命令,为 Godot 配置 Rider (Junie):
godot-cli setup-mcp rider-junie ./MyGodotProject在你的项目中运行以下命令,为 Godot 配置 Kilo Code:
godot-cli setup-mcp kilo-code ./MyGodotProject在你的项目中运行以下命令,为 Godot 配置 Open Code:
godot-cli setup-mcp open-code ./MyGodotProject在你的项目中运行以下命令,为 Godot 配置 Antigravity:
godot-cli setup-mcp antigravity ./MyGodotProject配置后请重启你的智能体。新的 MCP 服务器只有在智能体完全重启后才会被加载——请彻底退出并重新打开(仅重载窗口不够)。
打开窗口,完成授权,然后试试你的第一条提示词。
添加一个包含 Camera3D 和 MeshInstance3D 立方体的 Node3D 场景,然后将其保存为 Main.tscn。想要更多示例提示词和高效 AI 请求的写作范式?查看 Godot 最佳实践 →
Godot 插件为你的 AI 客户端提供 99 个 MCP 工具。
浏览 Godot 工具目录 →想要更多工具?浏览 Godot 扩展 →