# Configuración — Godot · AI Game Developer Wiki

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

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

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](https://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](https://ai-game.dev/es/docs/wiki/godot/connecting-ai-clients#custom-mode).

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](https://ai-game.dev/es/docs/wiki/godot/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.

**Advertencia**

Este archivo guarda los tokens como JSON sin cifrar. No lo subas al repositorio, ni lo sincronices ni lo compartas. Para rotar un token, cierra sesión o bórralo en el dock (o elimina el archivo) y vuelve a conectarte.

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`:

```bash
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`.

| Variable | Valores | Propósito |
| --- | --- | --- |
| `GODOT_MCP_CONNECTION_MODE` | `Cloud`, `Custom` | Fuerza el modo de conexión. Predeterminado: `Cloud`. |
| `GODOT_MCP_CLOUD_URL` | URL | Anula la URL base de la nube. Predeterminada: `https://ai-game.dev`. |
| `GODOT_MCP_HOST` | URL | La URL del servidor en modo Custom. Predeterminada: `http://localhost:8080`. |
| `GODOT_MCP_AUTH_OPTION` | `none`, `oauth`, `token` | Autorización del modo Custom. |
| `GODOT_MCP_TOKEN` | string | Token Bearer para el modo activo. Anula el guardado y nunca se vuelve a escribir. |
| `GODOT_MCP_LOG_LEVEL` | `Trace` a `None` | Verbiosidad de los logs. |
| `GODOT_MCP_CREDENTIALS_DIR` | ruta absoluta | Usa un almacén de credenciales independiente, para pruebas aisladas. |
| `GODOT_MCP_TOOL_FORMAT` | `Rql`, `Json` | Cómo toman argumentos las herramientas y devuelven resultados. Predeterminado `Rql` (texto compacto); `Json` mantiene los esquemas y resultados JSON. |
| `GODOT_MCP_SERVER_PATH` | ruta absoluta | Solo en el editor: inicia este binario de servidor existente en lugar de descargar la versión fijada. |
| `GODOT_MCP_RUNTIME_FROM_EDITOR` | `1` | Permite que un juego iniciado con Play conecte también su propio runtime MCP en el juego. |

Ejemplo: iniciar el editor contra un servidor local.

```bash
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](https://ai-game.dev/es/docs/wiki/godot/cli#open).

## 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](https://ai-game.dev/es/docs/wiki/godot/tools#rql).

---

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

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