Conectar tu agente (MCP)
La app de Flockbay ejecuta un servidor MCP para el juego que tienes abierto. Actívalo en Connectors, copia la línea de configuración de tu agente, y Claude Code, Codex, Cursor o cualquier otro cliente MCP construye en ese juego con las herramientas de Flockbay.
Qué es
MCP es el Model Context Protocol, el estándar abierto que usan los agentes para llamar a herramientas. La app de Flockbay sirve un servidor MCP por stdio. Le da a tu agente las herramientas para trabajar en el juego que tienes abierto: escenas, nodos, scripts y recursos a través del editor de Godot, Play y el juego en ejecución, la biblioteca de assets, modelos 3D, control de versiones y plugins. La referencia de herramientas MCP lista todas las herramientas.
La app escribe la configuración para Claude Code, Cursor, Codex, Gemini CLI, Cline, Kilo Code, OpenCode, Goose, Devin Desktop y LM Studio, y para un modelo local con Ollama a través de uno de ellos. Cualquier otro cliente MCP que pueda iniciar un servidor stdio local funciona con el mismo comando.
Esto es lo contrario de construir con tu Claude o tu ChatGPT dentro de la app. Ahí, tu plan ejecuta el propio chat de Flockbay. Aquí, tu agente se queda donde está y entra en tu proyecto.
Activarlo
- Abre la app de Flockbay con un juego. La conexión necesita una cuenta de Flockbay, y la app crea una gratuita en el primer arranque.
- Abre Connectors y pulsa Set up en la fila Connect your agent (MCP). El menú del proyecto, en la parte superior del chat, también tiene Connect your agent (MCP)…
- Pulsa Turn on. El diálogo muestra “MCP server … · On · serving” y el nombre de tu juego.
- Elige tu agente en Your agent. El diálogo muestra su línea de configuración completa o su bloque de configuración: léelo, pulsa Copy y ponlo donde dice la línea de debajo.
- Inicia una sesión nueva en tu agente. Las herramientas de Flockbay aparecen en ella.
En Windows la línea ejecuta flockbay mcp, el comando que el instalador pone en tu PATH, así que es la misma en todos los equipos y sigue funcionando después de las actualizaciones. En un Mac o en Linux la línea lleva las rutas de esta instalación, así que cópiala del diálogo, no de una página web. La añades una vez; la app mantiene la conexión activa para el juego que abras después hasta que pulses Turn off.
La línea de configuración
En Windows, después de instalar Flockbay, ejecuta esto en una terminal nueva para Claude Code o Codex, o pulsa el botón para Cursor o VS Code. En un Mac o en Linux, copia en su lugar la línea del diálogo. Luego activa la conexión en la app, como arriba.
claude mcp add --scope user flockbay -- flockbay mcp
codex mcp add flockbay -- flockbay mcp
Dónde va la configuración de cada agente
Claude Code y Codex: un comando. Pégalo en una terminal. Registra el servidor para tu usuario, así que cada carpeta en la que inicies el agente lo tiene.
Cursor: un bloque JSON para ~/.cursor/mcp.json (en Windows, %USERPROFILE%\.cursor\mcp.json), o pulsa Add to Cursor. Gemini CLI: ~/.gemini/settings.json. Cline: MCP Servers, luego Configure, luego Configure MCP Servers, y añádelo a ese archivo. Devin Desktop: ~/.codeium/windsurf/mcp_config.json (en Windows, %USERPROFILE%\.codeium\windsurf\mcp_config.json). LM Studio: Program, luego Install, luego Edit mcp.json, o pulsa Add to LM Studio.
Kilo Code: ~/.config/kilo/kilo.jsonc, o kilo.jsonc en la carpeta de tu proyecto. OpenCode: opencode.json en la carpeta de tu proyecto, o ~/.config/opencode/opencode.json. Goose: un bloque YAML para ~/.config/goose/config.yaml.
Ollama ejecuta el modelo, no el agente. Ejecuta tu modelo de Ollama en Goose, OpenCode o Cline, y usa la configuración de ese agente.
Comprobar la conexión
En Claude Code, el servidor aparece en /mcp dentro de una sesión, y en una terminal con claude mcp list. En Codex, codex mcp list lo lista. Los dos dicen si se conectó.
claude mcp list
codex mcp list
Skills y hooks
Debajo de la línea de configuración, el diálogo ofrece las skills de Flockbay para los agentes que leen skills, y dice qué escribe el botón antes de que lo pulses.
Para Claude Code, Install skills and hooks copia las skills de Flockbay en ~/.claude/skills y añade 3 hooks (SessionStart, PostToolUse, Stop) a ~/.claude/settings.json. Para Cursor copia las skills en ~/.cursor/skills y añade 2 hooks (sessionStart, stop) a ~/.cursor/hooks.json. Los hooks se ejecutan en cada sesión de ese agente en este equipo y no hacen nada fuera del juego que sirve Flockbay.
Para Codex y Goose, Install skills copia las skills de Flockbay en ~/.agents/skills.
Remove skills and hooks (Remove skills para Codex y Goose) quita lo que instaló Flockbay y dice cuántas skills y hooks quitó. Tus propias skills y hooks se quedan. Si el archivo de ajustes de tu agente no es JSON válido, Flockbay no cambia nada en él y lo dice.
A qué puede llegar tu agente
Un agente conectado recibe las herramientas de Flockbay para el juego que tienes abierto. Esas herramientas editan y borran los archivos del juego y ejecutan scripts en el juego, en el editor de Godot y en Blender en este equipo, sin preguntar, permita lo que permita el sandbox o el modo de permisos de tu propio agente.
Las herramientas que cambian escenas, scripts, recursos y señales funcionan a través del editor de Godot, así que necesitan el juego abierto ahí; las herramientas que miran dentro del juego en ejecución necesitan que se esté ejecutando. El trabajo que hace tu agente aparece en su propio chat en la app, llamado “Your agent”, con un paso por cada llamada a herramienta.
Tres reglas mientras trabaja tu agente
Flockbay nunca arranca el juego mientras lo usas. Si estás jugando, el juego no se reinicia: el chat te ofrece Play en su lugar, y a tu agente se le dice por qué. Mientras la propia IA de Flockbay tiene un turno en marcha en el juego, se le pide a tu agente que espere a que termine. Las capturas del juego y del editor nunca mueven tu pantalla, y una ejecución headless nunca abre una ventana.
Tus manos mandan. Si pulsas una tecla, haces clic o pulsas un botón del mando mientras tu agente está enviando entradas al juego, su entrada se detiene al instante, se suelta todo lo que tenía pulsado y se le dice que tomaste el control. Un juego en pausa, porque estás en otra pantalla o en el menú Esc, no recibe ninguna entrada suya.
Cada cambio en el editor es un Ctrl+Z. Cada cambio que tu agente hace a través del editor es un paso en el historial de deshacer de Godot, con el nombre de lo que hizo, como “Flockbay: Add Player”, y la escena se guarda después. Un archivo de escena o de recurso nuevo se queda en disco cuando se deshace su paso, y los ajustes del proyecto y las acciones de entrada los escribe la app, no el editor, así que Ctrl+Z no los revierte.
Si no se conecta
Tu agente solo lista flockbay_status: la app todavía no lo está sirviendo. La app tiene que estar abierta con un juego, y Connect your agent (MCP) activado. Las herramientas de Flockbay se añaden solas a la misma conexión en cuanto lo está; si no aparecen, inicia una sesión nueva en tu agente.
El diálogo dice “The connection couldn’t start on this computer:” en rojo, con el motivo: la app ejecutó ella misma la línea de configuración y el servidor no arrancó. La línea se queda en el diálogo para que veas qué falló. Pulsa Turn off, luego Turn on, e inicia una sesión nueva en tu agente.
Tu agente muestra el servidor como fallido, o las herramientas de Flockbay han desaparecido después de que la app se actualizara: vuelve a copiar la línea de configuración del diálogo y pégala, y quita la entrada fallida con el propio comando de tu agente, como claude mcp remove o codex mcp remove con el nombre que muestra mcp list.
“Flockbay’s skills have not downloaded yet”: desactiva Connect your agent (MCP) y vuelve a activarlo, y luego pulsa Install otra vez.
Si sigues atascado: Solución de problemas explica cómo enviar logs y dónde preguntar.
Lo que cuesta
Nada. Tu agente se ejecuta en tu máquina con tu propio modelo y tu propia suscripción, así que sus tokens se pagan a quien proporcione ese modelo. Algunas herramientas crean assets con las claves de Flockbay, como una hoja de concepto o un efecto de sonido, y cuentan contra tu uso alojado como un turno en el chat de Flockbay; la herramienta de modelos 3D solo funciona con tu propia clave de Tripo.
Desde la línea de comandos
La app acepta tres flags, para un agente o un script que quiere un juego sin nadie delante de la ventana: flockbay-desktop.exe --open-game <folder> --your-own-agent on en Windows, y los mismos flags en la app de Mac y en el AppImage de Linux. --open-game abre en el editor el juego de esa carpeta, y crea uno nuevo ahí cuando la carpeta está vacía o no existe (añade --2d para un juego 2D); un proyecto de Godot que ya esté ahí se añade a Flockbay. --your-own-agent on activa la conexión para ese juego, como Turn on, y el comando imprime la misma línea de configuración que muestra el diálogo. Con la app ya en ejecución, el comando le pasa las dos cosas. Ningún enlace puede hacer esto: solo funciona desde una línea de comandos en tu propia máquina.
La página sobre esto es desarrollo de juegos con MCP.
Descarga Flockbay
Flockbay es gratis para Windows, macOS y Linux. La app está en inglés; estas páginas explican en español lo que hace cada parte.
Flockbay es una app de escritorio para Windows, macOS y Linux. Regístrate y envía la descarga a tu equipo.
