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

Configuración

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

Actualizado el 4 de noviembre de 2026 Ver como Markdown

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:

<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ónQué puedes hacer
EncabezadoElige 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ónCambia 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 IAElige 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
ExtensionesConsulta las extensiones instaladas y disponibles, Refresh catalog, Install o Update, activa o desactiva una extensión en caliente, Compile (Live Coding)
Pie de páginaHelp / Talk (Discord), Bug Report (GitHub), GitHub Star y Restart bridge

Los detalles de conexión están en Conectar clientes de IA y las extensiones en Extensiones.

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:

VariablePropósito
UNREAL_MCP_CONNECTION_MODECloud (predeterminado) o Custom
UNREAL_MCP_HOSTURL del servidor en modo Custom, por ejemplo http://localhost:<port>
UNREAL_MCP_CLOUD_URLURL base de Cloud; por defecto, ai-game.dev
UNREAL_MCP_TOKENToken de autenticación. Es un secreto: nunca lo incluyas en el repositorio
UNREAL_MCP_AUTH_OPTIONAutenticación en modo Custom: none, token u oauth (el valor antiguo required se interpreta como token)
UNREAL_MCP_KEEP_CONNECTEDRestaura la conexión automáticamente al iniciar (predeterminado: true)
UNREAL_MCP_TOOLSLista blanca de herramientas que se sirven; vacía significa sin filtro
UNREAL_MCP_START_SERVERtrue: el editor inicia el servidor local por sí mismo (modo Custom, solo http) y lo detiene al salir
UNREAL_MCP_TRANSPORThttp o stdio
UNREAL_MCP_LOG_LEVELNivel de detalle del log
UNREAL_MCP_TOOL_TIMEOUTTiempo máximo para una llamada a herramienta, en milisegundos; por defecto 300000 (5 minutos)
UNREAL_MCP_BRIDGE_PATHRuta a un binario del puente; una anulación para desarrolladores que prevalece sobre el incluido
UNREAL_MCP_SERVER_PATHRuta 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:

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.

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

Credenciales y claves en disco

ArchivoContenido
~/.ai-game-dev/credentials.jsonEl 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.jsonClaves de proyecto en caché usadas en las configuraciones de MCP Cloud
<project>/Saved/Config/UnrealMcp/ai-game-developer-config.jsonLos ajustes del plugin por proyecto
<project>/.envAnulaciones 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.