Cómo conectar Claude Code a Unity MCP: instalación y configuración

Qué cubre esta guía

Sigue estos cinco pasos para conectar Unity MCP a un proyecto local de Unity para que Claude CLI pueda operar, previsualizar y depurar el editor, no solo editar scripts en disco.

Cuando termines, deberías poder:

• Importar Unity MCP mediante el Package Manager con Add package from disk
• Completar la activación del plugin (cuenta o código de activación, según tu Mcp Panel)
• Iniciar el Unity MCP Server local (puerto predeterminado 6589)
• Copiar el comando CLI desde Quick setup, ejecutarlo en Claude CLI y confirmar la conexión MCP

Página de descarga: Unity MCP

Esta guía usa Claude CLI. Para Gemini CLI, elige el cliente correspondiente en Quick setup y copia su comando CLI de la misma forma.

Requisitos previos

Elemento	Notas
Unity	Se recomienda 2022.3+ / Unity 6 (sigue las notas de compatibilidad actuales para tu versión)
Paquete del plugin	Archivo de Unity MCP descargado y descomprimido
Activación	Cuenta + contraseña del plugin, o correo + código de activación (según Mcp Panel)
IDE de IA	Claude CLI (el mismo flujo para Gemini CLI)
Red local	El puente MCP normalmente se ejecuta en 127.0.0.1; no expongas el puerto públicamente

Paso 1: Descargar Unity MCP

Descarga el plugin desde el sitio o la página de versiones del proveedor de Unity MCP:

Página de descarga de ejemplo: https://www.vberai.com/game-engines/unity?ch=CQZLC2FG

Flujo sugerido:

1. Abre la página de descarga y obtén el archivo de Unity MCP
2. Guárdalo localmente y descomprímelo en una carpeta fija (el siguiente paso necesita el package.json dentro)
3. Confirma que package.json existe en la carpeta descomprimida antes de abrir Unity

Las diferencias de licencia y edición varían según el proveedor; sigue su documentación oficial.

Paso 2: Importar el paquete

1. Abre tu proyecto de Unity de destino
2. Menú Window → Package Manager
3. Haz clic en + en la esquina superior izquierda del panel Package Manager
4. Elige Add package from disk
5. Selecciona el archivo package.json de la carpeta descomprimida en el Paso 1

Tras una importación correcta, el paquete Unity MCP debería aparecer en la lista del Package Manager.

Paso 3: Activar unity-mcp

1. Menú Window → Unity MCP → Mcp Panel
2. En la pantalla de activación, haz una de estas cosas:
   • Inicia sesión con cuenta + contraseña
   • O introduce correo + código de activación
3. Cuando la activación se complete, abre la página de configuración del MCP Server (siguiente paso)

Sin activación, el servicio normalmente no se iniciará. Confirma que tu cuenta o código coincide con la versión del plugin que instalaste.

Paso 4: Iniciar unity-mcp-server

1. Después de la activación, abre la página de configuración de Unity MCP Server
2. Ajusta según sea necesario:
   • Puerto: predeterminado 6589
   • Idioma: según tu preferencia de interfaz
   • Inicio: sigue las opciones del panel (por ejemplo, inicio automático con el editor, si está disponible)
3. Haz clic en Start service
4. Cuando el panel muestre Running, Unity MCP Server está en marcha

Ahora tienes un puente MCP local; a continuación, configura Claude CLI.

Paso 5: Configurar Claude CLI

1. Abre Tool management
   • Revisa las herramientas expuestas por Unity MCP Server
   • Habilita solo lo que quieras que use el modelo
2. Abre Quick setup
   • Elige Claude CLI (Gemini CLI funciona igual; selecciona ese cliente)
   • Claude CLI / Gemini CLI no admiten Auto configure; haz clic en Copy en el CLI command que se muestra en el panel

3. Abre una terminal del sistema, pega y ejecuta el comando copiado (en un entorno donde Claude CLI esté instalado)
4. Vuelve a Claude CLI y confirma que unity-mcp (o el nombre registrado equivalente) aparece en la lista de MCP

Verificación rápida tras conectar

En Claude CLI, empieza con una comprobación de solo lectura, por ejemplo:

Lista los objetos raíz en la Jerarquía de la escena abierta actualmente en Unity.

Si la respuesta coincide con el editor, el puente está sano. Luego prueba una pequeña escritura (crea un GameObject vacío temporal y elimínalo) para confirmar permisos y selección de herramientas.

Preguntas frecuentes

¿Add package from disk no encuentra package.json?
Confirma que el Paso 1 descomprimió completamente el archivo y que seleccionaste package.json en la raíz de esa carpeta, no una extracción anidada.

¿La activación sigue fallando?
Comprueba que tu cuenta o código de activación sea válido, no esté caducado y esté vinculado al correo correcto; luego vuelve a intentarlo en Mcp Panel.

¿Iniciaste el servicio pero no aparece Running?
Asegúrate de que el puerto 6589 (o tu puerto personalizado) esté libre y que localhost no esté bloqueado. Confirma que la activación del Paso 3 se completó.

¿Claude CLI no muestra unity-mcp?
Confirma que Unity sigue mostrando Running; vuelve a Quick setup, copia el comando CLI de nuevo y ejecútalo por completo en la terminal. Asegúrate de haber elegido Claude CLI, no Cursor. Para Gemini CLI, elige Gemini CLI y copia el comando de ese cliente.

Próximos pasos

• Prueba una consulta de escena en lenguaje natural o una pequeña edición para aprender los límites de las herramientas
• Haz commit antes de cambios grandes; mantén el puente solo en localhost
• Patrones de prompts tras conectar: Unity MCP con Claude Code y Cursor