FAQ

Respuestas breves a las preguntas más frecuentes sobre Unity MCP, el plugin de AI Game Developer para Unity. Cada respuesta enlaza a la página con los detalles.

General#

¿Qué es Unity MCP?#

Un plugin del Editor de Unity que permite a los agentes de IA trabajar en tu proyecto mediante el Model Context Protocol. El agente puede leer y cambiar escenas, GameObjects, componentes, prefabs y assets, escribir y ejecutar C#, ejecutar tests y hacer capturas de pantalla. Consulta la descripción general.

¿El plugin es gratuito y de código abierto?#

El plugin es de código abierto bajo la licencia Apache-2.0, en el repositorio Unity-MCP. El modo Custom ejecuta un servidor local y no necesita cuenta. El modo Cloud usa tu cuenta de ai-game.dev; los planes están en la página de precios.

¿Qué versiones de Unity son compatibles?#

Unity 2022.3 y posteriores, incluido Unity 6.

¿Qué clientes de IA funcionan con él?#

La ventana AI Game Developer incluye configuradores para Claude Code, Claude Desktop, Cursor, Visual Studio Code (Copilot), Visual Studio (Copilot), Rider (Junie), GitHub Copilot CLI, Gemini, Antigravity, Cline, Open Code, Codex, Kilo Code, Zoo Code y Unity AI, además de una entrada personalizada para cualquier otro cliente MCP. Consulta Conectar clientes de IA.

¿Necesito mi propio cliente de IA?#

No. La aplicación de escritorio AI Game Dev incluye el agente, instala el plugin y lo conecta. Usa tu propio cliente si ya utilizas Claude Code, Cursor u otro cliente MCP.

Puesta en marcha#

¿Cuál es la forma más sencilla de instalarlo?#

La aplicación de escritorio. Sin ella, ejecuta unity-mcp-cli install-plugin, o usa OpenUPM o el instalador .unitypackage. Consulta Instalación.

¿Dónde está la ventana del plugin?#

Window > AI Game Developer — MCP, con el atajo Ctrl+Alt+A (Cmd+Option+A en macOS), o el botón AI de la barra de herramientas de la vista Scene.

¿Cuál es la diferencia entre el modo Cloud y el modo Custom?#

En el modo Cloud, el predeterminado, el Editor y tu cliente de IA se conectan a https://ai-game.dev/mcp y solo tienes que iniciar sesión una vez. En el modo Custom, el plugin ejecuta un servidor MCP local en un puerto derivado de la ruta de tu proyecto y todo permanece en tu máquina. Consulta Configuración.

¿Tengo que elegir un puerto?#

No. El puerto se deriva de la ruta del proyecto (rango de 20000 a 29999), por lo que es estable por proyecto y distinto entre proyectos. Puedes sobrescribirlo en Server URL.

¿Dónde se guardan los ajustes?#

En UserSettings/AI-Game-Developer-Config.json dentro del proyecto. El inicio de sesión de ai-game.dev se guarda una vez por máquina en ~/.ai-game-dev/credentials.json.

¿Puedo usar varios proyectos de Unity a la vez?#

Sí. Cada proyecto tiene su propio puerto, y las URL fijadas (https://ai-game.dev/mcp/p/<pin>) dirigen cada agente al Editor correcto.

Cómo usarlo#

¿Dónde han ido a parar herramientas como gameobject-create?#

La versión 1.0.0 sustituyó las herramientas de una por acción por RQL: rql-query, rql-mutate y rql-schema cubren escenas, GameObjects, componentes, assets, la Consola y el estado del Editor. Consulta Herramientas y RQL.

¿La IA puede deshacer sus cambios?#

Cada llamada a rql-mutate se registra como un paso de Undo, así que Ctrl+Z (Cmd+Z) la revierte. Usa control de versiones para cambios mayores.

¿Por qué el agente solo ve unas pocas herramientas?#

Para ahorrar contexto. Siete herramientas son visibles por defecto; el resto están instaladas pero ocultas y se siguen ejecutando cuando se llaman por su nombre. Muestra más en la ventana, en Tools > Open.

¿Puedo añadir mis propias herramientas?#

Sí. Marca una clase con [AiToolType] y un método con [AiTool]. Consulta Herramientas personalizadas.

¿Cómo añado compatibilidad con Cinemachine, ProBuilder o Tilemaps?#

Instala la extensión correspondiente desde la sección Extensions de la ventana o con unity-mcp-cli install-extension. Consulta Extensiones.

¿Funciona en modo Play?#

Sí. El agente puede entrar y salir del modo Play mediante RQL (miembros de editor como isPlaying). La conexión se restablece tras la recarga de dominio.

Builds, CI y privacidad#

¿El plugin acaba en la build de mi juego?#

La parte de runtime se compila en las builds de jugador, pero una build nunca se conecta por sí sola. Debes activarlo desde el código con UnityMcpPluginRuntime.Initialize(...) para dar herramientas de IA dentro de tu juego. Para excluir el plugin por completo, añade la define de scripting UNITY_MCP_EXCLUDE_FROM_COMPILATION. Consulta Configuración.

¿Cómo evito que se ejecute en las pruebas de CI?#

Define UNITY_MCP_DISABLE=1 en el entorno del proceso de Unity, o usa la define UNITY_MCP_EXCLUDE_FROM_COMPILATION. Consulta Configuración.

¿Puedo usarlo mediante scripts sin un cliente de IA?#

Sí. unity-mcp-cli run-tool llama a cualquier herramienta desde una terminal, y unity-mcp-cli exec ejecuta C# en el Editor. Consulta la referencia de la CLI.

¿Qué datos salen de mi máquina?#

En el modo Custom con autorización none o token, nada pasa por ai-game.dev: el agente y Unity se comunican a través del servidor local. Tu cliente de IA sigue enviando tu conversación a su propio proveedor de modelos. En el modo Cloud, las llamadas a herramientas y sus resultados pasan por el servidor de ai-game.dev en su camino entre tu agente y el Editor.

¿Cómo desactivo el aviso de actualización para mi equipo?#

Activa Disable update notifications for the entire team en Edit > Project Settings > AI Game Developer y haz commit de ProjectSettings/AI-Game-Developer-UpdateSettings.asset.

Más ayuda#

• Solución de problemas para los errores.
• La FAQ de todo el sitio y las buenas prácticas de Unity.