Cursor 连上 Cocos Creator MCP 后坏了?按症状排查连不上
Cursor 接 VberAI Cocos Creator MCP 后像「坏了」:MCP 列表无服务、红错、已连但无工具。先从 Cursor 侧核对,再按四层链路跳到 Creator 扩展、激活与端口排查。装好 Cocos MCP 并在 Cursor 里配过一次之后,很多人的直觉是「Cursor 坏了」:对话里碰不到…
- cocos
- cocos-creator
- mcp
- cursor
- troubleshooting
- cocos-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 / 工具相关设置(具体菜单位置随版本可能略有差异),检查:
- 列表里是否出现
cocos-creator(或以面板「快速配置」写入的名称为准) - 状态是否为已连接 / 可用,而不是持续错误、断开或空白
- 若刚改过配置或刚在 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 也不会出现可用工具。
产品页(按工程大版本选包,勿混用):
步骤 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 层:账号与激活(见通用排障) |
| 已连接但列不出节点 | 确认打开了正确工程;先做下方只读冒烟;仍异常再查工具勾选 |
完整安装:
步骤 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 是什么。
继续阅读
你可能还会喜欢这些文章
我们如何为 Godot 打造实时 MCP Server
拆解 VberAI 的 Godot MCP 架构:实时 Model Context Protocol 服务如何在不卡死场景树的前提下,把 Godot 编辑器接到 AI 客户端。多数 MCP Demo 活在 REST 心态里:模型问一句,工具回一段 JSON,往返两秒也没人在意。Godot 不一样。编辑器握着活的 场景…
- vberai
- godot
- mcp
- architecture
ChinaJoy 2026:VberAI 在 W5 展区的现场观察
记录 VberAI 参加 2026 ChinaJoy(上海新国际博览中心 W5):国内外访客与决策者到访,宣传册首日发完,俄罗斯客户密集咨询,以及与韩国 3D 资产公司交流、下月游戏 3D 资产生成能力与对接意向。2026 年 7 月 31 日至 8 月 3 日,ChinaJoy(中国国际数码互动娱乐展览会)在上海新…
- ChinaJoy
- VberAI
- AI Studio
- 3D资产
Cocos MCP 安装(Creator 3.x):导入扩展并连接 AI IDE
Cocos MCP / cocos mcp:逐步安装 VberAI Cocos Creator 3.x MCP Pro——扩展管理器导入、激活、启动本地 Server,并在 Cursor 等 AI IDE 验证连接。2.x 见 Cocos Creator 2.x MCP 安装文。跟着下面五步,你可以把 Cocos C…
- cocos
- cocos-creator
- mcp
- cursor