Beta abierta de Unity AI: Cómo dar los primeros pasos con MCP
En el artículo de hoy sobre la beta abierta de Unity AI, descubre cómo conectar Claude Code, GitHub Copilot y otros agentes de IA directamente al editor de Unity mediante el servidor del Protocolo de contexto de modelos (MCP) de Unity.
El servidor MCP de Unity AI abre una nueva forma de trabajar con agentes de IA en tu IDE. En lugar de tener que alternar entre tu editor de código y Unity, puedes conectar agentes como Claude Code, Cursor, Windsurf o VS Code Copilot directamente a tu proyecto de Unity en ejecución, y dejar que el IDE obtenga todo el contexto del proyecto —como inspeccionar escenas, leer la salida de la consola, editar scripts y activar acciones del Editor— sin que tengas que copiar y pegar el contexto.
En esta entrada se explica qué es MCP, cómo conectar un agente, qué herramientas hay disponibles y cómo puedes utilizarlo para agilizar tareas habituales de desarrollo, como la corrección de errores y la gestión de escenas.
¿Qué es el Protocolo de Contexto de Modelos?
El Protocolo de Contexto de Modelos (MCP) es un estándar abierto que permite a los agentes de IA comunicarse con herramientas y fuentes de datos externas de forma estructurada. El servidor MCP de Unity implementa este protocolo para que cualquier agente de IA compatible con MCP pueda conectarse al Editor de Unity e interactuar con él como si se tratara de un conjunto de herramientas a las que se puede recurrir.
Sin MCP, un agente de IA en tu IDE solo ve lo que tú le muestras: los archivos que tienes abiertos, el código que pegas o los errores que copias. Con MCP, se dispone de acceso en tiempo real al estado de ejecución de tu proyecto de Unity —jerarquía de escenas, GameObjects, valores de los componentes, ajustes de compilación y mensajes de la consola— a través de un protocolo estandarizado.
El servidor MCP oficial de Unity se incluye en el paquete AI Assistant y requiere una suscripción a Unity para poder utilizarlo (aunque no se consumen créditos de Unity AI).
Requisitos previos
Para empezar a utilizar MCP, tu entorno debe cumplir los siguientes requisitos:
- Unity 6 (6000.0) o posterior con el paquete AI Assistant instalado
- Un cliente de IA compatible con MCP, como Claude Code, Cursor, Windsurf o Claude Desktop
- Un proyecto de Unity conectado a Unity Cloud
- Una prueba o suscripción activa a Unity AI
Cómo integrar un agente de IA con Unity
La configuración de Unity MCP solo lleva unos minutos. Este es el proceso completo:
1. Comprueba que el puente MCP de Unity esté en funcionamiento
En el editor de Unity, ve a Edición > Configuración del proyecto > IA > Unity MCP. Comprueba que Unity Bridge aparezca como «En ejecución» (indicador verde). El puente se inicia automáticamente al cargarse el Editor. Si aparece «Detenido», selecciona «Iniciar».
2. Configura tu cliente de IA
La sección «Integraciones» de la página de configuración de Unity MCP permite configurar automáticamente los clientes compatibles: despliega «Integraciones», selecciona tu cliente y haz clic en «Configurar». Entre los clientes compatibles pueden figurar Claude Code, Cursor, Windsurf y Claude Desktop, dependiendo de la versión de Unity MCP que tengas.
3. Añade la ruta de Relay manualmente (si es necesario)
Si tu cliente no aparece en la lista de configuración automática, añade una entrada de servidor que apunte al archivo binario del Relay de Unity. El Relay se instala en ~/.unity/relay/ cuando se inicia Unity. Pasa --mcp como argumento de línea de comandos al ejecutable de Relay.
4. Aceptar la conexión en Unity
La primera vez que tu agente se conecta, Unity muestra un mensaje que dice «Conexión pendiente». Ve a Edición > Configuración del proyecto > IA > Unity MCP, revisa los datos del cliente y selecciona Aceptar. Los clientes ya aprobados se vuelven a conectar automáticamente.
5. Comprueba la conexión
Tu agente debería mostrarte ahora las herramientas de Unity MCP disponibles. Ejecuta un comando sencillo como «Lee los mensajes de la consola de Unity y resume las advertencias o los errores» para comprobar que la conexión funciona.
Rutas de retransmisión específicas de cada plataforma
La ruta binaria del Relay varía según el sistema operativo. Utiliza la ruta correspondiente a tu plataforma al configurar el agente manualmente:
- macOS (Apple Silicon): ~/.unity/relay/relay_mac_arm64.app/Contents/MacOS/relay_mac_arm64
- macOS (Intel): ~/.unity/relay/relay_mac_x64.app/Contents/MacOS/relay_mac_x64
- Windows: %USERPROFILE%\.unity\Relay\Relay_win.exe
- Linux: ~/.unity/Relay/Relay_linux
Herramientas disponibles
Una vez conectado, tu agente de IA tendrá acceso a un conjunto de herramientas MCP integradas en Unity. Estas herramientas son a las que recurre el agente cuando le das instrucciones; no interactúa directamente con Unity, sino que lo hace a través del protocolo.
Las principales categorías de herramientas son:
- Gestión de escenas: leer la jerarquía, crear/modificar/eliminar GameObjects, gestionar escenas
- Edición de scripts: crea, lee y modifica scripts de C# en tu proyecto
- Acceso a la consola: leer registros, advertencias y errores desde la consola de Unity
- Inspección de GameObjects: leer y escribir valores de componentes en GameObjects específicos
- Configuración de compilación: revisar la plataforma y la configuración de compilación
También puedes registrar herramientas MCP personalizadas en C# para poner a disposición de los agentes conectados tus propios flujos de trabajo del editor, lo cual resulta útil para los equipos que desean automatizar tareas específicas de cada proyecto.
Control de Unity desde un agente de IA
Con la conexión MCP activa, puedes dar instrucciones en lenguaje natural a tu agente de IA y este las ejecutará utilizando las herramientas de Unity. Algunos ejemplos:
- «Crea un nuevo GameObject vacío llamado PlayerSpawn en la posición (0, 0, 0)»
- «Lee la jerarquía de la escena y dime qué objetos tienen componentes que faltan».
- «Escribe un script que mueva la cámara para que siga al jugador y adjúntalo a la cámara principal».
- «Comprueba si hay errores en la consola y corrige cualquier problema relacionado con referencias null».
El agente utiliza las herramientas del MCP para llevar a cabo cada paso, mostrando su razonamiento y las llamadas a las herramientas que realiza. Permanecerás en tu IDE en todo momento; no es necesario que cambies a Unity hasta que quieras revisar el resultado.
Solucionar errores de consola con Unity MCP
Uno de los usos más prácticos de Unity MCP es permitir que tu agente lea y solucione los errores de la consola de forma autónoma. Dado que el agente puede tanto leer la consola como editar scripts en la misma sesión, puede pasar del error a la solución sin que tengas que copiar nada:
1. El agente lee la consola mediante Unity_ReadConsole
2. Identifica el script correspondiente y lee su contenido
3. Escribe una corrección y vuelve a guardar el archivo en el proyecto
4. Vuelve a consultar la consola para comprobar que el error se ha solucionado
De este modo se cierra el ciclo de retroalimentación que normalmente requiere copiar y pegar manualmente entre Unity y un asistente de IA: el agente se encarga de todo el proceso de principio a fin.
Más información sobre Unity AI
Si te interesa saber más sobre lo que ofrece la beta abierta de Unity AI, te invitamos a leer otros artículos de esta serie:
Prueba Unity AI hoy mismo
La beta abierta de Unity AI ya está disponible para todos los desarrolladores de Unity 6. Regístrate para obtener una prueba gratuita, explora el Asistente de IA de Unity AI, conecta tus herramientas preferidas a través de Unity AI Gateway y empieza a descubrir cómo se ve tu flujo de trabajo de desarrollo con un agente de IA integrado que reconoce el proyecto.
Regístrate y obtén más información sobre los planes, los precios y la privacidad de los datos en unity.com/features/ai
La documentación completa está disponible en la documentación de Unity AI, a la que se puede acceder desde el Editor o en docs.unity3d.com.
Unity AI Assistant se encuentra actualmente en fase beta abierta. Por lo tanto, las funciones, el comportamiento y la disponibilidad descritos en esta publicación se encuentran en fase de desarrollo activo y pueden sufrir cambios, verse limitados o dejar de estar disponibles sin previo aviso.