Question 1

¿Por qué algunos clientes fallan con KeyError: 'position' durante la inicialización de la herramienta?

Accepted Answer

Algunos clientes MCP pueden fallar al parsear los esquemas de herramienta cuando contienen referencias locales de puntero JSON como #/properties/position. MCP Unity evita esto registrando los inputs de herramientas de transformación (set_transform, move_gameobject, rotate_gameobject, scale_gameobject) con esquemas de vectores anidados nuevos por campo, de modo que el esquema generado no dependa de referencias locales #/properties/.... Si aún ves este error: actualiza tu cliente MCP a la última versión, recompila el servidor Node (cd Server~ && npm run build) y verifica que la versión de tu paquete incluya esta corrección de compatibilidad.

Question 2

¿Por qué obtengo un error de conexión fallida al ejecutar pruebas en modo Play?

Accepted Answer

La herramienta run_tests devuelve la siguiente respuesta: Error: Connection failed: Unknown error. Este error ocurre porque la conexión del puente se pierde cuando el dominio se recarga al cambiar a modo Play. La solución alternativa es desactivar Reload Domain en Edit > Project Settings > Editor > "Enter Play Mode Settings".

Question 3

¿Por qué no arranca el servidor MCP Unity?

Accepted Answer

Revisa la consola de Unity para ver mensajes de error. Asegúrate de que Node.js esté correctamente instalado y accesible en tu PATH. Verifica que todas las dependencias estén instaladas en el directorio Server.

Question 4

¿Por qué no puedo conectar con MCP Unity?

Accepted Answer

Asegúrate de que el servidor WebSocket esté en ejecución (revisa la ventana Server en Unity). Envía un mensaje de registro a la consola desde el cliente MCP para forzar una reconexión entre el cliente MCP y el servidor Unity. Cambia el número de puerto en la ventana MCP Server del Editor de Unity. (Herramientas > MCP Unity > Server Window)

Question 5

¿MCP Unity es gratuito?

Accepted Answer

Sí, MCP Unity es un proyecto de código abierto bajo la Licencia MIT. Puedes usar, modificar y distribuirlo libremente según los términos de la licencia.

Question 6

¿Puedo ampliar MCP Unity con herramientas personalizadas para mi proyecto?

Accepted Answer

¡Sí, absolutamente! Uno de los beneficios importantes de la arquitectura de MCP Unity es su extensibilidad. En Unity (C#): puedes crear nuevas clases C# que hereden de McpToolBase (o una base similar para recursos) para exponer funcionalidad personalizada del Unity Editor. Estas herramientas se registrarán en McpUnityServer.cs. Por ejemplo, podrías escribir una herramienta para automatizar una canalización de importación de assets específica de tu proyecto. En el servidor Node.js (TypeScript): luego definirías el manejador de herramienta TypeScript correspondiente en el directorio Server/src/tools/, incluyendo su esquema Zod para entradas/salidas, y lo registrarías en Server/src/index.ts. Esta parte de Node.js reenviará la solicitud a tu nueva herramienta C# en Unity. Esto te permite adaptar las capacidades de la IA a las necesidades y flujos de trabajo específicos de tu juego o aplicación.

Question 7

¿Qué hosts y IDEs de MCP admiten actualmente MCP Unity?

Accepted Answer

MCP Unity está diseñado para funcionar con cualquier asistente de IA o entorno de desarrollo que pueda actuar como cliente MCP. El ecosistema está creciendo, pero las integraciones conocidas o plataformas compatibles actuales incluyen: Cursor, Windsurf, Claude Desktop, Claude Code, Codex CLI, GitHub Copilot, Google Antigravity, OpenCode.

Question 8

¿Qué es MCP Unity?

Accepted Answer

MCP Unity es un puente potente que conecta tu entorno del Unity Editor con asistentes de IA y herramientas LLM mediante el Model Context Protocol (MCP). En esencia, MCP Unity: expone funcionalidades del Unity Editor (como crear objetos, modificar componentes, ejecutar pruebas, etc.) como "herramientas" y "recursos" que una IA puede entender y usar. Ejecuta un servidor WebSocket dentro de Unity y un servidor Node.js (que actúa como cliente WebSocket de Unity) que implementa el MCP. Esto permite que los asistentes de IA envíen comandos a Unity y reciban información de vuelta. Te permite usar indicaciones en lenguaje natural con tu asistente de IA para realizar tareas complejas dentro de tu proyecto Unity, acelerando significativamente los flujos de trabajo de desarrollo.

Question 9

¿Cómo se compara MCP Unity con las próximas funciones de IA de Unity 6.2?

Accepted Answer

Unity 6.2 está programado para introducir nuevas herramientas de IA integradas, incluyendo el anterior Unity Muse (para capacidades generativas de IA como generación de texturas y animaciones) y Unity Sentis (para ejecutar redes neuronales en tiempo de ejecución de Unity). Como Unity 6.2 aún no se ha lanzado completamente, esta comparación se basa en la información disponible públicamente y en las funcionalidades previstas:

**Enfoque:**
- **MCP Unity:** Se centra principalmente en la automatización e interacción del Editor. Permite que IA externa (como asistentes de codificación basados en LLM) controle y consulte el propio Unity Editor para manipular escenas, activos y configuraciones del proyecto. Se trata de potenciar el flujo de trabajo del desarrollador dentro del Editor.
- **IA de Unity 6.2:** Apunta a la creación de contenido dentro del Editor (generación de texturas, sprites, animaciones, comportamientos, scripts) y asistencia impulsada por IA para tareas comunes, integrada directamente en la interfaz del Unity Editor. Un modelo afinado para responder cualquier pregunta sobre la documentación y la estructura de la API de Unity, con ejemplos personalizados más precisos al entorno de Unity. Añade la funcionalidad de ejecutar inferencias de modelos de IA, permitiendo a los desarrolladores desplegar y ejecutar redes neuronales pre‑entrenadas dentro de su juego o aplicación para funciones como comportamiento de NPC, reconocimiento de imágenes, etc.

**Casos de uso:**
- **MCP Unity:** "Crear un nuevo objeto 3D, nombrarlo 'Player', añadir un Rigidbody y establecer su masa a 10." "Ejecutar todas las pruebas en modo Play." "Solicitar la corrección del error en el registro de la consola." "Ejecutar el ítem de menú personalizado 'Prepare build for iOS' y corregir cualquier error que pueda surgir."
- **IA de Unity 6.2:** "Generar texturas y animaciones directamente desde el Editor," "Consultar la documentación de la API para generar scripts específicos," "Ejecutar infe

Question 10

¿Por qué usar MCP Unity?

Accepted Answer

MCP Unity ofrece varias ventajas convincentes para desarrolladores, artistas y gestores de proyectos: Desarrollo acelerado: Automatiza tareas repetitivas, genera código boilerplate y gestiona activos mediante indicaciones de IA. Esto libera tiempo para centrarse en la creatividad y la resolución de problemas complejos. Productividad mejorada: Interactúa con las funciones del Editor de Unity sin necesidad de hacer clic manualmente en los menús o escribir scripts para operaciones simples. Tu asistente de IA se convierte en una extensión directa de tus capacidades dentro de Unity. Accesibilidad aumentada: Permite a usuarios menos familiarizados con las intricacias del Editor de Unity o la programación en C# aportar y modificar de forma significativa un proyecto mediante la guía de IA. Integración fluida: Diseñado para trabajar con varios asistentes de IA y IDEs que soportan MCP, proporcionando una forma consistente de aprovechar la IA en tu conjunto de herramientas de desarrollo. Extensibilidad: El protocolo y el conjunto de herramientas pueden ampliarse. Puedes definir nuevas herramientas y recursos para exponer más de la funcionalidad específica de tu proyecto o de Unity a la IA. Potencial colaborativo: Facilita una nueva forma de colaboración donde la IA puede asistir en tareas tradicionalmente realizadas por miembros del equipo, o ayudar en la incorporación de nuevos desarrolladores guiándolos a través de la estructura y operaciones del proyecto.

mcp-unityEste servidor MCP conecta a los asistentes de codificación de inteligencia artificial directamente al editor de juegos de Unity. Puede construir escenas, mover objetos, cambiar materiales y ejecutar pruebas simplemente tecleando instrucciones, lo que ahorra tiempo y

Resumen

Funciones clave

Precio

Casos de uso

Desarrollo de juegos

Codificación asistida por inteligencia artificial

Pros y contras

Ventajas

Contras

Reseñas

Preguntas y respuestas

Hacer una pregunta

Alternativas a Servidores MCP