# Configuración — Unreal Engine · AI Game Developer Wiki

Configura Unreal MCP: la ventana AI Game Developer, la visibilidad de MCP Tools, el archivo de configuración, .env y las variables UNREAL_MCP_*.

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

Esta página enumera todos los ajustes que Unreal MCP tiene hoy y dónde cambiarlos. La mayoría de la gente solo toca el modo de conexión y la configuración del agente de IA; el resto es para ajuste fino, automatización y CI.

## Dónde están los ajustes

Unreal MCP no tiene una página de Project Settings para la conexión del editor. Todo está en la ventana **AI Game Developer** (menú Tools) y se guarda por proyecto en:

```text
<YourProject>/Saved/Config/UnrealMcp/ai-game-developer-config.json
```

`Saved/` está ignorado por el control de versiones en todas las plantillas de proyecto de Unreal, así que los tokens de este archivo no acaban en tu repositorio de forma predeterminada.

Los ajustes se leen en este orden, de mayor a menor prioridad:

1. Variables de entorno del proceso (por ejemplo, las definidas por `unreal-mcp-cli open` o tu shell).
2. Un archivo `.env` en la raíz del proyecto.
3. El archivo de configuración anterior.
4. Los valores predeterminados integrados.

Los valores que provienen del entorno o de `.env` sobrescriben el archivo para esa sesión, pero nunca se escriben de vuelta en él.

## La ventana AI Game Developer

| Sección | Qué puedes hacer |
| --- | --- |
| Encabezado | Elige el **Log Level** (Trace, Debug, Info, Warning, Error, Exception, None), abre la carpeta de logs del proyecto con **Open log file** y consulta la **Version** del plugin |
| Conexión | Cambia entre **Custom / Cloud**; en modo Cloud, **Authorize**, **Cancel** o **Revoke**; en modo Custom, define la **Server URL**; **Connect / Disconnect / Stop**; consulta el estado de Unreal, del servidor MCP y de los agentes de IA conectados, y el puerto del puente IPC |
| Servidor MCP (modo Custom) | **Start / Stop** del `gamedev-mcp-server` local, elige el **Transport** (http o stdio) y el modo de **Authorization** (none, token, oauth), y genera un token con **New** |
| Agente de IA | Elige un agente y luego **Configure**, **Reconfigure** o **Remove** su entrada MCP; abre su **Tutorial** o **Download / Docs**; **Generate skill files**; **Regenerate key** para la clave del proyecto |
| Extensiones | Consulta las extensiones instaladas y disponibles, **Refresh catalog**, **Install** o **Update**, activa o desactiva una extensión en caliente, **Compile (Live Coding)** |
| Pie de página | **Help / Talk** (Discord), **Bug Report** (GitHub), **GitHub Star** y **Restart bridge** |

Los detalles de conexión están en [Conectar clientes de IA](https://ai-game.dev/es/docs/wiki/unreal/connecting-ai-clients) y las extensiones en [Extensiones](https://ai-game.dev/es/docs/wiki/unreal/extensions).

## La ventana MCP Tools: visibilidad por herramienta

Abre **Tools** y luego **MCP Tools**. La ventana lista todas las herramientas registradas con su título, familia y descripción, una casilla **Visible** por herramienta y un resumen como "27 / 27 tools visible".

- **Visible** decide si una herramienta se muestra a los agentes de IA en `tools/list`. Ocultar las herramientas que no necesitas mantiene corta la lista de herramientas del agente y ahorra tokens.
- **No** es control de acceso. Una herramienta oculta se sigue ejecutando cuando un cliente la llama por su nombre, y `unreal-tool-list` muestra las herramientas ocultas (marcadas como ocultas) para que un agente pueda encontrarlas.
- La elección se guarda como `hiddenTools` y se conserva tras reiniciar el editor y recargar las extensiones.

Para dejar de servir una herramienta por completo, usa la lista blanca `UNREAL_MCP_TOOLS` que se describe más abajo.

## Otras ventanas

El menú Tools también tiene las ventanas **MCP Prompts** y **MCP Resources**. En la versión actual muestran un mensaje de estado vacío; los prompts y recursos registrados por el plugin o las extensiones siguen funcionando para los clientes de IA. Una ventana **Serialization Check** serializa a JSON el actor u objeto seleccionado para que puedas inspeccionar lo que ven las herramientas.

## Variables de entorno

El plugin lee estas variables `UNREAL_MCP_*` del entorno del proceso o del archivo `.env` del proyecto:

| Variable | Propósito |
| --- | --- |
| `UNREAL_MCP_CONNECTION_MODE` | `Cloud` (predeterminado) o `Custom` |
| `UNREAL_MCP_HOST` | URL del servidor en modo Custom, por ejemplo `http://localhost:<port>` |
| `UNREAL_MCP_CLOUD_URL` | URL base de Cloud; por defecto, ai-game.dev |
| `UNREAL_MCP_TOKEN` | Token de autenticación. Es un secreto: nunca lo incluyas en el repositorio |
| `UNREAL_MCP_AUTH_OPTION` | Autenticación en modo Custom: `none`, `token` u `oauth` (el valor antiguo `required` se interpreta como `token`) |
| `UNREAL_MCP_KEEP_CONNECTED` | Restaura la conexión automáticamente al iniciar (predeterminado: true) |
| `UNREAL_MCP_TOOLS` | Lista blanca de herramientas que se sirven; vacía significa sin filtro |
| `UNREAL_MCP_START_SERVER` | `true`: el editor inicia el servidor local por sí mismo (modo Custom, solo http) y lo detiene al salir |
| `UNREAL_MCP_TRANSPORT` | `http` o `stdio` |
| `UNREAL_MCP_LOG_LEVEL` | Nivel de detalle del log |
| `UNREAL_MCP_TOOL_TIMEOUT` | Tiempo máximo para una llamada a herramienta, en milisegundos; por defecto `300000` (5 minutos) |
| `UNREAL_MCP_BRIDGE_PATH` | Ruta a un binario del puente; una anulación para desarrolladores que prevalece sobre el incluido |
| `UNREAL_MCP_SERVER_PATH` | Ruta a un `gamedev-mcp-server` local; la lee `unreal-mcp-cli` y se salta la descarga de su servidor |

**Consejo:** Aumenta `UNREAL_MCP_TOOL_TIMEOUT` si los scripts largos de `python-execute` o las importaciones grandes de assets agotan el tiempo de espera. Una llamada a herramienta que agota el tiempo antes de que el editor la inicie se omite; no se ejecuta después.

## Escribir .env con la CLI

`unreal-mcp-cli configure` escribe estos valores en `<project>/.env` y añade `.env` al `.gitignore` del proyecto:

```bash
unreal-mcp-cli configure --path ./YourProject --mode Custom --host http://localhost:23456 --start-server
```

Las plantillas de proyecto de Unreal se distribuyen sin `.gitignore`, así que el comando crea uno si hace falta. Pasa `--no-gitignore` para no tocarlo. Todos los flags están en la [referencia de la CLI](https://ai-game.dev/es/docs/wiki/unreal/cli#configure).

**Advertencia:** Nunca hagas commit de `.env`. Puede contener `UNREAL_MCP_TOKEN`.

## Credenciales y claves en disco

| Archivo | Contenido |
| --- | --- |
| `~/.ai-game-dev/credentials.json` | El inicio de sesión de ai-game.dev para toda la máquina, compartido con la app, los plugins y las CLI |
| `~/.ai-game-dev/project-keys.json` | Claves de proyecto en caché usadas en las configuraciones de MCP Cloud |
| `<project>/Saved/Config/UnrealMcp/ai-game-developer-config.json` | Los ajustes del plugin por proyecto |
| `<project>/.env` | Anulaciones opcionales, nunca en el repositorio |

## Puertos

- El servidor MCP local usa un puerto fijo por proyecto entre 20000 y 29999, calculado a partir de la ruta del proyecto. La CLI calcula el mismo número, así que no hace falta configurar nada.
- El plugin y su puente se comunican por un puerto de loopback entre 30000 y 39999 (el siguiente libre en caso de colisión). La ventana lo muestra como "IPC bridge port".

Nunca necesitas abrir estos puertos a la red; ambos son locales.

---

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

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