Unreal MCP

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 (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.
• 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#

Adónde ir ahora#

• ¿Es tu primera vez? Empieza con Instalación y luego con Primeros pasos.
• ¿Prefieres la versión corta? La página de instalación de Unreal Engine y la guía de inicio rápido cubren lo esencial.
• ¿Buscas detalles de las herramientas? Consulta el catálogo de herramientas de Unreal y las buenas prácticas de Unreal.
• ¿También usas otro motor? Consulta la wiki de Unity y la wiki de Godot. Los tres plugins comparten el mismo servidor, la misma cuenta y los mismos clientes de IA.