Cursor 连上 Cocos Creator MCP 后坏了？按症状排查连不上

装好 Cocos MCP 并在 Cursor 里配过一次之后，很多人的直觉是「Cursor 坏了」：对话里碰不到场景、MCP 面板一片红、或昨天还能用今天突然没了。多数情况下，Cursor 本体并没有损坏，而是 MCP 桥没通——Creator 侧服务未运行，或 Cursor 侧配置/重载未生效。

本文从 Cursor 里能看见的症状 下手，尽快判断该查哪一层。Creator 扩展导入、激活码、端口占用等长步骤，见通用排障：Cocos MCP 连接失败排查。若还不清楚 MCP 是什么，见：Cocos Creator MCP 是什么。

先分清：坏的是 Cursor，还是桥

你的感受	更可能的原因
Cursor 能写普通代码，但碰不到 Cocos 场景/节点	MCP 未连接或工具未启用
MCP 面板里没有 cocos-creator（或面板显示的服务名）	配置未写入，或需 Reload
有服务名但是错误 / 断开状态	Creator 未 Running、URL/端口不对、或需重载
显示已连接，但列不出当前场景节点	连错工程、工具未勾选、或只读验证方式不对

Claude Code、Codex 等 MCP 客户端的核对逻辑类似：先确认客户端里服务存在且健康，再查 Creator。

步骤 1：只看 Cursor 里的 MCP

在 Cursor 打开 MCP / 工具相关设置（具体菜单位置随版本可能略有差异），检查：

1. 列表里是否出现 cocos-creator（或以面板「快速配置」写入的名称为准）
2. 状态是否为已连接 / 可用，而不是持续错误、断开或空白
3. 若刚改过配置或刚在 Creator 里点过「自动配置」：执行一次 Reload Window（或等价的 MCP 重载），再看列表

常见情况是：Creator 侧已经「运行中」，但 Cursor 仍握着旧配置——不重载就会像「突然坏了」。

步骤 2：核对地址是否指向本机 Creator

Cursor 侧 MCP 条目应指向 本机 桥接地址，通常形如：

• http://127.0.0.1:3000/mcp
• 或 http://localhost:3000/mcp

端口以 Creator 里 MCP 面板显示为准（默认多为 3000，改过则以面板为准）。

同时打开 Cocos Creator，确认同一工程里 MCP 面板为 运行中。若面板未运行，Cursor 再怎么 Reload 也不会出现可用工具。

产品页（按工程大版本选包，勿混用）：

• Cocos MCP 3.x
• Cocos MCP 2.x

步骤 3：仍失败时，按四层跳转

MCP 链路可拆成四层。任一层失败，在 Cursor 里都可能表现为「坏了 / 连不上」：

1. 插件已进工程且已启用
        ↓
2. 面板已激活（账号/激活码）
        ↓
3. MCP Server 显示「运行中」（本机 localhost）
        ↓
4. Cursor 已写入配置且 MCP 列表显示已连接

Cursor 里看到的	优先去哪
完全没有服务条目	第 4 层：回到 Creator 用「快速配置 → 自动配置」，再 Reload；细节见通用排障
有条目但是错误 / 连不上	第 3 层：Creator 是否 Running、端口是否一致、localhost 是否被拦
Creator 菜单里就没有 MCP	第 1 层：2.x/3.x 包是否混用、导入路径、是否重启（见通用排障症状 A）
面板打不开服务 / 未激活	第 2 层：账号与激活（见通用排障）
已连接但列不出节点	确认打开了正确工程；先做下方只读冒烟；仍异常再查工具勾选

完整安装：

• Cocos Creator 3.x MCP 安装
• Cocos Creator 2.x MCP 安装

步骤 4：冒烟验收（确认「修好了」）

在 Cursor 里先做一次只读确认，例如：

列出当前 Cocos Creator 打开场景的根节点。

若回复与编辑器层级一致，桥接可用。再视需要做一次可逆小写入（如新建临时节点并删除）。大改前先提交版本；桥接只留在本机 localhost，不要把 MCP 端口暴露到公网。

常见问题

Cursor 连 Cocos Creator MCP 后「坏了」通常是什么意思？
常见表现：MCP 列表没有服务、条目报错/连不上、显示已连接但列不出工具或节点。多数不是 Cursor 本身崩溃，而是四层链路某一环未就绪。

应该先查 Cursor 还是先查 Creator？
先看 Cursor MCP 列表有没有服务名、是否红错；再回到 Creator：插件是否导入启用、面板是否激活、Server 是否 Running、端口是否与配置一致。对照表见正文。

已连接但列不出节点怎么办？
确认打开了正确工程与场景；先做只读冒烟（列出根节点）。仍异常再查工具勾选与权限。通用步骤：连接失败排查。

需要重装 Cursor 吗？
一般不需要。优先「快速配置 → 自动配置」后 Reload MCP，并核对 localhost 端口。品类说明：Cocos Creator MCP 是什么。