Claude Code 如何连接 Unity MCP：安装与配置教程

本教程能帮你完成什么

跟着下面五步，你可以把 Unity MCP 接到本机 Unity 工程，并让 Claude CLI 直接操作、预览、调试编辑器——而不只是改磁盘上的脚本文件。

完成后你应能：

• 通过 Package Manager「从磁盘添加包」导入 Unity MCP
• 完成插件激活（账号或激活码，以面板为准）
• 启动本地 Unity MCP Server（默认端口 6589）
• 用「快速配置」复制 CLI 命令，在 Claude CLI 中执行并完成 MCP 连接

下载页：Unity MCP

本文以 Claude CLI 为例；Gemini CLI 在「快速配置」里选对应客户端，同样复制 CLI 命令执行。

前置条件

项目	说明
Unity	建议 2022.3+ / Unity 6（以官网当前支持说明为准）
插件包	已下载并解压的 Unity MCP 压缩包
激活方式	插件账号 + 密码，或邮箱 + 激活码（以 Mcp Panel 为准）
AI IDE	Claude CLI（Gemini CLI 流程相同）
本机网络	MCP 桥接通常跑在 127.0.0.1，勿把端口暴露到公网

步骤 1：下载 Unity MCP

从所用 Unity MCP 的官网或发行页下载插件包：

示例下载页： https://www.vberai.com/game-engines/unity?ch=CQZLC2FG

建议：

1. 打开下载页，获取 Unity MCP 压缩包
2. 将压缩包保存到本机，并解压缩到固定目录（下一步会选其中的 package.json）
3. 确认解压后目录中能看到 package.json，再进入 Unity

不同发行版的差异与授权说明，以其官网为准。

步骤 2：导入插件

1. 打开目标 Unity 工程
2. 菜单栏点击 窗口（Window）→ 包管理器（Package Manager）
3. 在包管理器面板点击左上角 「+」
4. 选择 「从磁盘添加包」（Add package from disk）
5. 选中步骤 1 解压目录下的 package.json 文件并确认

导入成功后，Package Manager 列表中应能看到 Unity MCP 相关包。

步骤 3：激活 unity-mcp

1. 菜单栏点击 窗口（Window）→ Unity MCP → Mcp Panel
2. 在激活界面任选一种方式：
   • 输入 账号 + 密码 登录激活
   • 或输入 邮箱 + 激活码 完成激活
3. 激活成功后再进入 MCP Server 设置页（下一步）

未激活时通常无法正常启动服务；请确认账号或激活码对应当前插件版本。

步骤 4：启动 unity-mcp-server

1. 激活成功后，进入 Unity MCP Server 设置页面
2. 按需调整：
   • 端口：默认 6589
   • 语言：按界面习惯选择
   • 启动状态：可按面板选项设置（例如是否随编辑器自动启动，以实际 UI 为准）
3. 点击 「启动服务」
4. 当面板出现 「运行中」 提示时，说明 Unity MCP Server 已启动成功

此时本机已有可用的 MCP 桥接，接下来配置 Claude CLI。

步骤 5：配置 Claude CLI

1. 点击 「工具管理」
   • 查看 Unity MCP Server 暴露的工具列表
   • 按需要勾选你希望 AI 使用的能力
2. 点击 「快速配置」
   • 选择目标客户端：Claude CLI（Gemini CLI 选同名项即可，流程相同）
   • Claude CLI / Gemini CLI 不支持「自动配置」——需点击 复制 面板上的 CLI 命令

3. 打开系统终端，粘贴并执行刚复制的命令（在已安装 Claude CLI 的环境中运行）
4. 回到 Claude CLI，确认 MCP 列表中已出现 unity-mcp（或面板注册的等价名称）

连接成功后的快速验证

在 Claude CLI 中可先做一次只读确认，例如：

列出当前 Unity 打开场景的根节点（Hierarchy 顶层对象）。

若回复与编辑器 Hierarchy 一致，说明桥接正常。再尝试小范围写入（如新建临时空物体并删除），确认权限与工具勾选符合预期。

常见问题

「从磁盘添加包」找不到 package.json？
确认步骤 1 已完整解压，且选中的是解压目录根层的 package.json，而不是多余嵌套目录里的文件。

激活一直失败？
核对账号或激活码是否有效、是否过期、邮箱是否绑定正确，然后回到 Mcp Panel 重试。

点了「启动服务」但没有「运行中」？
确认端口 6589（或你改过的端口）未被占用；关闭防火墙对 localhost 的误拦后再试。确认步骤 3 已激活成功。

Claude CLI 里看不到 unity-mcp？
确认 Unity 服务仍为「运行中」；回到「快速配置」重新 复制 CLI 命令 并在终端完整执行一次；确认选的是 Claude CLI 而非 Cursor。Gemini CLI 同理，需选 Gemini CLI 后复制对应命令。

下一步

• 用自然语言做一次场景查询或小改动，熟悉工具边界
• 大改前先提交版本；桥接仅保留在本机 localhost
• 连上后的提示写法见 用 Claude Code 与 Cursor 操作 Unity MCP