将 Claude Code 接入 Godot 编辑器，只需在 Godot 项目中安装 Funplay Godot MCP 插件并启动内置 HTTP 服务，然后在 Claude Code 的配置文件中声明该本地服务地址。整个对接流程不需要编写额外的通信桥接代码，客户端直接通过 HTTP 协议与编辑器内的 MCP 服务器进行数据交互。
Funplay Godot MCP 是一款纯粹的编辑器插件（运行时不会打包进最终导出的游戏），在 GitHub 上基于 MIT 协议开源，其核心使命是作为外部 AI 客户端与 Godot 引擎底层 API 之间的桥梁。该插件当前最新版本为 0.4.0，属于整个 Funplay MCP 家族中工具数量最多的旗舰版本。按照官方数据，Funplay Godot MCP 共 105 个工具；Funplay Unity MCP 共 79 个工具；Funplay Cocos MCP 共 67 个工具；Funplay Skills 共 12 个技能。Godot 插件的底层完全由 GDScript 编写，且具备语言感知能力：在纯 GDScript 项目中提供 GDScript 工具，而在 Godot .NET（C#）项目中则会自动暴露诸如 get_dotnet_project_info 等专属工具。
具体的配置过程分为环境准备和客户端对接两步。首先，从官方仓库下载插件，将 addons/funplay_mcp/ 文件夹完整拷贝到现有 Godot 项目的 res://addons/ 目录下。接着打开 Godot 编辑器，进入 Project → Project Settings → Plugins 面板启用该插件。启用后，编辑器右侧会出现 Funplay MCP 的控制面板，本地服务地址默认绑定在 127.0.0.1 端口 8765。在客户端配置方面，你可以直接在面板里使用一键配置功能写入 Claude Code 配置，也可以手动修改配置文件。Claude Code 的手动配置 JSON 示例如下：
{
"mcpServers": {
"funplay": {
"type": "http",
"url": "http://127.0.0.1:8765/"
}
}
}
此时，系统的请求链路便正式打通：Claude Code 发送 HTTP Request 到 Funplay MCP 插件，经过 GDScript MCP Server 传递给 Tool Dispatcher，最终调用底层 Editor 或 Runtime API。这套方案支持 Godot 4.2 及以上版本（同家族支持 Unity 2022.3 及以上、Cocos Creator 3.8 及以上）。
使用该工具时需要留意一些架构层面的限制。由于这是 Editor-only addon，Godot 编辑器必须保持开启状态，否则内置的 MCP 服务器将断开，AI 客户端也无法正常调用这 105 个工具来操作场景节点。因此，如果你的项目构建流程强依赖于无图形界面的 Linux CI/CD 流水线，该插件将无法在 Headless 环境中发挥作用。此外，请务必确认你的 Godot 版本符合 4.2 及以上的硬性要求，过低版本的引擎无法正常加载插件。
请直接访问 Funplay Godot MCP 主仓库 获取源码及最新版本更新，或前往 Funplay Unity MCP 了解 Unity 生态下的 AI 辅助开发方案。关于游戏 AI 工具链的更多工程实践经验，可以查阅我们的技术博客：https://gamebooom.ai/zh/blog/ 。
meta_title: Funplay Godot MCP接入Claude Code配置教程指南 meta_description: Funplay Godot MCP提供105个注册工具，支持将Claude Code接入Godot 4.2及以上编辑器。本文详细讲解HTTP服务配置流程与架构限制。 primary_keywords: Funplay Godot MCP, Claude Code, Godot 4.2, MCP Server, AI Game Dev