Conecta Claude o Cursor a Cinevva (servidor MCP)

Cinevva incluye un servidor MCP alojado que permite a Claude, Claude Code, Cursor o cualquier cliente MCP crear tus juegos. La IA que ya utilizas se convierte en el cerebro: lee y edita directamente los archivos de tus juegos en nuestros servidores, sin necesidad de abrir una pestaña del navegador. Abre también tu juego en el creador de Cinevva y la sesión pasará a estar en vivo: la IA podrá importar recursos de nuestra biblioteca CC0, preparar esqueletos y animar modelos 3D, tomar capturas de pantalla, simular entradas para probar el juego en ejecución y actualizar la vista previa mientras cada cambio aparece en tu pantalla.

Qué necesitas

Una cuenta de Cinevva (la gratuita sirve; la preparación de esqueletos 3D consume créditos de tu saldo) y un cliente MCP que admita servidores remotos con OAuth. La URL del servidor es:

https://api.cinevva.com/create/mcp

Utiliza HTTP Streamable y se autentica mediante OAuth 2.0. Cuando te conectes, tu cliente abrirá una página de inicio de sesión de Cinevva en el navegador. Autorízalo una vez y el cliente permanecerá conectado.

Edita desde cualquier lugar. Inicia una sesión en vivo para observar y probar.

Para editar archivos solo necesitas la conexión. Las herramientas de archivos leen y escriben la copia oficial de tus juegos en nuestros servidores, por lo que tu asistente puede corregir un error o añadir una función aunque no haya ninguna pestaña de Cinevva abierta. Indica el juego que quieras (o deja que la IA elija entre tus juegos) y empieza a darle instrucciones.

Iniciar una sesión en vivo es una mejora, no un requisito. Abre el juego en cinevva.com/create, espera a que se cargue la vista previa y haz clic en Agente externo en la barra de herramientas del creador (el icono del enchufe, que también aparece en el menú «más» en pantallas pequeñas). El panel cambiará a «Agente en vivo» una vez conectado. Una sesión en vivo le da a la IA ojos y manos sobre el juego en ejecución: capturas de pantalla, registros de la consola, entradas simuladas, importación de recursos y preparación de esqueletos 3D. También muestra en tu pantalla cada edición en cuanto se aplica, tanto si se realizó desde esa pestaña como sin interfaz. El enlace en vivo permanecerá activado en futuras visitas hasta que hagas clic en «Detener sesión en vivo».

La herramienta list_live_sessions muestra qué está conectado y, cuando hay exactamente un juego abierto, este se selecciona automáticamente.

Configuración en Claude (claude.ai y aplicación de escritorio)

1. Abre Configuración, luego Conectores y elige «Añadir conector personalizado».
2. Ponle el nombre Cinevva y pega https://api.cinevva.com/create/mcp como URL. Comprueba que no haya caracteres adicionales; la URL debe terminar en /create/mcp.
3. Haz clic en Añadir y luego en Conectar. Inicia sesión con tu cuenta de Cinevva cuando se abra la página de autorización (la misma cuenta con la que has iniciado sesión en la pestaña del juego).
4. Pídele a Claude algo como «enumera los archivos de mi juego de Cinevva» para confirmar la conexión. Para hacer pruebas en vivo, abre tu juego en cinevva.com/create en otra pestaña y haz clic en Agente externo en la barra de herramientas.

Configuración en Claude Code

claude mcp add --transport http cinevva https://api.cinevva.com/create/mcp

Claude Code te guiará por el inicio de sesión mediante OAuth la primera vez que lo uses. Después, pídele que lea los archivos de tu juego o realice algún cambio. Funciona directamente desde el terminal sin necesidad de abrir una pestaña del navegador.

Configuración en Cursor

Añade lo siguiente a .cursor/mcp.json (para cada proyecto) o a ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "cinevva": {
      "url": "https://api.cinevva.com/create/mcp"
    }
  }
}

Cursor detecta el servidor, ejecuta el flujo de OAuth en tu navegador y muestra las herramientas en su configuración de MCP.

Qué hacen las herramientas

Grupo	Herramientas	¿Necesita una sesión en vivo?
Leer el juego	list_game_files, read_files, search_game_file	No, lee la copia del servidor de cualquiera de tus juegos
Editar el juego	edit_files, write_files, delete_files, rename_files	No, las ediciones se aplican en el servidor y se transmiten a cualquier pestaña abierta
Vista previa	game_ready	Actualiza la vista previa de una pestaña en vivo; de lo contrario, guarda los cambios sin interfaz
Observar el juego	read_console_logs, take_screenshot	Sí
Pruebas	execute_js, simulate_input, get_task_status	Sí
Recursos	search_assets, list_asset_packs, import_asset, search_fonts	Sí. Aproximadamente 7000 objetos, audios y HDRI CC0
Preparación de esqueletos 3D	rig_model, apply_animation	Sí, consume créditos
Documentación	list_library_docs, search_library_docs, read_library_docs, list_animations	Sí

La preparación de esqueletos cuesta los mismos créditos que en el Creador de Juegos de la aplicación. Todo lo demás es gratuito. El creador integrado en la aplicación también genera imágenes, música, efectos de sonido y skyboxes con IA; esas herramientas están disponibles en la propia aplicación de Cinevva y no forman parte del conector MCP.

Solución de problemas

El mensaje «No se encontró ningún servidor MCP en la URL proporcionada» durante la configuración suele indicar que la URL contiene un error tipográfico o un carácter adicional al final. Debe ser exactamente https://api.cinevva.com/create/mcp.

El mensaje «No hay ninguna sesión en vivo» solo procede de las herramientas de ejecución (capturas de pantalla, consola, entradas, recursos y preparación de esqueletos). Significa que ninguna pestaña del navegador tiene abierto ese juego con el enlace en vivo activado. Abre tu juego, haz clic en Agente externo en la barra de herramientas e inténtalo de nuevo. Las herramientas de archivos nunca lo necesitan: si no hay ninguna sesión, trabajan con cualquiera de tus juegos mediante gameId y enumeran tus juegos si no proporcionas uno.

Si las herramientas se bloquean con una conexión nueva, actualiza la pestaña del juego para que vuelva a conectarse y después llama a list_live_sessions.

Preguntas o problemas: [email protected].