Configura un servidor MCP para Unreal para que Claude cree Blueprints, genere actores y edite assets dentro de un editor de Unreal Engine 5 en marcha. Elige un servidor, activa los plugins, escribe la configuración de Claude Code o Desktop y soluciona los errores de conexión habituales.
Escribes una frase en una ventana de chat y aparece un asset de Blueprint en tu Content Browser. Esa es la promesa de un servidor MCP para Unreal: un programa puente que permite a Claude hablar con un editor de Unreal Engine en marcha a través del Model Context Protocol. La promesa es real, pero la configuración tiene sus asperezas. Trabajas con dos plugins del editor, uno o dos puertos, un archivo JSON y algunos límites que nadie menciona hasta que los encuentras. Este artículo recorre toda la cadena, desde activar los plugins correctos hasta escribir prompts que producen Blueprints limpios, y es sincero sobre lo que Claude todavía no puede hacer dentro de un grafo de Blueprint.
Un servidor MCP es un programa que expone herramientas a un cliente de IA. Claude ve un menú con opciones como "crear Blueprint", "generar actor" o "ejecutar script del editor", y elige de ese menú cada vez que tu prompt necesita una acción dentro del motor. La parte de Unreal es sencilla, porque el editor ya incluye formas de aceptar comandos externos. El servidor traduce las llamadas de herramientas de Claude a esos comandos y devuelve la respuesta del editor.
Cada configuración tiene las mismas tres piezas, sea cual sea el servidor que elijas:
| Pieza | Qué es | Dónde se ejecuta |
|---|---|---|
| Cliente de Claude | Claude Code o Claude Desktop | Tu equipo |
| Servidor MCP | Un programa puente en Python o Node | Tu equipo, iniciado por el cliente |
| Editor de Unreal | Plugin de Python más ejecución remota o la Remote Control API | Tu equipo, con un proyecto abierto |
El cliente inicia el servidor como proceso hijo y se comunica con él por entrada y salida estándar. Después, el servidor llega al editor a través de localhost. Lo único que sale de tu equipo son los prompts que envías a Claude.
Sin un puente, pides a Claude un script de Python, lo copias, lo pegas en la consola de Python del editor, lees el error y vuelves a copiarlo en el chat. Con el servidor, Claude ejecuta el script él mismo, lee la respuesta del editor y corrige sus propios errores. El ciclo se cierra sin que tú estés en medio.
Los mejores servidores van mucho más allá de las tareas con assets. La página de UEMCP dice que Claude puede generar actores, construir materiales, crear Blueprints, gestionar assets, mover la cámara del viewport y hacer capturas de pantalla, todo desde una conversación. Las capturas importan más de lo que parece: si tu cliente admite resultados con imágenes, Claude puede mirar el viewport después de un cambio y comprobar el resultado frente a tu petición, en lugar de fiarse solo de un mensaje de éxito.
Existen varios servidores de código abierto, y llegan al motor por tres rutas distintas. Elige según cómo te gusta trabajar, no por popularidad.
UEMCP es el ejemplo más claro. Habla con el protocolo de ejecución remota en Python que trae el propio motor, la misma búsqueda por multicast y el mismo canal de comandos TCP que incluye Unreal. Su página en PyPI indica compatibilidad con Unreal Engine 5.0 a 5.6 y Python 3.10 o superior, y expone herramientas para Blueprints que permiten crear uno, añadir un componente y establecer una propiedad por defecto. No hay nada que compilar.
unreal-engine-mcp usa la ruta HTTP. Combina la Remote Control API con Python dentro del editor, escucha en el puerto 30010 por defecto, y su página indica 162 herramientas, entre ellas importación de assets, creación de niveles, grafos de materiales, generación de clases en C++ y empaquetado. Según informa, lo ha probado en Unreal Engine 5.8. Tampoco hay nada que compilar.
Algunos proyectos incluyen un plugin en C++ que abre un socket dentro del editor, y un servidor en Python se conecta a ese socket. Obtienes un acceso más profundo, porque el código del plugin llega a partes internas del editor a las que Python no llega. El precio es una compilación por cada versión del motor. El plugin UnrealMCP funciona así: lo copias en la carpeta Plugins de tu proyecto, ejecutas su script de configuración y apuntas Claude Desktop a su script de ejecución.
| Ruta | Necesita compilar | Conexión | Ideal para |
|---|---|---|---|
| Ejecución remota en Python | No | Búsqueda por multicast UDP y luego TCP | Configuración rápida, tareas con assets |
| Remote Control API | No | HTTP en el puerto 30010 | Listas largas de herramientas, construcción de niveles |
| Plugin en C++ | Sí | Socket TCP propio | Acceso profundo al editor |
💡 Elección rápida: Si nunca has usado un servidor MCP, elige la ruta de ejecución remota en Python. Necesita un solo comando en Claude Code y ningún compilador. Pasa a un plugin en C++ solo cuando topes con un obstáculo que Python no pueda superar.
Las dos rutas sin compilación se apoyan en plugins que vienen con el motor. Actívalos una vez por proyecto. Antes de nada, comprueba tu versión del motor frente al rango que indica el servidor: UEMCP indica de 5.0 a 5.6, mientras que el servidor con Remote Control dice haberse probado en la 5.8. Con una versión fuera de esa lista, espera que algunas llamadas a la API de Python se comporten de otra manera.
💡 Usa un proyecto de pruebas: Haz tu primera sesión en un proyecto en blanco con la misma versión del motor. Un nivel desechable no te cuesta nada, y cualquier sorpresa se queda lejos de tus assets reales.
La opción se guarda en la configuración de tu proyecto, así que lo haces una sola vez. Haz commit del cambio de configuración en tu sistema de control de versiones para que tu equipo lo herede.
La ruta de Remote Control necesita su servidor HTTP en marcha. Abre la consola en el Output Log y ejecuta:
WebControl.StartServer
El servidor responde en el puerto 30010, salvo que lo hayas cambiado. Mantén el editor abierto y sin tareas mientras pruebas: los comandos se ejecutan dentro del editor, así que un editor ocupado compilando shaders responde con lentitud. El tiempo de espera por defecto de UEMCP es de 120 segundos por comando, un margen generoso pero no infinito.
Con el editor listo, registra el servidor en tu cliente de Claude. Elige el cliente que ya usas.
Para la ruta de ejecución remota en Python:
claude mcp add unreal -- uvx uemcp
Para la ruta de Remote Control:
claude mcp add unreal-mcp -- python -m unreal_mcp.server
El primer comando necesita tener instalado uv, porque uvx ejecuta el paquete sin una instalación manual. Ejecuta claude mcp list para confirmar que el servidor está registrado, o escribe /mcp dentro de una sesión para ver su estado de conexión.
Abre Settings ▸ Developer ▸ Edit Config. En Windows, el archivo está en %APPDATA%\Claude\claude_desktop_config.json. Añade una entrada bajo mcpServers:
{
"mcpServers": {
"unreal": {
"command": "uvx",
"args": ["uemcp"]
}
}
}
Para el servidor de Remote Control, pasa el puerto mediante una variable de entorno:
{
"mcpServers": {
"unreal-mcp": {
"command": "python",
"args": ["-m", "unreal_mcp.server"],
"env": { "UE_MCP_PORT": "30010" }
}
}
}
Cierra Claude Desktop por completo, no solo la ventana, y luego vuelve a abrirlo.
💡 Vigila las comas: Una coma sobrante o una llave que falta invalidan todo el archivo, y el servidor simplemente nunca aparece. Pega el archivo en cualquier validador de JSON antes de reiniciar.
Abre primero un proyecto en el editor y luego pregunta:
Lista los actores del nivel actual y dime cuántos son luces.
Si Claude responde con nombres que coinciden con tu World Outliner, la cadena funciona. Si dice que no tiene herramientas de Unreal, el cliente nunca cargó el servidor, así que revisa la configuración antes de tocar el editor.
Una vez que la conexión se mantiene, empieza el trabajo útil. Un Blueprint es una clase, y crear una clase con componentes y valores por defecto es justo el tipo de tarea estructurada que Claude resuelve bien mediante llamadas a herramientas.
Con los servidores basados en Python, las tareas fiables incluyen:
Este es un prompt que pone a prueba la mayor parte de esa lista:
Create an Actor Blueprint at /Game/Blueprints/BP_Pickup.
Add a StaticMesh component named PickupMesh using the engine Sphere mesh,
and a SphereCollision component named PickupTrigger with radius 120.
Set PickupMesh scale to 0.5 on every axis.
Then spawn three instances in the open level, 400 units apart along X.
Report the asset path and actor names when you are done.
Claude divide eso en varias llamadas a herramientas, comprueba cada respuesta y reintenta cuando el editor devuelve un error. Mientras tanto, ves aparecer los assets en el Content Browser.
Una buena primera sesión tiene cuatro pasos:
Si los cuatro pasos funcionan, sabes que la cadena lee, escribe y verifica. Solo entonces deberías pedir trabajos más grandes, como decorar una sala entera con props.
Aquí está el límite que la mayoría de los tutoriales omiten. La documentación de un servidor afirma claramente que los grafos de nodos de Blueprint no pueden crearse desde Python. Los componentes, los valores por defecto y las variables funcionan bien. Conectar un Event Graph nodo a nodo no es fiable en esa ruta.
La solución es un reparto de tareas limpio. Claude escribe la lógica en una clase padre en C++, exponiéndola con UFUNCTION(BlueprintCallable) y BlueprintImplementableEvent. Tú compilas. Después, Claude crea un Blueprint hijo, establece sus valores por defecto y lo coloca en el nivel. El grafo queda muy pequeño porque la lógica real vive en C++.
| Tarea | Solo con Python | Con una clase padre en C++ |
|---|---|---|
| Añadir componentes | Fiable | Fiable |
| Establecer valores por defecto | Fiable | Fiable |
| Conectar nodos del Event Graph | Poco fiable | Llama a funciones de C++ en su lugar |
| Lógica reutilizable | Difícil de compartir | Vive en una sola clase |
Los servidores más nuevos anuncian lectura y edición directa de grafos de Blueprint en las versiones recientes del motor. Tómalo como algo prometedor y pruébalo en una copia de tu proyecto antes de confiarle trabajo real.
El servidor se encarga de escribir. Tu prompt sigue decidiendo el resultado. Estos hábitos reducen notablemente la tasa de reintentos:
| Prompt vago | Prompt mejor |
|---|---|
| "Haz una puerta" | "Crea BP_Door en /Game/Props con un componente de static mesh llamado DoorMesh y un trigger de caja de 200 unidades de ancho. Informa de la ruta." |
| "Arregla mi iluminación" | "Lista todas las luces del nivel con su intensidad y su movilidad. No cambies nada todavía." |
| "Limpia los assets" | "Lista las texturas de /Game/Textures con más de 4096 píxeles. No borres nada." |
💡 Plantilla de cuatro líneas: Objetivo, ruta del asset, restricciones y qué informar. Úsala siempre y tus prompts serán cortos y precisos.
Las sesiones largas se desvían. Después de 20 o 30 llamadas a herramientas, Claude puede perder la pista de qué assets existen y empezar a adivinar rutas. Cuando eso pase, abre un chat nuevo y pega un resumen breve del estado actual: las carpetas en uso, los nombres de los Blueprints y la regla de nombres. Un resumen de diez líneas vale más que un historial de dos horas.
La mayoría de los fallos encajan en unos pocos patrones:
| Síntoma | Causa probable | Solución |
|---|---|---|
| El servidor no aparece en Claude | JSON no válido, o uvx y python no están en el PATH | Valida el JSON, ejecuta uvx --version y reinicia el cliente |
| Sin respuesta HTTP | Servidor web no iniciado | Ejecuta WebControl.StartServer en la consola del editor |
| Comandos rechazados | La ejecución remota está desactivada | Revisa Enable Remote Execution y reinicia el editor |
| Tiempos de espera agotados | Editor ocupado con shaders o con la carga de un nivel | Espera a que el editor esté inactivo y vuelve a intentarlo |
| Puerto ya en uso | Otra aplicación ocupa el 30010 | Cambia UE_MCP_PORT y el puerto de Remote Control para que coincidan |
| Editor no encontrado | Un firewall o una VPN bloquea el multicast | Permite UDP en 239.0.0.1:6766 o desactiva la VPN |
Cuando algo falle, lee primero el Output Log del editor. Los errores de Python de los comandos remotos aparecen allí, y Claude a menudo necesita ese texto exacto para resolver el problema. Si tu cliente no mostró el error, pégalo tú mismo en el chat.
La documentación de uno de los servidores también señala bEnableRemotePythonExecution=True en DefaultRemoteControl.ini cuando la ejecución remota sigue bloqueada, así que revisa ese archivo si la lista anterior no soluciona el problema.
La propia página de UEMCP advierte de que el protocolo de ejecución remota no tiene autenticación. Cualquiera que pueda llegar al puerto puede ejecutar Python dentro de tu editor. Mantén la conexión en localhost, nunca expongas los puertos en una Wi-Fi compartida de oficina y añade una regla de firewall si tu equipo está en una red que no controlas. Claude Code también pide permiso antes de las llamadas a herramientas, así que lee con atención cualquier aviso que ejecute Python arbitrario antes de aprobarlo.
Un proyecto de Unreal necesita algo más que Blueprints. Necesita especificaciones de diseño, briefs de niveles y arte de referencia, y PicassoIA se encarga de esa parte en el navegador.
Planifica primero el sistema en PicassoIA y luego lleva el resultado ordenado a tu sesión de Unreal. Esta es la rutina con Claude Sonnet 5:
Dos consejos sobre los parámetros: limita cada ejecución a un solo sistema y indica la versión del motor en la primera frase. Para un sistema de gameplay más grande, prueba Claude Fable 5 o Claude Opus 4.7, y para borradores rápidos de cabeceras de C++, Gemini 3.5 Flash es ágil.
| Modelo | Ideal para |
|---|---|
| Claude Sonnet 5 | Especificaciones, listas de prompts, planes de Blueprints |
| Claude Fable 5 | Sistemas de gameplay más grandes |
| Kimi K2.6 | Tareas de código tipo agente |
| Gemini 3.5 Flash | Borradores rápidos y cabeceras de C++ |
Antes de pedir a Claude que construya un patio, el interior de una nave o un claro de bosque, dale a todo el equipo la misma imagen del ambiente que buscas. Los modelos de imagen de PicassoIA como Seedream 5 Pro, GPT Image 2 y Flux 2 Pro convierten una frase en un fotograma de referencia fotorrealista en segundos. Producen imágenes 2D, así que úsalas como brief visual para la iluminación, los materiales y la ambientación, y luego pide a Claude que construya el nivel para que coincida.
Elige una escena de tu proyecto actual de Unreal y escribe una descripción de un párrafo. Abre PicassoIA, genera tres imágenes de referencia a partir de ese párrafo y quédate con la que te parezca acertada. Pega su descripción en tu próximo prompt de Claude y observa cuánto más se acerca el primer intento. Tu flujo de trabajo se acelera en cuanto los prompts y las imágenes coinciden.
Elige tu idioma
