# FAQ — Unity · AI Game Developer Wiki Respuestas a las dudas más comunes sobre Unity MCP: versiones compatibles, clientes de IA, modo Cloud o local, coste, privacidad, builds, CI y RQL. Esta página se tradujo automáticamente del inglés. [Lee el original en inglés](https://ai-game.dev/docs/wiki/unity/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](https://ai-game.dev/es/docs/wiki/unity). ### ¿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](https://github.com/IvanMurzak/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](https://ai-game.dev/pricing). ### ¿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](https://ai-game.dev/es/docs/wiki/unity/connecting-ai-clients). ### ¿Necesito mi propio cliente de IA? No. La [aplicación de escritorio AI Game Dev](https://ai-game.dev/docs/app) 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](https://ai-game.dev/es/docs/wiki/unity/installation). ### ¿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](https://ai-game.dev/es/docs/wiki/unity/configuration#connection-modes). ### ¿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/`) 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](https://ai-game.dev/es/docs/wiki/unity/tools-and-rql#old-names). ### ¿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](https://ai-game.dev/es/docs/wiki/unity/custom-tools). ### ¿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](https://ai-game.dev/es/docs/wiki/unity/extensions). ### ¿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](https://ai-game.dev/es/docs/wiki/unity/configuration#runtime). ### ¿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](https://ai-game.dev/es/docs/wiki/unity/configuration#ci). ### ¿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](https://ai-game.dev/es/docs/wiki/unity/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](https://ai-game.dev/es/docs/wiki/unity/troubleshooting) para los errores. - La [FAQ](https://ai-game.dev/docs/faq) de todo el sitio y las [buenas prácticas de Unity](https://ai-game.dev/docs/best-practices/unity). --- Source (HTML): https://ai-game.dev/es/docs/wiki/unity/faq Machine-translated (es) from the English page: https://ai-game.dev/docs/wiki/unity/faq