Instalación

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 instala y conecta el plugin por ti, sin terminal y sin Node.js en tu máquina.

1. Descarga la app 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 y proyectos y motores.

Opción 2: unity-mcp-cli#

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

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

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

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:

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.

Opción 3: OpenUPM#

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

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:

{
  "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.
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: conecta un cliente de IA y ejecuta tu primer prompt.
• Extensiones: añade paquetes de herramientas para Cinemachine, ProBuilder, Tilemap y más.
• Si algo falla durante la instalación, consulta Solución de problemas.