Esta página se tradujo automáticamente del inglés. Lee el original en inglés.

Unity MCP

Unity MCP conecta Claude Code, Cursor, Copilot y otros agentes de IA al Editor de Unity. Instalación, configuración, herramientas y CLI.

Actualizado el 4 de noviembre de 2026 Ver como Markdown

Unity MCP es el plugin de Unity de AI Game Developer. Lleva la IA al Editor de Unity: un agente como Claude Code, Cursor, GitHub Copilot, Codex o Gemini puede leer y cambiar tus escenas, GameObjects, componentes, prefabs y assets, escribir scripts de C#, ejecutar fragmentos de C#, ejecutar tus tests de EditMode y PlayMode, leer la Consola y hacer capturas de pantalla que puede mirar. Esta wiki explica cómo instalar el plugin, conectar un cliente de IA y usarlo en el día a día.

Qué es Unity MCP

Unity MCP es un paquete de Unity, com.ivanmurzak.unity.mcp, que aparece en el Package Manager como AI Game Developer — MCP. Se ejecuta dentro del Editor de Unity (y, si quieres, dentro de tu juego compilado). Expone un conjunto de herramientas mediante el Model Context Protocol (MCP), el estándar abierto que usan los clientes de IA para llamar a herramientas externas. El agente con el que hablas ve esas herramientas y las llama para hacer el trabajo que le pides.

El plugin es de código abierto bajo la licencia Apache-2.0 y vive en el repositorio Unity-MCP. Comparte sus bibliotecas de MCP y de reflexión con Unreal MCP y Godot MCP, así que los tres plugins de motor funcionan igual y usan la misma cuenta de ai-game.dev.

Desde la versión 1.0.0, la mayor parte del trabajo en el Editor pasa por RQL, un lenguaje de consulta sobre los datos del Editor: una herramienta rql-query lee, una herramienta rql-mutate cambia y rql-schema describe lo que hay disponible. Un pequeño conjunto de herramientas específicas cubre capturas de pantalla, scripts, tests y paquetes. Consulta Herramientas y RQL.

Cómo encajan las piezas

PiezaQué hace
Plugin Unity MCPSe ejecuta en el Editor de Unity, expone las herramientas de IA y se conecta a un servidor MCP.
Servidor MCPEl servidor alojado en ai-game.dev (modo Cloud, el predeterminado), o un gamedev-mcp-server local que el plugin descarga e inicia por ti (modo Custom).
Cliente de IAClaude Code, Claude Desktop, Cursor, VS Code Copilot, Codex, Gemini, Rider y otros. Se conecta al mismo servidor.
unity-mcp-cliLa herramienta de línea de comandos de npm que instala el plugin, inicia tu sesión, escribe las configuraciones de los clientes de IA, abre Unity y llama a herramientas desde una terminal.
App de AI Game DevLa app de escritorio que instala el plugin, abre el Editor y ejecuta el agente de IA por ti.

En modo Cloud, el Editor y tu cliente de IA se conectan ambos a https://ai-game.dev/mcp, y solo tienes que iniciar sesión una vez con tu cuenta de ai-game.dev. En modo Custom, el plugin ejecuta un servidor MCP local en tu máquina, así que todo se queda en tu ordenador. Configuración explica ambos.

Requisitos de un vistazo

  • Unity 2022.3 o superior, incluido Unity 6.
  • Una ruta de proyecto sin espacios (el plugin registra un error al iniciar si la ruta contiene alguno).
  • Acceso a internet en el primer uso: el plugin descarga sus dependencias de .NET desde NuGet y, en modo Custom, el binario de su servidor MCP.
  • Un cliente de IA que hable MCP, o la app AI Game Dev.

Inicio rápido

La forma más sencilla es la app de escritorio: descárgala, inicia sesión y abre tu proyecto de Unity. Instala el plugin y lo conecta por ti. La wiki de la app cubre ese flujo.

Si prefieres una terminal y tu propio cliente de IA, estos comandos llevan un proyecto de Unity a un agente conectado:

npm install -g unity-mcp-cli
unity-mcp-cli install-plugin ./MyUnityProject
unity-mcp-cli login
unity-mcp-cli setup-mcp claude-code ./MyUnityProject
unity-mcp-cli open ./MyUnityProject

Luego pide a tu agente algo como "Crea 3 cubos en un círculo con radio 2". Primeros pasos recorre los mismos pasos con explicaciones.

Páginas de esta sección

  • Instalación: todas las formas de instalar el plugin (la app, unity-mcp-cli, OpenUPM, el instalador .unitypackage) y cómo desinstalarlo.
  • Primeros pasos: tu primera conexión y tus primeros prompts.
  • Conectar clientes de IA: endpoints Cloud vs locales, inicio de sesión, URLs fijadas y el configurador para cada agente.
  • Configuración: la ventana AI Game Developer, los modos de conexión, los puertos, el archivo de configuración, las anulaciones por variables de entorno y las builds.
  • Herramientas y RQL: qué puede hacer el agente en el Editor.
  • Herramientas personalizadas: convierte tus propios métodos de C# en herramientas de IA, prompts y skills, incluso en un juego en ejecución.
  • Extensiones: paquetes opcionales para Animation, Cinemachine, Input System, Navigation, ProBuilder, Terrain, Tilemap, Timeline y más.
  • Referencia de unity-mcp-cli: cada comando y cada flag.
  • Solución de problemas: soluciones a problemas comunes.
  • Preguntas frecuentes: respuestas breves a preguntas comunes.

Más en el sitio