# Unreal MCP — AI Game Developer Wiki

Unreal MCP conecta Claude, Cursor, Copilot y otros agentes de IA con el editor de Unreal: cómo encajan plugin, bridge, CLI y app.

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

Unreal MCP es el plugin de Unreal Engine de AI Game Developer. Permite que un agente de IA como Claude Code, Cursor, GitHub Copilot, Codex o Gemini trabaje dentro del editor de Unreal: consultar y cambiar actores, componentes, assets y niveles, crear y compilar Blueprints, editar y compilar C++, ejecutar Python del editor y capturar pantallas que puede examinar. Tú describes lo que quieres en lenguaje natural y el agente llama a las herramientas del editor mediante el Model Context Protocol (MCP).

Esta wiki explica cómo instalar el plugin, conectar tu cliente de IA y obtener resultados útiles de la IA en el editor de Unreal. El plugin está en **beta**; la versión actual es la 0.26.2.

## Cómo encajan las piezas

Una configuración de Unreal MCP tiene cuatro partes. Conocerlas facilita mucho la puesta en marcha y la resolución de problemas.

- **El plugin Unreal MCP** (`UnrealMCP`). Un plugin de editor en C++ instalado en la carpeta `Plugins/` de tu proyecto. Registra las herramientas de IA y añade la ventana **AI Game Developer** al editor.
- **El bridge** (`unreal-mcp-bridge`). El editor de Unreal está en C++, así que el host MCP de .NET se ejecuta como un pequeño proceso auxiliar junto al editor. El plugin lo inicia automáticamente y se comunica con él mediante una conexión local protegida por token. Una versión empaquetada incluye el bridge, por lo que no tienes que instalar .NET.
- **El servidor MCP**. De forma predeterminada, el bridge se conecta al servidor alojado en [ai-game.dev](https://ai-game.dev) (modo **Cloud**). También puedes ejecutar el servidor local compartido `gamedev-mcp-server` en tu propia máquina (modo **Custom**).
- **Tu cliente de IA**. Cualquier cliente MCP se conecta al mismo servidor y llega a tu editor a través de él.

Dos herramientas te ayudan a configurarlo:

- **AI Game Dev**, la aplicación de escritorio, instala el plugin en un proyecto de Unreal por ti y puede abrir el editor. No se necesita Node.js. Consulta [la wiki de la app](https://ai-game.dev/es/docs/wiki/app).
- **`unreal-mcp-cli`**, una herramienta de línea de comandos multiplataforma en npm. Instala y actualiza el plugin, inicia tu sesión, escribe las configuraciones de los clientes MCP, abre el editor y ejecuta herramientas desde una terminal o CI.

## Qué puede hacer el agente de IA

El plugin incluye 27 herramientas en 7 familias. La mayor parte de los datos del editor pasan por **RQL**, un único lenguaje de consultas para todo el editor, en lugar de una herramienta por operación:

- **RQL** (`rql-query`, `rql-mutate`, `rql-schema`): encuentra y cambia actores, componentes, assets, niveles, DataTables, gameplay tags, Project Settings, gráficos de Blueprint, Widget Blueprints y Level Sequences.
- **Blueprints**: crea, edita y compila Blueprints, con una lista estructurada de errores que el agente puede corregir.
- **Código fuente C++**: lee, genera la estructura inicial, edita y compila el C++ del proyecto (Live Coding o Unreal Build Tool).
- **Python**: ejecuta Python con la API completa del editor `unreal`.
- **Capturas de pantalla**: viewport, vista de juego, cámara y capturas de actores aislados.
- **Console** y **tool list**: herramientas auxiliares.

Seis extensiones opcionales añaden compatibilidad con Control Rig, Enhanced Input, Gameplay Ability System, Landscape y Water, Niagara y PCG. También puedes registrar tus propias herramientas desde cualquier plugin de Unreal.

## Páginas de la wiki

| Página | Qué encontrarás |
| --- | --- |
| [Instalación](https://ai-game.dev/es/docs/wiki/unreal/installation) | Requisitos y todas las rutas de instalación disponibles hoy: la app, la CLI y la instalación manual |
| [Primeros pasos](https://ai-game.dev/es/docs/wiki/unreal/getting-started) | Primera conexión, primeros prompts y comprobar que todo funciona |
| [Conectar clientes de IA](https://ai-game.dev/es/docs/wiki/unreal/connecting-ai-clients) | Modo Cloud vs Custom, inicio de sesión con código de dispositivo, claves de proyecto y `setup-mcp` por agente |
| [Configuración](https://ai-game.dev/es/docs/wiki/unreal/configuration) | La ventana AI Game Developer, la ventana MCP Tools, el archivo de configuración y las variables `UNREAL_MCP_*` |
| [Herramientas](https://ai-game.dev/es/docs/wiki/unreal/tools) | Todas las herramientas integradas y qué pedir |
| [Extensiones](https://ai-game.dev/es/docs/wiki/unreal/extensions) | Las seis extensiones opcionales y cómo instalarlas |
| [Herramientas personalizadas](https://ai-game.dev/es/docs/wiki/unreal/custom-tools) | Añade tus propias herramientas, prompts y recursos desde C++, incluidas herramientas en tiempo de ejecución (in-game) |
| [Referencia de la CLI](https://ai-game.dev/es/docs/wiki/unreal/cli) | Todos los comandos y flags de `unreal-mcp-cli` |
| [Solución de problemas](https://ai-game.dev/es/docs/wiki/unreal/troubleshooting) | Soluciones para problemas de conexión, bridge, compilación y herramientas |
| [FAQ](https://ai-game.dev/es/docs/wiki/unreal/faq) | Respuestas breves a preguntas frecuentes |

## Adónde ir ahora

- ¿Es tu primera vez? Empieza con [Instalación](https://ai-game.dev/es/docs/wiki/unreal/installation) y luego con [Primeros pasos](https://ai-game.dev/es/docs/wiki/unreal/getting-started).
- ¿Prefieres la versión corta? La [página de instalación de Unreal Engine](https://ai-game.dev/es/engines/unreal) y la [guía de inicio rápido](https://ai-game.dev/es/docs/quickstart) cubren lo esencial.
- ¿Buscas detalles de las herramientas? Consulta el [catálogo de herramientas de Unreal](https://ai-game.dev/docs/tools/unreal) y las [buenas prácticas de Unreal](https://ai-game.dev/docs/best-practices/unreal).
- ¿También usas otro motor? Consulta la [wiki de Unity](https://ai-game.dev/es/docs/wiki/unity) y la [wiki de Godot](https://ai-game.dev/es/docs/wiki/godot). Los tres plugins comparten el mismo servidor, la misma cuenta y los mismos clientes de IA.

- [**Instalación** Instala el plugin Unreal MCP para Unreal Engine 5.5+ con la app AI Game Dev o unreal-mcp-cli. Requisitos, actualizaciones, desinstalación y estado en Fab.](https://ai-game.dev/es/docs/wiki/unreal/installation)
- [**Primeros pasos** Conecta Unreal MCP por primera vez, inicia sesión en ai-game.dev, configura tu cliente de IA y lanza tus primeros prompts de IA en el Unreal Editor.](https://ai-game.dev/es/docs/wiki/unreal/getting-started)
- [**Conexión de clientes de IA** Conecta Claude Code, Cursor, Copilot, Codex, Gemini y otros clientes MCP a Unreal MCP mediante la nube de ai-game.dev o un servidor local.](https://ai-game.dev/es/docs/wiki/unreal/connecting-ai-clients)
- [**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\_\*.](https://ai-game.dev/es/docs/wiki/unreal/configuration)
- [**Herramientas** Las 27 herramientas MCP integradas de Unreal — RQL, Blueprints, C++, Python, capturas y consola — y prompts de ejemplo para el Unreal Editor.](https://ai-game.dev/es/docs/wiki/unreal/tools)
- [**Extensiones** Extensiones opcionales de Unreal MCP para Control Rig, Enhanced Input, GAS, Landscape y Water, Niagara y PCG. Qué añade cada una y cómo instalarla.](https://ai-game.dev/es/docs/wiki/unreal/extensions)
- [**Herramientas personalizadas** Añade herramientas de IA, módulos RQL, prompts y recursos a Unreal MCP desde cualquier plugin de C++ y expón herramientas de gameplay en el juego.](https://ai-game.dev/es/docs/wiki/unreal/custom-tools)
- [**Referencia de la CLI** Referencia completa de unreal-mcp-cli: instala el plugin Unreal MCP, inicia sesión, configura agentes de IA, abre el editor y ejecuta Python.](https://ai-game.dev/es/docs/wiki/unreal/cli)
- [**Solución de problemas** Soluciona problemas comunes de Unreal MCP: plugin que no carga, bridge ausente, conexión atascada, agente de IA sin herramientas de Unreal y errores.](https://ai-game.dev/es/docs/wiki/unreal/troubleshooting)
- [**FAQ** Respuestas a dudas sobre Unreal MCP: versiones compatibles, clientes de IA, proyectos solo Blueprint, Fab, uso offline, coste y juegos empaquetados.](https://ai-game.dev/es/docs/wiki/unreal/faq)

---

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

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