# Instalación — Unity · AI Game Developer Wiki

Instala Unity MCP (AI Game Developer) en un proyecto de Unity con la app de escritorio, unity-mcp-cli, OpenUPM o el instalador .unitypackage.

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

Esta página muestra todas las formas de añadir el plugin Unity MCP a un proyecto de Unity, qué hace cada una en tu proyecto y cómo quitar el plugin de nuevo. Todas las vías instalan el mismo paquete, `com.ivanmurzak.unity.mcp`, desde el registro de OpenUPM, así que puedes elegir la que mejor encaje con tu flujo de trabajo.

## Requisitos

- **Unity 2022.3 o superior.** El paquete declara `2022.3` como su versión mínima; las versiones de Unity 6 son compatibles.
- **Una ruta de proyecto sin espacios.** `C:/Projects/MyGame` está bien, `C:/My Projects/My Game` no. El plugin registra un error al iniciar cuando la ruta contiene un espacio.
- **Una ruta de proyecto corta en Windows.** El plugin copia sus DLL de NuGet a `Assets/Plugins/NuGet`. Si la ruta resultante superara el límite de 260 caracteres de Windows, la instalación se detiene y te pide mover el proyecto a una carpeta más corta.
- **Acceso a Internet en la primera apertura.** El plugin descarga sus dependencias de .NET desde NuGet y, en modo Custom, el binario de su servidor MCP desde GitHub.
- Solo para `unity-mcp-cli`: **Node.js** `^20.19.0` o `>=22.12.0`.

## Opción 1: la app de escritorio de AI Game Dev (recomendada)

La [app de AI Game Dev](https://ai-game.dev/docs/app) instala y conecta el plugin por ti, sin terminal y sin Node.js en tu máquina.

1. [Descarga la app](https://ai-game.dev/es/download) e inicia sesión con tu cuenta de ai-game.dev.
2. Abre la carpeta de tu proyecto de Unity en la app. La app detecta que es un proyecto de Unity.
3. Haz clic en **Install Package**. La app añade el plugin a `Packages/manifest.json` en la última versión publicada en OpenUPM y nunca degrada una versión más reciente que ya tengas. Un proyecto que crees desde la app incluye el plugin automáticamente.
4. Abre el Editor desde la app. La app pasa tu sesión, así que el plugin se conecta a través de ai-game.dev sin un inicio de sesión aparte.

La app también instala extensiones y ejecuta el propio agente de IA, por lo que no necesitas un cliente MCP aparte. Los detalles están en la wiki de la app: [instalación](https://ai-game.dev/es/docs/wiki/app/installation) y [proyectos y motores](https://ai-game.dev/es/docs/wiki/app/projects-and-engines).

## Opción 2: unity-mcp-cli

`unity-mcp-cli` edita `Packages/manifest.json` directamente, así que Unity no necesita estar abierto:

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

También puedes ejecutarlo sin una instalación global:

```bash
npx unity-mcp-cli install-plugin ./MyUnityProject
```

`install-plugin` añade el registro con ámbito de OpenUPM con los ámbitos `com.ivanmurzak` y `extensions.unity`, añade `com.ivanmurzak.unity.mcp` a `dependencies` en la última versión de OpenUPM y nunca degrada una versión superior que ya esté instalada. Pasa `--plugin-version <version>` para fijar una versión. La ruta es opcional cuando ejecutas el comando desde la carpeta del proyecto.

La CLI también puede instalar Unity y crear un proyecto primero:

```bash
unity-mcp-cli install-unity
unity-mcp-cli create-project ./MyUnityProject
```

Si falta Unity Hub, la CLI lo instala. Después abre el proyecto en Unity para que el Package Manager resuelva el paquete. Todos los comandos están en la [referencia de la CLI](https://ai-game.dev/es/docs/wiki/unity/cli).

## Opción 3: OpenUPM

Con la [CLI de OpenUPM](https://openupm.com/) instalada, ejecuta esto en la carpeta del proyecto:

```bash
openupm add com.ivanmurzak.unity.mcp
```

Sin la CLI de OpenUPM, añade tú mismo el registro y la dependencia a `Packages/manifest.json`. Usa la versión que se muestra en la [página del paquete en OpenUPM](https://openupm.com/packages/com.ivanmurzak.unity.mcp/):

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

Combina estas entradas con tu archivo existente; no sustituyas las demás dependencias.

## Opción 4: el instalador .unitypackage

1. Descarga [AI-Game-Dev-Installer.unitypackage](https://github.com/IvanMurzak/Unity-MCP/releases/latest/download/AI-Game-Dev-Installer.unitypackage).
2. Abre tu proyecto en Unity.
3. Haz doble clic en el archivo, o usa **Assets > Import Package > Custom Package** y selecciónalo.
4. Haz clic en **Import**.

El instalador es un pequeño script de editor. Añade el registro con ámbito de OpenUPM y la dependencia del plugin a `Packages/manifest.json`, y después se elimina a sí mismo de `Assets`. Luego, el Package Manager descarga el paquete real.

## Qué ocurre en la primera apertura

Una vez que llega el paquete, el plugin se prepara:

- Descarga las bibliotecas de .NET que necesita (la biblioteca del plugin MCP, ReflectorNet, RQL, SignalR, System.Text.Json y otras) desde NuGet a `Assets/Plugins/NuGet`, con una caché en `Library/NuGetCache`, y Unity recompila una vez. Si esas DLL se desincronizan alguna vez, usa **Tools > AI Game Developer > Dependencies > Force Resolve NuGet DLLs**.
- Descarga el binario `gamedev-mcp-server` para tu plataforma desde GitHub a `Library/mcp-server/<platform>/` (por ejemplo `win-x64`, `osx-arm64` o `linux-x64`). El servidor solo se inicia en modo Custom con el transporte HTTP; el modo Cloud, que es el predeterminado, no inicia ningún servidor local.
- La ventana **AI Game Developer** está disponible en **Window > AI Game Developer — MCP** (atajo Ctrl+Alt+A, o Cmd+Option+A en macOS). La barra de herramientas de la Scene View también incluye un botón de superposición **AI** que la abre.

`Library/` se excluye del control de versiones de forma predeterminada, así que el binario del servidor nunca se confirma. En entornos de CI, el plugin omite la descarga e inicio del servidor.

## Actualizar el plugin

Cuando hay una versión más reciente en OpenUPM, el plugin muestra una ventana emergente de actualización al iniciar el Editor. Puedes comprobarlo manualmente con **Tools > AI Game Developer > Updates > Check for Updates**. Para actualizar, cambia la versión en el Package Manager, vuelve a ejecutar `unity-mcp-cli install-plugin` (instala la última) o deja que la app de escritorio lo actualice.

En equipos donde una sola persona controla la versión del plugin, abre **Edit > Project Settings > AI Game Developer** y activa **Disable update notifications for the entire team**. El ajuste se guarda en `ProjectSettings/AI-Game-Developer-UpdateSettings.asset`; confirma ese archivo. La misma opción está en **Tools > AI Game Developer > Updates > Disable Update Notifications (Team)**.

## Desinstalación

1. Abre **Window > Package Manager**, selecciona **AI Game Developer — MCP** y haz clic en **Remove**, o ejecuta `unity-mcp-cli remove-plugin ./MyUnityProject`. La CLI conserva el registro con ámbito, porque otros paquetes pueden usarlo.
2. Cierra Unity y elimina la carpeta `Assets/Plugins/NuGet` y su archivo `Assets/Plugins/NuGet.meta`.

## Próximos pasos

- [Primeros pasos](https://ai-game.dev/es/docs/wiki/unity/getting-started): conecta un cliente de IA y ejecuta tu primer prompt.
- [Extensiones](https://ai-game.dev/es/docs/wiki/unity/extensions): añade paquetes de herramientas para Cinemachine, ProBuilder, Tilemap y más.
- Si algo falla durante la instalación, consulta [Solución de problemas](https://ai-game.dev/es/docs/wiki/unity/troubleshooting).

---

Source (HTML): https://ai-game.dev/es/docs/wiki/unity/installation

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