# Configuración del plugin de Unity — AI Game Developer

Configura paso a paso el plugin AI Game Developer para Unity: instálalo, inicia sesión, conecta tu cliente de IA y añade extensiones, con soluciones para los problemas habituales.

Esta página se tradujo automáticamente del inglés. [Lee el original en inglés](https://ai-game.dev/docs/unity-plugin-setup).

Unity · configuración manual

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](https://ai-game.dev/es/engines/unity) tiene la versión resumida.

01

## 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](https://ai-game.dev/create-account) 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](https://ai-game.dev/es/mcp-endpoint-info).
- **Conexión a internet en la primera apertura**: el plugin descarga sus paquetes .NET desde NuGet.

02

## 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:

**App de escritorio**

Abre tu proyecto de Unity en la [app AI Game Dev](https://ai-game.dev/es/download) y haz clic en **Install Package**. La app instala el plugin más reciente desde OpenUPM, inicia sesión y configura tu agente.

**unity-mcp-cli**

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

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

**OpenUPM**

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

```bash
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**:

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

**.unitypackage**

Descarga el instalador e impórtalo con **Assets → Import Package → Custom Package…**. Añade el registro de OpenUPM y el paquete a tu proyecto, así que las actualizaciones posteriores llegan desde el Package Manager.

[⬇ Descargar AI-Game-Dev-Installer.unitypackage](https://github.com/IvanMurzak/Unity-MCP/releases/latest/download/AI-Game-Dev-Installer.unitypackage)

03

## Abre la ventana e inicia sesión

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

1. En Unity, elige **Window → AI Game Developer — MCP** (`Ctrl+Alt+A`, o `Cmd+Option+A` en macOS).
2. Deja el interruptor **Connection** en **Cloud** y haz clic en **Authorize**.
3. 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.
4. 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.

04

## 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:

```bash
# 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](https://ai-game.dev/es/docs/wiki/unity/connecting-ai-clients) y la [página del endpoint MCP](https://ai-game.dev/es/mcp-endpoint-info).

05

## 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 Animation](https://ai-game.dev/docs/extensions/unity/animation) 3 capacidades
  ```bash
  openupm add com.ivanmurzak.unity.mcp.animation
  ```
- [AI Cinemachine](https://ai-game.dev/docs/extensions/unity/cinemachine) 4 capacidades
  ```bash
  openupm add com.ivanmurzak.unity.mcp.cinemachine
  ```
- [AI Terrain](https://ai-game.dev/docs/extensions/unity/terrain) 4 capacidades
  ```bash
  openupm add com.ivanmurzak.unity.mcp.terrain
  ```
- [AI Timeline](https://ai-game.dev/docs/extensions/unity/timeline) 5 capacidades
  ```bash
  openupm add com.ivanmurzak.unity.mcp.timeline
  ```

[Las 10 extensiones de Unity →](https://ai-game.dev/docs/extensions/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](https://ai-game.dev/es/docs/wiki/unity/troubleshooting).

**Mi cliente de IA se conecta pero no muestra herramientas**

Comprueba que el estado de Unity indique **Connected** y vuelve a conectar el cliente (en Claude Code, `/mcp`) o reinícialo. Si sigue sin mostrar nada, pulsa otra vez **Configure** para tu agente y reinicia el cliente.

**No aparece la ventana de AI Game Developer**

El plugin solo se carga cuando el proyecto compila. Revisa la Consola por si hay errores de compilación en cualquier parte del proyecto y vuelve a abrir el Editor. Que falten tipos de McpPlugin o ReflectorNet suele significar que la primera importación aún no ha terminado: espera o usa **Tools → AI Game Developer → Dependencies → Force Resolve NuGet DLLs**.

**Modo Custom: el servidor MCP local no arranca**

En el modo Custom, el plugin descarga `gamedev-mcp-server` en `Library/mcp-server/<platform>/`. Si un firewall o un proxy lo bloqueó, la ventana muestra un error del servidor con un botón **Download / Retry**. En el modo Cloud no hace falta ningún servidor local.

**Conflicto de puertos en el modo Custom**

Cada proyecto recibe un puerto local fijo entre 20000 y 29999, derivado de su ruta. Si otro proceso ya lo está usando, el servidor aparece como **External**: detén ese proceso o escribe otro puerto en **Server URL** y pulsa **Configure** de nuevo.

**Package Manager indica que el paquete necesita una versión de Unity más reciente**

El plugin necesita Unity 2022.3 o superior. Actualiza el proyecto o instala un Editor más reciente con `unity-mcp-cli install-unity`.

### Siguiente parada

[**Wiki de Unity →** Configuración, herramientas y RQL, herramientas personalizadas, la referencia de la CLI y mucho más.](https://ai-game.dev/es/docs/wiki/unity) [**Herramientas de Unity →** Todo lo que el agente puede hacer en Unity, con ejemplos.](https://ai-game.dev/docs/tools/unity) [**Buenas prácticas →** Cómo pedirle al agente tareas que hace bien.](https://ai-game.dev/docs/best-practices/unity)

---

Source (HTML): https://ai-game.dev/es/docs/unity-plugin-setup

Machine-translated (es) from the English page: https://ai-game.dev/docs/unity-plugin-setup