Configuración del plugin de Unity, paso a paso

Todo lo necesario para pasar de un proyecto de Unity vacío a un agente de IA trabajando en el Editor: instala el plugin, inicia sesión, conecta tu cliente de IA y añade las extensiones que necesites. La página de instalación de Unity tiene la versión resumida.

Antes de empezar

Unity 2022.3 o posterior, una cuenta de ai-game.dev y un cliente de IA.

Unity 2022.3 o posterior: se admite Unity 6.
Una cuenta de ai-game.dev para la conexión Cloud predeterminada: crea una si no tienes.
Un cliente de IA: la app AI Game Dev, Claude Code, Cursor, Copilot, Gemini, Codex o cualquiera de los 14 clientes MCP compatibles.
Conexión a internet en la primera apertura: el plugin descarga sus paquetes .NET desde NuGet.

Instala el plugin

Con la app, la CLI, OpenUPM o el paquete instalador: elige una opción.

Cuatro formas de añadir el plugin, de la más sencilla a la más manual:

Abre tu proyecto de Unity en la app AI Game Dev y haz clic en Install Package. La app instala el plugin más reciente desde OpenUPM, inicia sesión y configura tu agente.

Instala la CLI desde npm y luego añade el plugin a tu proyecto (modifica Packages/manifest.json por ti):

npm install -g unity-mcp-cli
unity-mcp-cli install-plugin ./MyUnityProject

Con la CLI de OpenUPM, ejecuta esto en la carpeta del proyecto:

openupm add com.ivanmurzak.unity.mcp

¿No tienes la CLI de OpenUPM? Añade el registro con ámbito a Packages/manifest.json y luego añade el paquete en Window → Package Manager:

{
  "scopedRegistries": [
    {
      "name": "package.openupm.com",
      "url": "https://package.openupm.com",
      "scopes": ["com.ivanmurzak", "extensions.unity"]
    }
  ]
}

Abre la ventana e inicia sesión

Abre la ventana de AI Game Developer e inicia sesión una vez con tu cuenta.

En Unity, elige Window → AI Game Developer — MCP (Ctrl+Alt+A, o Cmd+Option+A en macOS).
Deja el interruptor Connection en Cloud y haz clic en Authorize.
Tu navegador abre la página de inicio de sesión de ai-game.dev con un código corto. Comprueba que el código coincide y apruébalo.
El estado de Unity cambia a Connected.

El inicio de sesión se guarda para todo el equipo: si ya iniciaste sesión con la app o con unity-mcp-cli login, el Editor lo usa y puedes saltarte este paso.

Conecta tu cliente de IA

Un comando, o un clic en la ventana, escribe la configuración de tu cliente.

En la ventana, haz clic en Configure junto a tu agente de IA o ejecuta setup-mcp desde una terminal. Ambos escriben en la configuración del cliente la URL fijada al proyecto y una clave de proyecto, así que se conecta al instante:

# Claude Code — use your agent's id (cursor, codex, gemini, vscode-copilot, …)
unity-mcp-cli setup-mcp claude-code ./MyUnityProject

Reinicia el cliente de IA después de cambiar su configuración. Para otros clientes y la configuración manual, consulta Conexión de clientes de IA y la página del endpoint MCP.

Añade extensiones (opcional)

Animación, Cinemachine, Terrain, Timeline y más: instala solo lo que necesites.

Cada extensión es su propio paquete de Unity. En cuanto se instala, le enseña al agente un área de Unity mediante RQL. Algunas de las más populares:

AI Animation3 capacidades

openupm add com.ivanmurzak.unity.mcp.animation

AI Cinemachine4 capacidades

openupm add com.ivanmurzak.unity.mcp.cinemachine

AI Terrain4 capacidades

openupm add com.ivanmurzak.unity.mcp.terrain

AI Timeline5 capacidades

openupm add com.ivanmurzak.unity.mcp.timeline

Las 10 extensiones de Unity →

Solución de problemas

Soluciones para los problemas más frecuentes. Hay más en la guía de solución de problemas de Unity.

Siguiente parada

Wiki de Unity →Configuración, herramientas y RQL, herramientas personalizadas, la referencia de la CLI y mucho más.Herramientas de Unity →Todo lo que el agente puede hacer en Unity, con ejemplos.Buenas prácticas →Cómo pedirle al agente tareas que hace bien.