把 Claude Code 接入 Unity 的核心是通过 Funplay Unity MCP 服务器建立本地连接。只需在编辑器内安装插件并配置 Claude Code 的 MCP 设置文件，即可让 AI 直接操作运行中的项目。
Funplay Unity MCP 是一款基于 MIT 开源协议的 Unity Editor MCP 服务器，专为直接操作运行中的 Unity 项目而设计。该项目要求系统环境为 Unity 2022.3 及以上版本。它内置了 79 个工具，全面覆盖了日常开发的核心环节，包括场景创建、脚本生成、运行时验证、输入模拟、性能分析和编辑器自动化。针对不同的使用需求，服务器提供了两种工具 Profile 配置：包含 19 个基础工具的 core 模式，以及包含全部 79 个工具的 full 模式。该工具兼容 Claude Code、Cursor、VS Code Copilot、Windsurf 和 Codex 等主流 AI 编程环境。
接入过程分为三个具体步骤。第一步，在 Unity 编辑器中安装 Funplay Unity MCP 包。通过顶部菜单栏打开 Window → Package Manager，点击左上角的加号按钮，选择 Add from git URL。在弹出的输入框中填入仓库地址：https://github.com/FunplayAI/funplay-unity-mcp.git，等待 Unity 完成下载和编译。
第二步，在 Unity 编辑器中启动本地 MCP 服务。安装完成后，在顶部菜单栏找到 Funplay → MCP Server 并点击启动。服务启动后，默认会监听本地地址 http://127.0.0.1:8765/。在开发过程中，必须保持 Unity 编辑器处于运行状态以及该服务的开启状态。
第三步，在 Claude Code 的配置文件中添加 MCP 服务器信息。通过修改本地项目的配置文件，将 AI 客户端指向刚才在 Unity 中开启的本地端口，使其具备通过协议发送指令的能力。配置代码如下：
{
"mcpServers": {
"funplay-unity": {
"url": "http://127.0.0.1:8765/"
}
}
}
在使用该工具链时，有几个关键的技术限制需要明确。首先，该工具明确要求 Unity 编辑器版本必须在 Unity 2022.3 及以上，低版本引擎无法正常加载运行。其次，由于该方案依赖于本地的 HTTP 服务通信，这意味着在 AI 工具通过 MCP 执行读写或输入模拟时，Unity 编辑器必须处于运行状态。如果 Unity 处于关闭或未响应状态，Claude Code 的相关工具调用将会因为无法连接到 127.0.0.1 端口 8765 而报错。因此，在不需要实时读取场景状态的纯离线脚本编写阶段，无需强制开启此服务。
前往 Funplay Unity MCP 仓库 获取最新版本。如果你也参与其他引擎的开发，可以访问 https://github.com/FunplayAI/ 查看 Funplay Godot MCP 等兄弟项目。更多关于 AI 游戏开发的技术文章可以访问 https://gamebooom.ai/zh/blog/ 获取。
meta_title: 三步接入Claude Code到Unity的Funplay MCP实操指南 meta_description: 使用Funplay Unity MCP，只需三步即可将Claude Code接入Unity 2022.3+。通过79个内置工具实现场景创建与自动化。 primary_keywords: Funplay Unity MCP, Claude Code Unity, MCP Server, Unity AI, 游戏开发自动化