Guía de instalación de Cocos Creator 3.x MCP: Importar extensión y conectar un IDE de IA

Qué cubre esta guía

Sigue estos cinco pasos para conectar Cocos Creator 3.x MCP (VberAI Pro) a un proyecto local de Creator para que Cursor (u otro IDE de IA compatible con MCP, la idea es la misma) pueda operar, previsualizar y depurar el editor, no solo editar scripts en disco.

Cuando termines, deberías poder:

• Importar y habilitar cocos-mcp-server a través del Administrador de extensiones
• Activar con una cuenta de VberAI o correo electrónico + código de activación
• Iniciar el servidor MCP de Cocos local (puerto predeterminado 3000)
• Usar Configuración rápida → Configuración automática para registrar el servidor en Cursor y confirmar la conexión

Página del producto: VberAI Cocos MCP 3.x

Este artículo usa Cursor como ejemplo. Claude Code, Windsurf, Cline y otros clientes MCP siguen un flujo similar.

Requisitos previos

Elemento	Notas
Cocos Creator	3.0+ (cualquier proyecto 3.x)
Paquete de plugin	Archivo Pro de Cocos Creator 3.x MCP del sitio oficial
Activación	Cuenta VberAI + contraseña, o correo electrónico + código de activación
IDE de IA	Se recomienda Cursor; otros clientes MCP también funcionan
Red local	El puente MCP suele ejecutarse en 127.0.0.1; no expongas el puerto públicamente

Paso 1: Descargar Cocos Creator 3.x MCP

Descarga la versión Pro del sitio de VberAI:

Página de descarga: https://www.vberai.com/game-engines/cocos?ch=CQZLC2FG

Flujo sugerido:

1. Abre la página y descarga Cocos MCP 3.x Pro con los permisos de tu cuenta
2. Guarda el archivo localmente; no es necesario descomprimirlo en el proyecto todavía (el siguiente paso importa el archivo)
3. Confirma que el proyecto sea Creator 3.0 o superior; no lo mezcles con el paquete 2.x

Las diferencias entre OSS y Pro y la facturación siguen el texto actual del sitio.

Paso 2: Importar la extensión

1. Abre tu proyecto de Cocos Creator 3.x
2. Menú: Extensión → Administrador de extensiones → Importar extensión
3. Selecciona el archivo Cocos Creator 3.x MCP que acabas de descargar
4. Después de una importación exitosa, la lista de extensiones debería mostrar cocos-mcp-server habilitado

Si aparece deshabilitado, habilítalo antes de continuar.

Paso 3: Activar cocos-mcp-server

1. Menú: Extensión → Cocos MCP Server → Abrir panel de MCP
2. En la pantalla de activación, usa cualquiera de las siguientes opciones:
   • Cuenta VberAI + contraseña
   • Correo electrónico + código de activación
3. Después de que la activación sea exitosa, abre la página de configuración del servidor MCP (siguiente paso)

Sin activación, el servidor generalmente no se iniciará. Confirma que tu plan o código coincida con la versión Pro actual.

Paso 4: Iniciar cocos-mcp-server

1. Después de la activación, abre Configuración del servidor MCP
2. Ajusta según sea necesario:
   • Puerto: predeterminado 3000
   • Idioma: elige el que prefieras para la interfaz
   • Inicio: usa las opciones del panel (por ejemplo, inicio automático con el editor, si está disponible)
3. Haz clic en Iniciar servicio
4. Cuando el panel muestre En ejecución, el servidor MCP de Cocos está activo

Ahora tienes un puente MCP local. A continuación, entrégaselo a tu IDE de IA.

Paso 5: Configuración del IDE de IA con un clic (ejemplo con Cursor)

1. Abre Administrador de herramientas
   • Revisa las herramientas expuestas por el servidor MCP de Cocos
   • Habilita solo las que quieras que la IA use
2. Abre Configuración rápida
   • Elige tu IDE (por ejemplo, Cursor)
   • Haz clic en Configuración automática
   • Confirma que la interfaz muestre un estado configurado
3. Abre Cursor
   • En la lista de MCP / herramientas deberías ver cocos-creator (o el nombre que se muestre en el panel) conectado
   • Si falta, haz clic en Recargar (o el equivalente de recarga de MCP) en Cursor y verifica nuevamente

Otros IDE siguen el mismo camino: solo elige un cliente diferente en Configuración rápida.

Verificación rápida después de conectar

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

Enumera 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. Luego intenta una pequeña escritura (crea un nodo temporal y elimínalo) para confirmar permisos y selección de herramientas.

Preguntas frecuentes

¿Falló la importación o falta cocos-mcp-server en la lista? Usa el archivo oficial 3.x (no 2.x). Creator debe ser 3.0+. Si permanece deshabilitado, habilítalo en el Administrador de extensiones y reinicia Creator.

¿La activación falla constantemente? Confirma los derechos de Pro, o que el código de activación sea válido y esté vinculado al correo correcto. Revisa el centro de cuentas en el sitio y vuelve a intentarlo en el panel.

Hice clic en Iniciar servicio pero nunca veo En ejecución? Confirma que el puerto 3000 (o tu puerto personalizado) esté libre y que localhost no esté bloqueado. Asegúrate de que el Paso 3 se completó correctamente.

¿Cursor no muestra cocos-creator? En Creator, confirma que el servidor siga en ejecución, ejecuta Configuración rápida → Configuración automática nuevamente y luego recarga MCP en Cursor. Si aún falla, verifica que la configuración de MCP de Cursor incluya la dirección del puente local.

Próximos pasos

• Usa lenguaje natural para una consulta de escena o una pequeña edición para aprender los límites de las herramientas
• Haz commit antes de cambios grandes; mantén el puente solo en localhost
• Para UI de diseño a motor, combínalo con VberAI Studio y luego itera en el editor con MCP

Para Creator 2.x, sigue la guía de instalación de Cocos Creator 2.x MCP; no mezcles paquetes. Para aclarar límites de capacidad y la diferencia con el vago “Cocos Creator AI”, consulta Qué es Cocos Creator MCP. Para más contexto sobre MCP, consulta la guía de video de Cocos Creator MCP.