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

Motores · Godot

GodotDisponible

Añade el complemento godot_mcp a tu proyecto de Godot con C# y controla el editor con IA.

Godot 4.3–4.5C# / .NET 8 (mono)
01

Instala el plugin

Dos formas de añadir el plugin a tu proyecto: elige la que mejor encaje con tu flujo de trabajo.

Recomendado

CLI

Instálalo mediante la herramienta godot-cli de npm. install-plugin descarga el complemento godot_mcp desde la versión correspondiente de GitHub, añade los dos paquetes NuGet y el catálogo de extensiones incrustado a tu .csproj, y habilita el plugin de forma idempotente.

1Instala la CLI

Instala godot-cli globalmente desde npm.

npm install -g godot-cli
2Instala el plugin

Descarga el complemento, añade los paquetes NuGet a tu .csproj y habilita godot_mcp en project.godot.

godot-cli install-plugin ./MyGodotProject
3Conecta tu cliente de IA

Genera la configuración de MCP para tu cliente (p. ej., Claude Code).

godot-cli setup-mcp claude-code ./MyGodotProject
4Abre y espera

Abre el proyecto y espera hasta que el editor esté listo.

godot-cli open ./MyGodotProject

Después de abrir, también puedes hacer que los scripts esperen a que el editor esté listo: godot-cli wait-for-ready ./MyGodotProject.

Biblioteca de recursos

Instala el complemento godot_mcp desde la Biblioteca de recursos de Godot (o el mismo zip desde GitHub Releases), luego añade los dos paquetes NuGet y habilita el plugin.

Ver en la Biblioteca de recursos
1Instala el complemento

Obtén godot_mcp desde la pestaña AssetLib de Godot, o descarga el zip desde la página GitHub Releases y colócalo en la carpeta addons/ de tu proyecto.

2Añade los paquetes NuGet

Añade ambos paquetes a tu proyecto .csproj: com.IvanMurzak.ReflectorNet versión 5.4.3 y com.IvanMurzak.McpPlugin versión 8.7.1, además del addons/godot_mcp/extensions.catalog.json EmbeddedResource (sin él, el panel de extensiones aparece vacío). El bloque exacto está en el README de Godot-MCP.

3Habilita el plugin

En el editor: Project → Project Settings → Plugins, luego habilita godot_mcp.

4Abre y compila

Vuelve a abrir el proyecto para que Godot compile la solución de C# con los nuevos paquetes.

02

Conectar

Ejecuta todo a través del punto de conexión en la nube alojado, o apunta a tu propio servidor.

Nube

Predeterminado

Conéctate a través de ai-game.dev con el flujo OAuth de código de dispositivo: no tienes que copiar tokens a mano. En la ventana de AI Game Developer, elige Cloud, haz clic en Authorize y aprueba el código de dispositivo en tu navegador. Funciona a través de firewalls y te ofrece analíticas de uso. Es la opción predeterminada y la que recomendamos para la mayoría de los usuarios.

Personalizado

¿Prefieres ejecutarlo todo en local? Apunta el plugin a tu propia instancia de gamedev-mcp-server en lugar del punto de conexión alojado. Así, tu cliente de IA se comunica directamente con tu máquina. Encontrarás fragmentos de configuración para cada cliente en la página del punto de conexión MCP.

¿Necesitas fragmentos de configuración para clientes (Claude, Cursor, Copilot, Gemini y más)? Consulta la página del punto de conexión MCP →

03

Configura tu agente de IA

Elige el agente de IA que uses y copia el comando godot-cli exacto que lo conecta con el servidor MCP de Godot.

Tu agente de IA

Ejecuta esto en tu proyecto para configurar Claude Code para Godot:

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

Reinicia tu agente después de configurarlo. El nuevo servidor MCP solo se detecta con un reinicio completo del agente: ciérralo del todo y vuelve a abrirlo (no basta con recargar la ventana).

04

Primera ejecución

Abre la ventana, autoriza y prueba tu primer prompt.

  1. Abre el proyecto en el editor de Godot y abre el panel AI Game Developer.
  2. Elige Cloud y haz clic en Authorize para completar el flujo de código de dispositivo.
  3. Espera a que el estado se ponga en verde y luego conecta tu cliente de IA.
  4. Prueba un prompt como el de abajo y mira cómo actúa en el editor.
Prompt de ejemplo
Añade una escena Node3D con una Camera3D y un cubo MeshInstance3D, luego guárdala como Main.tscn.

¿Quieres más prompts de ejemplo y los patrones para hacer solicitudes eficaces a la IA? Consulta las buenas prácticas de Godot →

El plugin de Godot expone 99 herramientas MCP para tu cliente de IA.

Explorar el catálogo de herramientas de Godot →

¿Quieres aún más herramientas? Explora las extensiones de Godot →