# Unity MCP — AI Game Developer Wiki

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

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

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](https://github.com/IvanMurzak/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](https://ai-game.dev/es/docs/wiki/unity/tools-and-rql).

## Cómo encajan las piezas

| Pieza | Qué hace |
| --- | --- |
| Plugin Unity MCP | Se ejecuta en el Editor de Unity, expone las herramientas de IA y se conecta a un servidor MCP. |
| Servidor MCP | El 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 IA | Claude Code, Claude Desktop, Cursor, VS Code Copilot, Codex, Gemini, Rider y otros. Se conecta al mismo servidor. |
| `unity-mcp-cli` | La 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 Dev | La 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](https://ai-game.dev/es/docs/wiki/unity/configuration) 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](https://ai-game.dev/docs/app).

## Inicio rápido

La forma más sencilla es la app de escritorio: [descárgala](https://ai-game.dev/es/download), inicia sesión y abre tu proyecto de Unity. Instala el plugin y lo conecta por ti. La [wiki de la app](https://ai-game.dev/es/docs/wiki/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:

```bash
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](https://ai-game.dev/es/docs/wiki/unity/getting-started) recorre los mismos pasos con explicaciones.

## Páginas de esta sección

- [Instalación](https://ai-game.dev/es/docs/wiki/unity/installation): todas las formas de instalar el plugin (la app, `unity-mcp-cli`, OpenUPM, el instalador `.unitypackage`) y cómo desinstalarlo.
- [Primeros pasos](https://ai-game.dev/es/docs/wiki/unity/getting-started): tu primera conexión y tus primeros prompts.
- [Conectar clientes de IA](https://ai-game.dev/es/docs/wiki/unity/connecting-ai-clients): endpoints Cloud vs locales, inicio de sesión, URLs fijadas y el configurador para cada agente.
- [Configuración](https://ai-game.dev/es/docs/wiki/unity/configuration): 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](https://ai-game.dev/es/docs/wiki/unity/tools-and-rql): qué puede hacer el agente en el Editor.
- [Herramientas personalizadas](https://ai-game.dev/es/docs/wiki/unity/custom-tools): convierte tus propios métodos de C# en herramientas de IA, prompts y skills, incluso en un juego en ejecución.
- [Extensiones](https://ai-game.dev/es/docs/wiki/unity/extensions): paquetes opcionales para Animation, Cinemachine, Input System, Navigation, ProBuilder, Terrain, Tilemap, Timeline y más.
- [Referencia de unity-mcp-cli](https://ai-game.dev/es/docs/wiki/unity/cli): cada comando y cada flag.
- [Solución de problemas](https://ai-game.dev/es/docs/wiki/unity/troubleshooting): soluciones a problemas comunes.
- [Preguntas frecuentes](https://ai-game.dev/es/docs/wiki/unity/faq): respuestas breves a preguntas comunes.

## Más en el sitio

- [Catálogo de herramientas de Unity](https://ai-game.dev/docs/tools/unity) y la [referencia de RQL](https://ai-game.dev/docs/rql).
- [Catálogo de extensiones de Unity](https://ai-game.dev/docs/extensions/unity).
- [Buenas prácticas de Unity](https://ai-game.dev/docs/best-practices/unity) para los prompts y la configuración del proyecto.
- [Endpoint MCP](https://ai-game.dev/es/mcp-endpoint-info) con fragmentos de configuración para cada cliente compatible.
- [Autenticación](https://ai-game.dev/docs/auth), el [quickstart](https://ai-game.dev/es/docs/quickstart) y la [página del motor Unity](https://ai-game.dev/es/engines/unity).
- Los otros motores: [Unreal MCP](https://ai-game.dev/es/docs/wiki/unreal) y [Godot MCP](https://ai-game.dev/es/docs/wiki/godot).

- [**Instalación** Instala Unity MCP (AI Game Developer) en un proyecto de Unity con la app de escritorio, unity-mcp-cli, OpenUPM o el instalador .unitypackage.](https://ai-game.dev/es/docs/wiki/unity/installation)
- [**Primeros pasos** Conecta tu primer agente de IA a Unity con Unity MCP, comprueba la conexión y prueba tus primeros prompts en Claude Code, Cursor o Copilot.](https://ai-game.dev/es/docs/wiki/unity/getting-started)
- [**Conectar clientes de IA** Conecta Claude Code, Cursor, Copilot, Codex, Gemini y otros clientes MCP a Unity MCP vía el endpoint en la nube de ai-game.dev o un servidor local.](https://ai-game.dev/es/docs/wiki/unity/connecting-ai-clients)
- [**Configuración** Configura Unity MCP en la ventana de AI Game Developer: modos Cloud y Custom, servidor local, puerto, transporte, autorización, herramientas, overrides y CI.](https://ai-game.dev/es/docs/wiki/unity/configuration)
- [**Herramientas y RQL** Qué puede hacer un agente de IA en el Editor de Unity con Unity MCP: RQL, capturas de pantalla, scripts de C#, tests, paquetes y profiling.](https://ai-game.dev/es/docs/wiki/unity/tools-and-rql)
- [**Herramientas personalizadas** Escribe herramientas, prompts, recursos y skills de Unity MCP en C# con atributos AiTool, ejecútalas en el hilo principal y úsalas en el juego final.](https://ai-game.dev/es/docs/wiki/unity/custom-tools)
- [**Extensiones** Las extensiones de Unity MCP añaden soporte para Animation, Cinemachine, Input System, Navigation, ProBuilder, Splines, Terrain, Tilemap, Timeline y partículas.](https://ai-game.dev/es/docs/wiki/unity/extensions)
- [**Referencia de unity-mcp-cli** Referencia de comandos de unity-mcp-cli: instala Unity MCP, inicia sesión, configura agentes de IA y ejecuta herramientas y C# desde la terminal.](https://ai-game.dev/es/docs/wiki/unity/cli)
- [**Solución de problemas** Soluciona fallos habituales de Unity MCP: herramientas ausentes, errores de acceso y conexión, descargas del servidor y conflictos de puertos.](https://ai-game.dev/es/docs/wiki/unity/troubleshooting)
- [**FAQ** Respuestas a las dudas más comunes sobre Unity MCP: versiones compatibles, clientes de IA, modo Cloud o local, coste, privacidad, builds, CI y RQL.](https://ai-game.dev/es/docs/wiki/unity/faq)

---

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

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