# Godot MCP — AI Game Developer Wiki

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

Esta página se tradujo automáticamente del inglés. [Lee el original en inglés](https://ai-game.dev/docs/wiki/godot).

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](https://github.com/IvanMurzak/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

| Pieza | Qué hace |
| --- | --- |
| Addon Godot MCP | Se ejecuta en el editor Godot, expone las herramientas de IA y se conecta a un servidor MCP. |
| Servidor MCP | El servidor en la nube en [ai-game.dev](https://ai-game.dev) (por defecto), o tu propio servidor ejecutándose en tu máquina. |
| Cliente de IA | Claude Code, Cursor, VS Code Copilot, Codex, Gemini o cualquier otro cliente MCP. Se conecta al mismo servidor. |
| `godot-cli` | La 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 Dev | La 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](https://ai-game.dev/es/docs/wiki/godot/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:

```bash
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](https://ai-game.dev/es/docs/wiki/godot/getting-started) recorre los mismos pasos con explicaciones, y el [quickstart](https://ai-game.dev/es/docs/quickstart) del sitio cubre los tres motores.

## Páginas de esta wiki

- [Installation](https://ai-game.dev/es/docs/wiki/godot/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](https://ai-game.dev/es/docs/wiki/godot/getting-started): la primera conexión, los primeros prompts y cómo comprobar que todo funciona.
- [Connecting AI clients](https://ai-game.dev/es/docs/wiki/godot/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](https://ai-game.dev/es/docs/wiki/godot/configuration): el dock de AI Game Developer, los ajustes guardados y las variables de entorno `GODOT_MCP_*`.
- [Tools](https://ai-game.dev/es/docs/wiki/godot/tools): las familias de herramientas integradas, RQL y para qué sirve cada herramienta.
- [Custom tools](https://ai-game.dev/es/docs/wiki/godot/custom-tools): escribe tus propias herramientas MCP en C# y expón herramientas desde un juego en ejecución.
- [Extensions](https://ai-game.dev/es/docs/wiki/godot/extensions): paquetes opcionales para animación, CSG, navegación, tilemaps y addons populares de Godot.
- [godot-cli reference](https://ai-game.dev/es/docs/wiki/godot/cli): todos los comandos de `godot-cli` y sus flags.
- [Troubleshooting](https://ai-game.dev/es/docs/wiki/godot/troubleshooting): el addon no se carga, el agente no ve herramientas, problemas de recarga.
- [FAQ](https://ai-game.dev/es/docs/wiki/godot/faq): respuestas breves a las preguntas habituales.

## Más en el sitio

- [Install Godot MCP](https://ai-game.dev/es/engines/godot): la página de instalación de Godot.
- [Godot tools catalog](https://ai-game.dev/docs/tools/godot) y [Godot extensions](https://ai-game.dev/docs/extensions/godot).
- [Buenas prácticas para Godot](https://ai-game.dev/docs/best-practices/godot): cómo escribir prompts que funcionen bien.
- [Endpoint de MCP](https://ai-game.dev/es/mcp-endpoint-info) y [autenticación](https://ai-game.dev/docs/auth): el endpoint alojado y cómo funciona el inicio de sesión.
- La [wiki de la app AI Game Dev](https://ai-game.dev/es/docs/wiki/app), y las wikis de [Unity MCP](https://ai-game.dev/es/docs/wiki/unity) y [Unreal MCP](https://ai-game.dev/es/docs/wiki/unreal).

- [**Instalación** Instala el addon Godot MCP con la app AI Game Dev, godot-cli, la Asset Library o un zip, con los paquetes NuGet exactos para tu .csproj.](https://ai-game.dev/es/docs/wiki/godot/installation)
- [**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.](https://ai-game.dev/es/docs/wiki/godot/getting-started)
- [**Conectar clientes de IA** Conecta Claude Code, Cursor, Copilot, Codex, Gemini y otros clientes MCP a Godot MCP vía el endpoint en la nube de ai-game.dev o tu servidor local.](https://ai-game.dev/es/docs/wiki/godot/connecting-ai-clients)
- [**Configuración** Configura Godot MCP en el dock de AI Game Developer, elige qué herramientas ven los agentes de IA y sobrescribe ajustes con variables de entorno GODOT\_MCP\_\*.](https://ai-game.dev/es/docs/wiki/godot/configuration)
- [**Herramientas** Herramientas MCP de Godot para agentes de IA: consultas RQL de nodos, escenas y recursos, scripts de C# y GDScript, capturas y herramientas en juego.](https://ai-game.dev/es/docs/wiki/godot/tools)
- [**Herramientas personalizadas** Escribe tus propias herramientas MCP de Godot en C#, ejecuta la API de Godot en el hilo principal y expón herramientas y recursos desde un juego en ejecución.](https://ai-game.dev/es/docs/wiki/godot/custom-tools)
- [**Extensiones** Extensiones MCP opcionales de Godot: animación, CSG, GridMap, navegación, partículas, TileMapLayer, Beehave, Dialogic, Phantom Camera y Terrain3D.](https://ai-game.dev/es/docs/wiki/godot/extensions)
- [**Referencia de godot-cli** Todos los comandos y flags de godot-cli para Godot MCP, desde install-plugin, login y setup-mcp hasta open, exec, run-tool, configure e install-extension.](https://ai-game.dev/es/docs/wiki/godot/cli)
- [**Solución de problemas** Resuelve problemas comunes de Godot MCP: addon que no carga, lista Extensions vacía, herramientas ausentes, errores de recarga y fallos de .NET 10.](https://ai-game.dev/es/docs/wiki/godot/troubleshooting)
- [**FAQ** Respuestas breves sobre Godot MCP, el asistente de IA para el editor de Godot: versiones, GDScript, uso local, coste, seguridad y exportación.](https://ai-game.dev/es/docs/wiki/godot/faq)

---

Source (HTML): https://ai-game.dev/es/docs/wiki/godot

Machine-translated (es) from the English page: https://ai-game.dev/docs/wiki/godot