Godot MCP: conecta Claude Code, Codex o Cursor a tu juego de Godot

Godot MCP deja que el agente lo averigüe por sí mismo

Pídele a Claude Code que arregle un salto que se siente flotante y, por sí solo, hace la mitad del trabajo. Abre el script del jugador, baja la gravedad y te deja el resto a ti: pulsas Play, saltas, describes qué salió mal, le pegas el error. Cada ida y vuelta pasa por tus manos.

Un servidor MCP de Godot elimina la ida y vuelta. El agente pulsa Play él mismo, mantiene la acción de salto un tercio de segundo, captura el viewport en lo alto del arco, lee el stdout y los errores de Godot, y vuelve a cambiar el script antes de que tú hayas mirado nada.

MCP, el Model Context Protocol, es la fontanería. Es un estándar abierto: un servidor ofrece herramientas, y un cliente como Claude Code, Codex o Cursor las descubre y las llama. El protocolo es la mitad fácil. Lo que importa es qué herramientas entrega un servidor, y si el agente puede comprobar su propio trabajo con ellas. La comparativa de servidores MCP para Godot compara una docena; esta página es la configuración y la referencia del de Flockbay.

Conectar Flockbay a tu agente es pegar una línea

Flockbay es un creador de juegos con IA gratuito construido sobre Godot: una app de escritorio con el motor oficial Godot 4.7.2 dentro, no un fork. Su servidor MCP vive en la app, así que no hay nada que instalar desde npm ni ningún plugin que copiar en tu proyecto. En Windows, los pasos son estos.

Inicia sesión en la app de Flockbay. La conexión necesita una cuenta gratuita de Flockbay y nada más. Luego abre tu juego; el editor de Godot se abre con él.

Abre Connectors desde el menú de Flockbay, pulsa Set up en la fila Another agent (MCP) y pulsa Turn on.

Elige tu agente y pulsa Copy. Para Claude Code y Codex es un comando para una terminal. Para los demás es un bloque para el archivo de configuración que indica el diálogo, y Cursor y LM Studio también tienen un botón que lo añade por ti.

La línea lleva tres rutas que pertenecen a tu máquina: el runtime de Node que viene dentro de Flockbay, el script que sirve las herramientas y un pequeño archivo que le dice al servidor a qué app en ejecución conectarse. Por eso la escribe la app y no esta página. Los bloques de abajo muestran la forma, con esas tres rutas como marcadores. Las rutas no cambian de una sesión a otra, así que pegas una vez.

La app también ejecuta la línea ella misma. Si no puede arrancar en tu máquina, el diálogo lo dice en rojo encima, con las propias palabras del servidor, en lugar de dejar que falle más tarde dentro de tu agente. Para Claude Code y Cursor, el mismo diálogo puede instalar las skills y hooks de Flockbay, y para Codex y Goose sus skills: las instrucciones que enseñan al agente a construir con estas herramientas.

Godot MCP en Claude Code

Pega la línea en cualquier terminal. Registra el servidor como flockbay-stage con --scope user, así que está ahí sea cual sea la carpeta en la que arranques Claude Code. El scope por defecto de Claude Code es solo la carpeta actual, y así es como una conexión desaparece sin avisar cuando pegas en una carpeta y trabajas en otra.

Compruébalo con claude mcp list en una terminal, o escribe /mcp dentro de una sesión. Luego pregúntale a Claude Code si Flockbay está conectado: la primera herramienta que ve responde con lo que hay que hacer a continuación. Más sobre el flujo de trabajo: hacer juegos desde Claude Code.

Godot MCP en Codex

Pega la línea en una terminal. Codex la guarda en su config.toml, por defecto ~/.codex/config.toml, así que todas las sesiones siguientes la ven.

Compruébalo con codex mcp list, o escribe /mcp en la terminal de Codex. Más sobre el flujo de trabajo: hacer juegos en Codex.

Godot MCP en Cursor, Gemini CLI, Cline, Devin Desktop y LM Studio

Estos cinco leen la misma forma de JSON: una entrada mcpServers con un comando, sus argumentos y una variable de entorno.

Cursor: añádelo a ~/.cursor/mcp.json (en Windows, %USERPROFILE%\.cursor\mcp.json), o pulsa Add to Cursor en el diálogo de Flockbay. Gemini CLI: ~/.gemini/settings.json. Cline: MCP Servers, luego Configure, luego Configure MCP Servers, y añádelo a ese archivo. Devin Desktop es Windsurf con otro nombre y mantiene el archivo de Windsurf, %USERPROFILE%\.codeium\windsurf\mcp_config.json. LM Studio: Program, luego Install, luego Edit mcp.json, o pulsa Add to LM Studio.

Si Cursor ya es tu editor, Cursor para Godot explica cómo encaja junto al editor de Godot.

Godot MCP en OpenCode y Kilo Code

Estos dos leen una clave mcp con el comando como un único array. OpenCode: opencode.json en la carpeta de tu juego, o ~/.config/opencode/opencode.json. Kilo Code: ~/.config/kilo/kilo.jsonc, o kilo.jsonc en la carpeta de tu juego.

Godot MCP en Goose, y con un modelo local

Goose lee YAML bajo extensions, en ~/.config/goose/config.yaml.

Ollama ejecuta un modelo, no un agente, así que aquí no tiene configuración propia. Ejecuta tu modelo de Ollama dentro de Goose, OpenCode o Cline y usa el bloque de ese agente. Las herramientas son las mismas; lo bien que las use un modelo pequeño depende del modelo.

Godot MCP a través de Flockbay llega al editor, al juego y al mundo

A través del editor de Godot abierto, tu agente puede abrir y crear escenas; añadir, borrar, renombrar, mover y duplicar nodos; leer y asignar sus propiedades; escribir scripts y adjuntarlos; crear y cambiar recursos como materiales y formas de colisión; y conectar señales. Cada cambio es un paso en el propio historial de deshacer de Godot, con el nombre de lo que hizo, como «Flockbay: Add Player», y la escena se guarda después. Pulsa Ctrl+Z y desaparece, como un cambio tuyo.

Puede leer los ajustes del proyecto, los archivos, los autoloads y las acciones de entrada, y cambiar los ajustes y las acciones de entrada. Esos dos los escribe la app y no el editor, así que Ctrl+Z no los revierte; tu agente vuelve a poner el valor anterior.

Puede ejecutar el juego en la pantalla Game y leer su stdout, con el archivo, la línea y la pila de llamadas de cada error y advertencia, o hacer una ejecución headless de unos segundos de tiempo de juego. Cuando un script no se puede analizar, recibe el propio error de análisis de GDScript de Godot y la línea sin ejecutar nada.

Puede capturar el viewport del juego en ejecución tal como lo ve el jugador, incluso con la pantalla Game oculta, y el viewport 3D o 2D del editor. Puede inyectar eventos de entrada temporizados en el juego: teclas, clics y movimiento del ratón, acciones del InputMap y texto escrito, terminando con una captura del viewport. Y puede leer el árbol de escenas en vivo del juego en ejecución, con posiciones, tamaños, visibilidad y velocidad, y cambiar un nodo para probar algo; ese cambio dura hasta que el juego se detiene y no guarda nada.

Además de Godot, obtiene las herramientas de mundo de Flockbay, la parte que no tienen otros servidores MCP de Godot: terreno, de un lugar real o de una isla inventada en un mundo 3D, o colocado como tiles en uno 2D; un océano que el terreno recorta; el cielo y la iluminación; lluvia o nieve a lo largo del tiempo; el controlador del jugador, su movimiento y el seguimiento de cámara; y props, colocados como instancias de escena en posiciones exactas. Son seis en un mundo 3D y cuatro en uno 2D, que no tiene agua ni clima.

También puede buscar en la biblioteca de Flockbay de modelos, texturas y sonidos ya hechos y traer uno al juego, y generar un modelo 3D, una imagen o un sonido con tu propia clave de Tripo o ElevenLabs.

Godot MCP a través de Flockbay hace playtest del juego, y dónde se detiene

Aquí, hacer playtest significa que el bucle del agente se cierra sobre el juego en ejecución, no sobre el código. Valida cada archivo GDScript sin ejecutarlo, inicia un Play o una ejecución headless, inyecta una secuencia temporizada de eventos de entrada (teclas, ratón, acciones del InputMap, hasta 200 pasos), captura el viewport del juego y lee el árbol de escenas en vivo, el stdout y los errores del depurador con archivo, línea y pila. Luego cambia el código y vuelve a jugar. La propia IA de Flockbay hace ese bucle de comprobar, jugar, leer y corregir por sí sola; tu propio agente obtiene las mismas llamadas a herramientas por MCP, gratis.

Lo que no hace: jugar un juego entero hasta un objetivo, devolver un veredicto de aprobado o suspenso, mantener una suite de regresión, grabar vídeo, abrir reportes de bugs, ejecutar instancias en paralelo o juzgar el balance y el game feel. Los playtesters humanos siguen decidiendo si el juego es divertido.

Tres reglas evitan que tu agente pisotee tu trabajo

Flockbay nunca arranca el juego a tus espaldas. Si has usado el builder, los botones alrededor de la vista 3D y 2D del editor, desde que tu agente pulsó Play por última vez, el juego no arranca: el chat te ofrece Play a ti, y a tu agente se le dice por qué.

Tus manos mandan. Pulsa una tecla, haz clic o pulsa un botón del mando mientras tu agente está enviando entrada, y su entrada se detiene al instante, todo lo que mantenía pulsado se suelta y se le dice que has tomado el control. Un juego en pausa no recibe ninguna entrada suya, y tu ratón y tu teclado reales nunca se mueven.

Algunos archivos son de la app. Tu agente no puede escribir project.godot, los archivos que Flockbay genera para el mundo ni los add-ons que instala, y cuando lo intenta se le dice qué herramienta usar en su lugar. Su trabajo aparece en su propio chat en Flockbay, llamado «Your agent», así que nunca se mezcla con una conversación que tuviste con la propia IA de Flockbay.

Lo que Godot MCP a través de Flockbay no puede hacer

Hoy solo funciona en Windows. La versión para Mac llega más adelante, y no hay versión para Linux.

La app tiene que estar abierta con tu juego. Las herramientas de edición necesitan el editor de Godot abierto sobre él, que Flockbay abre con el juego, y las herramientas que miran dentro del juego necesitan que esté en ejecución. Tu agente puede conectarse antes de que la app esté abierta: se le dice que abra Flockbay, y recibe las herramientas en cuanto la app está lista, sin reiniciar.

Necesita una cuenta gratuita de Flockbay y conexión a internet, y Flockbay es de código cerrado. Si quieres un servidor que puedas leer línea a línea, los de código abierto de la tabla de abajo son la opción honesta.

Funciona con Godot 4.7.2, el motor que hay dentro de la app, no con un Godot que hayas instalado tú. Los juegos hechos en Flockbay lo tienen todo. Un proyecto existente de Godot 4 abierto en Flockbay se puede jugar, y tu agente puede editarlo y ejecutarlo. Los botones del builder, y las herramientas de mundo que hay detrás, funcionan sobre un mundo de Flockbay, y a tu agente se le dice que pregunte antes de que su primera herramienta de mundo convierta el proyecto en uno.

Godot MCP se gana el sueldo en tareas que incluyen una comprobación

Dale al agente algo que pueda verificar. «Ejecuta el juego, encuentra el primer error, corrígelo y vuelve a ejecutarlo hasta que el log esté limpio.» «Mantén pulsada la D dos segundos y luego captura el viewport: ¿llega el jugador a la cornisa?» «Lista cada nodo bajo el jugador en el juego en ejecución con su velocidad, y luego dime por qué se desliza cuando suelto.»

Pequeño y comprobable gana a grande y esperanzado. Un agente que puede jugar el juego confirmará encantado que el juego funciona. Si es divertido sigue siendo decisión tuya, y ningún servidor cambia eso.

Haz commit en el control de versiones antes de una sesión larga. Cada cambio en el editor es un Ctrl+Z, pero un archivo de escena o de recurso que crea el agente se queda en disco cuando se deshace su paso.

Solución de problemas de Godot MCP

Tu agente ve una sola herramienta, y dice que Flockbay no está sirviendo. Abre la app de Flockbay con tu juego y activa Another agent en Connectors. El resto de herramientas aparecen solas; no hace falta reiniciar el agente.

Claude Code no muestra flockbay-stage. Ejecuta claude mcp list. Si falta, copia de nuevo la línea desde Flockbay y pégala; la línea lo registra para tu usuario, no para una carpeta.

El diálogo muestra una frase en rojo que dice que la conexión no pudo arrancar en esta máquina. La app ejecutó la línea ella misma y falló. Esa frase es la causa con las propias palabras del servidor, así que guárdala para un reporte de bug.

Al agente se le dice que no hay ningún editor de Godot abierto con este juego. Abre el juego en Flockbay. Hasta entonces tu agente puede seguir editando los archivos directamente y hacer una ejecución headless para ver sus errores.

Al agente se le dice que el juego no está en ejecución. Lo arranca con Play; las herramientas que miran el juego necesitan una ejecución.

Play se rechaza porque estabas construyendo. Usaste el builder desde que tu agente pulsó Play por última vez. Pulsa Play en el chat cuando estés listo.

Una escritura se rechaza por ser de Flockbay. El agente intentó tocar un archivo que gestiona la app, como project.godot. El rechazo indica la herramienta que hay que usar en su lugar: las herramientas de ajustes para los ajustes del proyecto, las herramientas de mundo para el mundo.

Al activarlo te pide que inicies sesión. La conexión necesita una cuenta gratuita de Flockbay. Inicia sesión y vuelve a activarlo.

Cuándo otro servidor MCP para Godot es mejor opción

Lo quieres gratis y abierto, en el Godot que ya tienes: godot-ai. Tiene licencia MIT, funciona en tu propio editor de Godot 4.7, y saca capturas y envía entrada temporizada, cosa que el godot-mcp más antiguo no hace.

Quieres lo más pequeño que ejecute tu juego y lea sus errores: el godot-mcp de Coding-Solo. Un solo comando npx, licencia MIT, 5869 estrellas en GitHub el 29 sep 2026, y una lista corta de herramientas en la que un agente no se pierde. Su última versión en npm, la 0.1.1, salió en febrero de 2026.

Quieres un plugin de pago con una configuración pulida en Godot 4.2 o posterior, en Windows, macOS o Linux: GDAI MCP, por $19 en un solo pago.

Quieres la lista de herramientas más larga, de árboles de animación y partículas a shaders y navegación: Godot MCP Pro, por $15 en un solo pago, en Godot 4.4 o posterior. Esa amplitud también es su riesgo, porque los modelos eligen peor en listas de herramientas largas; su panel del editor te deja desactivar herramientas una a una.

Flockbay es la opción cuando quieres a tu agente y a la propia IA de Flockbay trabajando en el mismo juego, con herramientas de mundo para terreno, agua, cielo y clima, un builder en el editor para lo que prefieras arrastrar antes que describir, y generación con tus propias claves. También es el único de aquí que hoy funciona solo en Windows, necesita una cuenta y es de código cerrado.

Preguntas frecuentes

¿Qué es Godot MCP?

Un servidor Model Context Protocol para Godot. Convierte acciones de Godot, como editar una escena, ejecutar el juego o sacarle una captura, en herramientas que un agente de IA como Claude Code, Codex o Cursor puede llamar, para que el agente compruebe su propio trabajo en lugar de preguntarte qué ha pasado.

¿Hay un servidor MCP oficial de Godot?

No. Las notas de la versión de Godot 4.7 no incluyen funciones de IA ni un servidor MCP. Todos los servidores MCP para Godot, incluido el de Flockbay, los hace alguien ajeno al proyecto Godot.

¿El servidor MCP para Godot de Flockbay es gratis?

Sí. Conectar tu propio agente es gratis con una cuenta gratuita de Flockbay. El modelo de tu agente lo pagas donde ya lo pagas, como tu plan de Claude o de ChatGPT; Flockbay no cobra nada por la conexión.

¿Con qué agentes funciona?

La app escribe la configuración para Claude Code, Codex, Cursor, Gemini CLI, Cline, Kilo Code, OpenCode, Goose, Devin Desktop y LM Studio, y para un modelo local de Ollama a través de uno de ellos. Cualquier cliente MCP que pueda arrancar un servidor local debería funcionar.

¿Funciona en Mac o Linux?

Todavía no. Flockbay funciona hoy en Windows, y la versión para Mac llega más adelante. No hay versión para Linux.

¿Necesito tener Godot instalado?

No. Flockbay incluye el Godot 4.7.2 oficial, y tu juego es un proyecto normal de Godot 4 en una carpeta que también puedes abrir tú en Godot.

¿Puedo deshacer lo que hizo mi agente?

Sí, en el editor. Cada cambio es un paso en el historial de deshacer de Godot, así que Ctrl+Z lo revierte. Los ajustes del proyecto y las acciones de entrada son la excepción: los escribe la app, y el agente restaura el valor anterior en su lugar.

¿Puede mi agente ver mi pantalla o mover mi ratón?

No. Saca capturas del juego y de la vista del editor, no de tu escritorio, y la entrada que envía va solo al juego. Tu ratón y tu teclado reales no se tocan.

¿Puedo usarlo en un proyecto de Godot que ya tengo?

Sí. Ábrelo en Flockbay con Open existing project: Flockbay pregunta antes de añadir nada, se puede jugar, y tu agente puede editarlo y ejecutarlo a través del editor. Los botones del builder y las herramientas de mundo funcionan sobre un mundo de Flockbay, y tu agente pregunta antes de que su primera herramienta de mundo convierta el proyecto en uno. Haz commit en el control de versiones primero; lo que Flockbay añade queda registrado en el proyecto, y al exportar, su add-on queda fuera del juego que publicas.

¿El servidor MCP de Flockbay es de código abierto?

No. Flockbay es de código cerrado. Entre los servidores MCP de código abierto para Godot, el godot-mcp de Coding-Solo y godot-ai son los que tienen más estrellas en GitHub, y los dos tienen licencia MIT.

Descarga Flockbay

Gratis para Windows. Conectar tu propio agente por MCP es gratis.

Descarga Flockbay gratis

Sigue leyendo

• Claude o ChatGPT con Godot
• Conecta tu propio agente: todas las herramientas
• El mejor servidor MCP para Godot
• Hacer juegos desde Claude Code
• Hacer juegos en Codex
• Cursor para Godot
• IA para Godot