Cursor Roto Después de Cocos Creator MCP: Solución por Síntoma

Primero: ¿Está Roto Cursor, o el Puente?

Lo que sientes	Causa más probable
Cursor aún escribe código normal, pero no puede alcanzar escenas/nodos de Cocos	MCP no conectado o herramientas no habilitadas
La lista MCP no tiene cocos-creator (o el nombre de Configuración rápida)	Config no escrita, o se necesita Recargar
El nombre del servicio existe pero muestra error / desconectado	Creator no está en Ejecución, URL/puerto incorrectos, o se necesita recargar
Muestra conectado, pero no puede listar nodos de la escena abierta	Proyecto incorrecto, herramientas desmarcadas, o verificación de solo lectura incorrecta

Claude Code, Codex y clientes MCP similares siguen la misma idea: confirma que el cliente tiene una entrada de servicio saludable, luego revisa Creator.

Paso 1: Mira Solo el MCP Dentro de Cursor

Abre la configuración de MCP / herramientas de Cursor (las etiquetas del menú pueden variar según la versión) y verifica:

1. Si aparece cocos-creator (o el nombre escrito por la Configuración rápida de Creator)
2. Si el estado es conectado / utilizable—no atascado en error, desconectado o en blanco
3. Si acabas de cambiar la configuración o ejecutaste Configuración automática en Creator: haz una Recarga de Ventana (o equivalente de recarga MCP), luego revisa la lista de nuevo

Un caso común: Creator ya muestra En ejecución, pero Cursor aún tiene una configuración obsoleta—sin recargar, se siente “repentinamente roto”.

Paso 2: Confirma que la URL Apunta al Creator Local

La entrada MCP de Cursor debe apuntar a una URL de puente local, usualmente:

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

Usa el puerto que se muestra en el panel MCP de Creator (a menudo 3000 por defecto; si lo cambiaste, hazlo coincidir con el panel).

También abre Cocos Creator y confirma que el panel MCP está En ejecución para el mismo proyecto. Si el panel no está en ejecución, Recargar en Cursor no expondrá mágicamente las herramientas.

Páginas de producto (elige el paquete para tu versión principal; no mezcles):

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

Paso 3: Si Aún Falla, Salta por Capa

La ruta MCP tiene cuatro capas. Una falla en cualquier capa puede parecer “Cursor está roto / no conecta”:

1. Plugin en el proyecto y habilitado
        ↓
2. Panel activado (cuenta / código de licencia)
        ↓
3. Servidor MCP muestra En ejecución (localhost)
        ↓
4. Cursor tiene configuración escrita y la lista MCP muestra conectado

Lo que ves en Cursor	Ve aquí primero
Sin entrada de servicio en absoluto	Capa 4: vuelve a Creator → Configuración rápida → Configuración automática, luego Recargar; detalles en la guía general
La entrada existe pero error / no puede conectar	Capa 3: ¿Está Creator en Ejecución, coincide el puerto, está bloqueado localhost?
Sin menú MCP dentro de Creator	Capa 1: mezcla de paquetes 2.x/3.x, ruta de importación, reinicio (síntoma A de la guía general)
El panel no puede iniciar / no activado	Capa 2: cuenta y activación (guía general)
Conectado pero no puede listar nodos	Confirma que el proyecto correcto está abierto; ejecuta la prueba de solo lectura a continuación; luego verifica los interruptores de herramientas

Instalación completa:

• Instalación de Cocos Creator 3.x MCP
• Instalación de Cocos Creator 2.x MCP

Paso 4: Prueba de Humo (Confirma que Está Arreglado)

En Cursor, comienza con una verificación de solo lectura, por ejemplo:

Lista los nodos raíz de la escena actualmente abierta en Cocos Creator.

Si la respuesta coincide con la jerarquía del editor, el puente funciona. Opcionalmente, haz una escritura reversible (crea un nodo temporal y elimínalo). Haz commit antes de ediciones grandes; mantén el puente solo en localhost—no expongas el puerto MCP a Internet público.

Preguntas frecuentes

¿Qué significa normalmente que “Cursor esté roto” después de Cocos Creator MCP?
Señales típicas: sin entrada de servicio MCP, estado rojo/error, o conectado pero sin herramientas/nodos. La mayoría de los casos no son un fallo de Cursor—son una capa faltante en el puente de cuatro capas.

¿Debo revisar Cursor o Creator primero?
Empieza con la lista MCP de Cursor (faltante vs rojo). Luego verifica Creator: plugin importado/habilitado, panel activado, servidor en Ejecución, puerto que coincida con la configuración. Usa la tabla de síntomas en este artículo.

Conectado pero sin nodos—¿qué sigue?
Confirma que el proyecto/escena correcto esté abierto; ejecuta una prueba de solo lectura (lista de nodos raíz). Si aún falla, revisa los interruptores de herramientas y permisos. Ruta completa: solución de problemas de conexión.

¿Necesito reinstalar Cursor?
Normalmente no. Prefiere “configuración rápida → configuración automática” de Creator, recarga MCP y verifica el puerto localhost. Límite de categoría: Qué es Cocos Creator MCP.