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

Godot MCP

Godot MCP conecta Claude, Cursor, Copilot y otros agentes de IA al editor Godot. Instalación, configuración, herramientas, extensiones y CLI.

Actualizado el 4 de noviembre de 2026 Ver como Markdown

Godot MCP es el addon de Godot de AI Game Developer. Permite que un agente de IA como Claude Code, Cursor, GitHub Copilot, Codex o Gemini trabaje dentro del editor Godot: consultar y editar el árbol de escenas, abrir y guardar escenas .tscn, cambiar recursos .tres y ajustes del proyecto, leer y escribir archivos C# y GDScript, compilar el proyecto C#, ejecutar fragmentos de C# en el editor y tomar capturas de pantalla que el modelo puede examinar. Esta wiki explica cómo instalarlo, conectar un cliente de IA y usarlo día a día.

Qué es Godot MCP

Godot MCP es un addon de editor en C# (la carpeta addons/godot_mcp/, que aparece en Project Settings como Godot-MCP) que se ejecuta dentro de un proyecto de Godot 4 .NET. Cuando el editor lo carga, el addon abre un dock llamado AI Game Developer y se conecta a un servidor MCP. El agente de IA con el que conversas se conecta al mismo servidor y llama a las herramientas del addon a través del Model Context Protocol (MCP).

El addon es de código abierto (Apache-2.0) y vive en el repositorio Godot-MCP. Comparte sus librerías de MCP y de reflexión con Unity MCP y Unreal MCP, así que los tres plugins de motor se comportan igual y usan la misma cuenta en la nube.

Cómo encajan las piezas

PiezaQué hace
Addon Godot MCPSe ejecuta en el editor Godot, expone las herramientas de IA y se conecta a un servidor MCP.
Servidor MCPEl servidor en la nube en ai-game.dev (por defecto), o tu propio servidor ejecutándose en tu máquina.
Cliente de IAClaude Code, Cursor, VS Code Copilot, Codex, Gemini o cualquier otro cliente MCP. Se conecta al mismo servidor.
godot-cliLa herramienta de línea de comandos de npm que instala el addon, inicia sesión, escribe las configuraciones de los clientes de IA y abre el editor.
Aplicación AI Game DevLa aplicación de escritorio que puede instalar el addon y abrir el editor por ti, sin terminal.

En el modo Cloud predeterminado no se ejecuta nada en tu máquina salvo Godot y tu cliente de IA: tanto el editor como el agente se conectan al endpoint alojado, y tú inicias sesión una vez con tu cuenta de ai-game.dev. En el modo Custom, el addon puede descargar y arrancar un servidor MCP local por ti, de modo que todo se queda en tu ordenador.

Requisitos de un vistazo

  • La compilación .NET (mono) de Godot 4.3 o superior. La compilación estándar, solo para GDScript, no puede compilar el addon.
  • El SDK de .NET 8.
  • Un proyecto de Godot con un .csproj de C#. El código de tu propio juego puede seguir siendo GDScript; el addon necesita el proyecto de C# solo para compilarse a sí mismo.
  • Un cliente de IA que hable MCP.

La lista completa, incluidos los paquetes NuGet que necesita tu .csproj, está en Installation.

Inicio rápido

Si te manejas bien con una terminal, estos comandos llevan un proyecto de Godot con C# de cero a un agente de IA conectado:

npm install -g godot-cli
godot-cli install-plugin ./MyGodotProject
godot-cli login
godot-cli setup-mcp claude-code ./MyGodotProject
godot-cli open ./MyGodotProject

Después pídele a tu agente algo como «Añade una escena Node3D con una Camera3D y un cubo MeshInstance3D, y guárdala como Main.tscn». La página Getting started recorre los mismos pasos con explicaciones, y el quickstart del sitio cubre los tres motores.

Páginas de esta wiki

  • Installation: todas las vías de instalación (aplicación de escritorio, godot-cli, Asset Library, zip de la release) y los paquetes NuGet exactos.
  • Getting started: la primera conexión, los primeros prompts y cómo comprobar que todo funciona.
  • Connecting AI clients: endpoint en la nube frente a tu propio servidor, el inicio de sesión por dispositivo, las claves de proyecto y setup-mcp para cada agente.
  • Configuration: el dock de AI Game Developer, los ajustes guardados y las variables de entorno GODOT_MCP_*.
  • Tools: las familias de herramientas integradas, RQL y para qué sirve cada herramienta.
  • Custom tools: escribe tus propias herramientas MCP en C# y expón herramientas desde un juego en ejecución.
  • Extensions: paquetes opcionales para animación, CSG, navegación, tilemaps y addons populares de Godot.
  • godot-cli reference: todos los comandos de godot-cli y sus flags.
  • Troubleshooting: el addon no se carga, el agente no ve herramientas, problemas de recarga.
  • FAQ: respuestas breves a las preguntas habituales.

Más en el sitio