Esta página se tradujo automáticamente del inglés. Lee el original en inglés.

Primeros pasos

Conecta Godot MCP a la nube, configura un agente de IA como Claude Code, comprueba la conexión y ejecuta tus primeros prompts en el editor de Godot.

Actualizado el 4 de noviembre de 2026 Ver como Markdown

Esta página te lleva desde un addon instalado hasta un agente de IA que edita tu escena de Godot. Se asume que el addon ya está en tu proyecto; si no es así, empieza por Instalación. Los pasos usan el modo Cloud predeterminado, en el que tanto el editor como tu agente se conectan a ai-game.dev y solo tienes que iniciar sesión una vez.

Paso 1: abre el proyecto

Abre el proyecto con la CLI:

godot-cli open ./MyGodotProject

open compila primero el ensamblado de C# y después inicia el editor. La compilación importa en la primera apertura: Godot carga los addons habilitados de inmediato y, sin un ensamblado compilado, informa de que no puede cargar GodotMcpPlugin.cs y deshabilita el addon. Si en su lugar abres el proyecto desde el administrador de proyectos de Godot, compílalo una vez (el botón Build del editor o godot-cli build) y vuelve a habilitar el plugin si Godot lo desactivó.

Cuando se carga el addon, el panel Output del editor muestra [Godot-MCP] plugin loaded y el dock AI Game Developer aparece en la zona de docks superior derecha.

Paso 2: inicia sesión

El modo Cloud necesita tu cuenta de ai-game.dev. Elige una de estas opciones:

  • En el dock, deja el modo en Cloud y haz clic en Authorize. Se abrirá tu navegador con un código corto; apruébalo con tu cuenta de ai-game.dev.
  • Desde una terminal, ejecuta godot-cli login. Usa el mismo flujo de dispositivo OAuth y guarda la credencial en ~/.ai-game-dev/credentials.json, que el editor detecta por sí solo.

Inicias sesión una vez por máquina. La misma credencial sirve para Godot MCP, Unity MCP, Unreal MCP, las CLI de los motores y la app AI Game Dev. La sesión aparece en los dispositivos conectados de tu cuenta, donde puedes revocarla. Más detalles: Autenticación.

Paso 3: conecta tu agente de IA

Escribe la configuración de MCP para el agente que uses. Para Claude Code:

godot-cli setup-mcp claude-code ./MyGodotProject

Esto escribe .mcp.json en el proyecto con una URL fijada a este proyecto, de modo que el agente llega a este editor incluso cuando tienes varios editores abiertos. Puedes hacer lo mismo desde el dock: elige tu agente en la sección AI agent y haz clic en Configure. Otros agentes (Cursor, VS Code Copilot, Codex, Gemini y más) aparecen en Conectar clientes de IA.

Reinicia el agente, o recarga sus servidores MCP, después de escribir la configuración. Inicia el agente desde la carpeta del proyecto cuando la configuración esté allí (Claude Code lee .mcp.json desde la carpeta en la que se inicia).

Paso 4: comprueba la conexión

La sección Connection del dock muestra una línea de tres puntos: Godot, el servidor MCP y el agente de IA. Cuando el editor está conectado y hay una sesión de agente activa, los tres están encendidos y la fila del agente indica el nombre del cliente. Desde una terminal también puedes esperar a que el editor responda:

godot-cli wait-for-ready ./MyGodotProject
godot-cli status ./MyGodotProject

wait-for-ready consulta la sonda de disponibilidad (ping) hasta que responde, por defecto durante un máximo de dos minutos. status informa de si hay un editor en ejecución para el proyecto y de si el servidor responde.

En tu agente, pídele que enumere sus herramientas, o ejecuta /mcp en Claude Code. Deberías ver herramientas como rql-query, rql-mutate, script-create y screenshot-viewport.

Paso 5: primeros prompts

Prueba estos en el chat de tu agente. Cada uno se corresponde con herramientas reales, así que puedes ver cómo cambia la escena en el editor:

  • "Añade una escena Node3D con una Camera3D y un cubo MeshInstance3D, y guárdala como Main.tscn."
  • "Crea 3 cubos en un círculo de radio 2."
  • "Enumera todas las OmniLight3D de la escena con su energía."
  • "Crea un StandardMaterial3D para el suelo y pon su color de albedo en gris."
  • "Crea un script Player.cs con un float público Speed, adjúntalo al nodo Player y compila el proyecto."
  • "Añade una acción de entrada llamada jump en la tecla Espacio."
  • "Haz una captura del viewport y dime qué ves."

Las ediciones de escena que hace el agente se pueden deshacer: pulsa Ctrl+Z en el editor para retroceder, exactamente igual que con tus propias ediciones. Los cambios en la escena marcan la escena como no guardada, así que pide al agente que guarde o guarda tú mismo. Hay más ideas de prompts en Buenas prácticas para Godot.

Lo que el agente puede ver y lo que no

El agente trabaja a través de las herramientas que expone el addon. Puede leer el árbol de escena, las propiedades de Godot (incluidas las variables de GDScript), los recursos, los archivos, la configuración del proyecto, el mapa de entrada, los autoloads, la consola y el estado del editor mediante RQL, y puede examinar capturas de pantalla. No puede hacer clic en la interfaz del editor. La lista completa está en Herramientas y en el catálogo de herramientas de Godot.

¿Prefieres trabajar sin conexión?

Puedes ejecutar el servidor MCP en tu propia máquina en lugar de usar la nube. En el dock, cambia el modo a Custom y haz clic en Start Server: el addon descarga desde GitHub la compilación correspondiente del servidor, la inicia y se conecta a ella. Después, apunta tu agente a la URL local. Consulta Conectar clientes de IA.

Siguientes pasos

  • Configuración: el dock, el nivel de registro y qué herramientas ve el agente.
  • Extensiones: añade compatibilidad con AnimationPlayer, CSG, navegación, tilemap y addons.
  • Solución de problemas: si algún paso anterior no ha funcionado.