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

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_*.

Actualizado el 4 de noviembre de 2026 Ver como Markdown

La mayoría de la gente nunca cambia ningún ajuste: el addon arranca en modo Cloud, se conecta después de que inicies sesión y expone todas sus herramientas. Esta página describe qué puedes cambiar cuando lo necesites, en el dock AI Game Developer, en los ajustes guardados y mediante variables de entorno para CI y ejecuciones por script.

El dock de AI Game Developer

El addon añade un dock llamado AI Game Developer al área de docks superior derecha del editor de Godot. De arriba abajo tiene estas secciones.

Encabezado

El encabezado muestra la versión del addon y un selector de Log Level. El nivel de log controla cuánto imprimen el addon y su conexión en el panel Output (Trace, Debug, Info, Warning, Error, None; por defecto Info). Súbelo a Debug o Trace cuando estés diagnosticando un problema de conexión. Cuando GODOT_MCP_LOG_LEVEL está definida, el selector se desactiva y una nota lo indica.

Conexión

  • Cloud / Custom: el modo de conexión. Cloud se conecta a ai-game.dev; Custom se conecta a una URL de servidor que elijas.
  • Connect / Stop: inicia o detiene la conexión con el servidor MCP. El addon sigue reintentando en segundo plano hasta que se conecta.
  • En modo Cloud: tu estado de sesión con Authorize (inicia el inicio de sesión por dispositivo en el navegador) y Sign out.
  • Una línea de tres puntos, Godot, servidor MCP y agente de IA, que muestra qué está conectado. La fila del agente de IA lista los clientes conectados por nombre, o dice "(connects on demand)" cuando todavía no hay ninguno conectado.

En modo Custom, una tarjeta MCP server añade:

  • Server URL: el servidor al que conectarse, por defecto http://localhost:8080.
  • Authorization Token: none, oauth (el token de tu cuenta de ai-game.dev, enviado solo a un servidor localhost) o token (un token bearer; New genera uno).
  • Start Server / Stop Server: descarga, inicia y detiene un servidor local que coincide con la versión de servidor fijada por el addon. Consulta Connecting AI clients.

Si una variable de entorno fuerza el modo o el host, una nota amarilla dice "Overridden by environment (GODOT_MCP_*)" y los cambios en el dock no surten efecto.

Agente de IA

Elige el cliente de IA que uses (Claude Code es el predeterminado). La sección muestra entonces:

  • Skills: dónde van los archivos de skills del agente, un interruptor Auto-generate que los actualiza cuando el addon se carga y un botón Generate. Los agentes sin soporte de skills muestran "Skills not supported by this agent".
  • Model Context Protocol (MCP): si la configuración MCP del agente está lista, con Configure / Reconfigure y Remove. Aparece un aviso Reconfiguration Required cuando los ajustes del servidor cambiaron después de que configuraras el agente.

Funciones MCP

Tres filas, Tools, Prompts y Resources, cada una con un recuento de elementos visibles sobre el total (las herramientas también muestran un coste estimado en tokens) y un botón Open. La ventana que se abre lista todos los elementos con un interruptor Visible y un campo de filtro.

Visible solo decide si los clientes MCP ven el elemento en su lista de herramientas. Ocultar las herramientas que no necesitas mantiene más pequeño el contexto del agente. No es control de acceso: una herramienta oculta se sigue ejecutando si un cliente la llama por su nombre.

Extensiones

La lista de extensiones opcionales de Godot MCP con botones Install y Update. Lee el catálogo de extensiones incluido en tu .csproj; si la lista está vacía, consulta Extensions.

Pie de página

Enlaces para ayuda y para informar de problemas, y una ventana Serialization Check que muestra cómo se serializa un nodo u objeto seleccionado para la IA (útil al informar de un bug).

Dónde se guardan los ajustes

El dock guarda sus ajustes en user://godot-mcp-config.json, en la carpeta de datos por usuario de Godot para el proyecto (no dentro del proyecto). Contiene el modo de conexión, el host personalizado, la opción de autorización, el nivel de log, el agente seleccionado, la visibilidad de herramientas y los tokens que usaste.

Las credenciales de inicio de sesión de Cloud viven por separado en el almacén de la máquina ~/.ai-game-dev/credentials.json, compartido con las demás herramientas de AI Game Developer. Las claves de proyecto para las configuraciones de agentes están en ~/.ai-game-dev/project-keys.json.

Desde una terminal, godot-cli configure lista y cambia la visibilidad de herramientas, prompts y recursos en el archivo de proyecto .godot-mcp/features.json:

godot-cli configure ./MyGodotProject --list
godot-cli configure ./MyGodotProject --disable-tools script-delete,script-execute
godot-cli configure ./MyGodotProject --enable-all-tools

Variables de entorno

Las variables de entorno anulan la configuración guardada sin editar ningún archivo, lo que resulta práctico para CI, ejecuciones headless y desarrollo local. El addon también las lee desde un archivo .env en el proyecto; el entorno del proceso tiene prioridad sobre .env.

VariableValoresPropósito
GODOT_MCP_CONNECTION_MODECloud, CustomFuerza el modo de conexión. Predeterminado: Cloud.
GODOT_MCP_CLOUD_URLURLAnula la URL base de la nube. Predeterminada: https://ai-game.dev.
GODOT_MCP_HOSTURLLa URL del servidor en modo Custom. Predeterminada: http://localhost:8080.
GODOT_MCP_AUTH_OPTIONnone, oauth, tokenAutorización del modo Custom.
GODOT_MCP_TOKENstringToken Bearer para el modo activo. Anula el guardado y nunca se vuelve a escribir.
GODOT_MCP_LOG_LEVELTrace a NoneVerbiosidad de los logs.
GODOT_MCP_CREDENTIALS_DIRruta absolutaUsa un almacén de credenciales independiente, para pruebas aisladas.
GODOT_MCP_TOOL_FORMATRql, JsonCómo toman argumentos las herramientas y devuelven resultados. Predeterminado Rql (texto compacto); Json mantiene los esquemas y resultados JSON.
GODOT_MCP_SERVER_PATHruta absolutaSolo en el editor: inicia este binario de servidor existente en lugar de descargar la versión fijada.
GODOT_MCP_RUNTIME_FROM_EDITOR1Permite que un juego iniciado con Play conecte también su propio runtime MCP en el juego.

Ejemplo: iniciar el editor contra un servidor local.

export GODOT_MCP_CONNECTION_MODE=Custom
export GODOT_MCP_HOST=http://localhost:8080
godot --editor --path ./MyGodotProject

godot-cli open configura estas variables por ti con --mode, --url, --cloud-url, --token, --auth y --log-level. Consulta la referencia de godot-cli.

Formato de herramientas

Con el formato Rql predeterminado, las herramientas toman valores RQL como argumentos (una ruta de nodo como "Level/Player", o godot.find("Name")) y devuelven texto compacto que consume menos tokens. El formato Json, configurado con GODOT_MCP_TOOL_FORMAT=Json o la clave toolFormat, mantiene los esquemas JSON completos y los resultados estructurados para los clientes que los prefieren. Más sobre RQL: Herramientas.