Servidor MCP para Unity: configuración con Claude Code, costos y opciones gratuitas

Escribir "añade un punto de aparición y corrige la referencia nula en mi script de inventario" en una terminal y ver cómo el Editor de Unity lo hace solo parece un truco de demostración. No lo es. Un servidor MCP para Unity da a Claude Code manos dentro del Editor: puede leer la Console, crear GameObjects, editar scripts de C# y ejecutar pruebas sin que tengas que pegar nada de un lado a otro. Lo que la mayoría de tutoriales omiten es que el terreno ha cambiado. Unity ha dejado obsoleto el servidor MCP de su propio paquete AI Assistant, han seguido creciendo los servidores gratuitos de la comunidad, y la factura real depende mucho menos del servidor que del modelo al que lo conectas.

Esta página recorre la configuración de cada ruta, el costo real en dólares y en tokens, y las opciones gratuitas que aguantan el uso diario. Los comandos, las versiones y los precios se revisaron en octubre de 2026 con la documentación de Unity, los repositorios de los proyectos y la página de precios de Claude.

💡 Respuesta corta: todos los servidores MCP para Unity que aparecen aquí son gratuitos. Claude Code no lo es, porque necesita un plan de Claude de pago o crédito de API. La configuración más barata y sólida es un servidor gratuito de la comunidad más el plan de Claude que quizá ya tengas.

Qué servidor MCP para Unity deberías elegir

En casi todas las búsquedas aparecen cuatro nombres. Uno es oficial y ahora está obsoleto. Tres son de código abierto y no se ven afectados por ese aviso. Elegir entre ellos depende de tu versión de Unity, de si prefieres tener Python o Node en el equipo y de cuánto quieres seguir la hoja de ruta de Unity.

El servidor oficial y su obsolescencia

Unity incluye un servidor MCP dentro del paquete com.unity.ai.assistant. Necesita Unity 6 (6000.0) o posterior y está en Edit > Project Settings > AI > Unity MCP. La documentación actual empieza con una frase directa: "Unity MCP server is deprecated. Use the Unity command-line interface (CLI) instead."

Lee el alcance con atención, porque es más estrecho de lo que parece:

La CLI de Unity incluye su propio servidor MCP, basado en el paquete Unity Pipeline, y habla el mismo protocolo, así que tu cliente se conecta igual que hoy. Unity afirma que este modo MCP no forma parte de la obsolescencia y que "sigue siendo totalmente compatible".

Tres servidores de la comunidad comparados

MCP for Unity expone 48 puntos de entrada de herramientas para escenas, GameObjects, scripts de C#, assets, pruebas, perfilado y builds. También funciona con Claude Desktop, VS Code, Cursor, Windsurf, Cline y Gemini CLI, así que una sola instalación sirve para el cliente que pruebes después. Unity-MCP anuncia más de 70 herramientas integradas para proyecto y assets, escena y jerarquía, scripting y editor, y perfilado. mcp-unity añade operaciones por lotes con reversión, útil cuando un agente toca muchos objetos a la vez.

Una regla práctica: con Unity 2021 o 2022, elige MCP for Unity. Con Unity 6 y Node ya instalado, mcp-unity es la opción más sencilla. Si quieres el mayor número de herramientas de serie, mira Unity-MCP.

Configuración de Claude Code paso a paso

Si aún no has instalado Claude Code, hazlo primero: npm install -g @anthropic-ai/claude-code, y luego ejecuta claude --version para confirmar que responde.

Ruta 1: la CLI de Unity, el camino oficial de Unity

Este es el camino al que Unity envía ahora a todos, y no cuesta nada. Unity afirma que la CLI "es gratuita y está separada de Unity AI" y no necesita una suscripción a Unity AI. Para controlar un Editor en ejecución, el proyecto debe usar Unity 6.0 LTS o posterior.

1. Instala la CLI de Unity desde la documentación de Unity.
2. Ejecuta unity pipeline install para añadir el paquete Unity Pipeline.
3. Ejecuta unity mcp configure claude para escribir la configuración de Claude Code.
4. Ejecuta unity mcp configure --list para ver todos los clientes compatibles y su estado.
5. Ejecuta unity skill install <agent-name> para añadir skills de Unity a tu agente.

El servidor de pipeline local acepta conexiones solo desde localhost, y la CLI controla un Editor local sin conexión.

💡 Claude Code puede ejecutar comandos de shell, así que quizá no necesites MCP. unity command y unity eval controlan el Editor directamente y, según Unity, son más rápidos y gastan menos tokens que MCP. Reserva el modo MCP para los entornos que no puedan ejecutar comandos de shell.

¿Todavía usas el servidor antiguo del Editor? Abre Edit > Project Settings > AI > Unity MCP, comprueba que Unity Bridge muestra Running, expande Integrations, selecciona Claude Code y pulsa Configure. Para una entrada manual, apunta Claude Code al binario relay con el argumento --mcp: %USERPROFILE%\.unity\relay\relay_win.exe en Windows. La primera conexión muestra una solicitud pendiente en Unity, y pulsas Accept una sola vez. La propia página de Unity también indica como requisito para este servidor una prueba activa o una suscripción a sus herramientas de IA.

Ruta 2: MCP for Unity

1. En Unity, abre Window > Package Manager, pulsa +, elige Add package from git URL y pega https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main. La alternativa de OpenUPM es openupm add com.coplaydev.unity-mcp.
2. Instala Python 3.10 o posterior y uv.
3. En el Editor, ve a Window > MCP for Unity y elige Configure All Detected Clients.
4. Abre Claude Code en la carpeta del proyecto y ejecuta claude mcp list para confirmar la conexión.

Ruta 3: Coplay MCP mediante uvx

Coplay publica una guía aparte para Claude Code. Pide Unity 2022 o posterior, Node.js con npm y Python 3.11 o posterior. Añade el paquete de Unity desde https://github.com/CoplayDev/unity-plugin.git#beta y luego registra el servidor en una sola línea:

claude mcp add --scope user --transport stdio coplay-mcp --env MCP_TOOL_TIMEOUT=720000 -- uvx --python ">=3.11" coplay-mcp-server@latest

Copiar prompt

El valor MCP_TOOL_TIMEOUT=720000 da a cada llamada de herramienta doce minutos, lo que importa en builds y pruebas largas. Esa guía no incluye precios, así que revisa el sitio de Coplay antes de confiar en ella para un equipo.

Configuraciones manuales para los demás

Unity-MCP se registra con un solo comando, donde el binario está dentro de la carpeta Library de tu proyecto:

claude mcp add ai-game-developer "<unityProjectPath>/Library/mcp-server/win-x64/gamedev-mcp-server.exe" port=<port> client-transport=stdio

Copiar prompt

mcp-unity se instala desde https://github.com/CoderGamester/mcp-unity.git, se inicia desde Tools > MCP Unity > Server Window y lee un archivo .mcp.json en la raíz del proyecto:

{
  "mcpServers": {
    "mcp-unity": {
      "command": "node",
      "args": ["Library/PackageCache/com.gamelovers.mcp-unity@<hash>/Server~/build/index.js"]
    }
  }
}

Copiar prompt

Sustituye <hash> por el nombre real de la carpeta de tu caché de paquetes.

Comprueba que funciona

Ejecuta claude mcp list. Una entrada en buen estado se ve así: coplay-mcp: ✓ Connected. Después prueba toda la cadena con la solicitud que sugiere el propio Unity: "Read the Unity console messages and summarize any warnings or errors." Si Claude devuelve el contenido real de tu Console, el puente funciona.

Lo que de verdad cuesta

El servidor es la parte barata. El modelo que hay detrás es el que factura.

El servidor es gratuito

MCP for Unity y mcp-unity usan la licencia MIT. Unity-MCP usa Apache-2.0. La CLI de Unity también es gratuita, y instalarla no requiere una suscripción a Unity AI. Ninguno cobra por llamada, por puesto ni por escena.

Plan de Claude Code o API

Claude Code está incluido en todos los planes de pago de Claude y comparte los límites de uso de ese plan, lo que deja fuera el plan Free.

Las cuentas de la API son fáciles de comprobar. Una sesión que lee 400.000 tokens de entrada y escribe 40.000 tokens de salida con Sonnet 5.5 cuesta $0,80 más $0,40, es decir, $1,20. Las jerarquías de escenas y los volcados de la Console son los que inflan la entrada, así que pide lecturas acotadas, como una escena o un script cada vez.

Créditos de Unity AI en la ruta oficial

El producto de IA de Unity es una compra aparte. Los usuarios personales obtienen una prueba de 14 días con 1.000 créditos y, después, $10 al mes salvo que cancelen. Los puestos Pro, Enterprise e Industry incluyen una cuota mensual de créditos que no se acumula. La pasarela de IA de Unity permite conectar Claude Code con tu suscripción existente de Anthropic sin gastar créditos de Unity AI, así que un plan de Claude más la CLI evita pagar dos veces.

Opciones gratuitas que de verdad funcionan

"Gratis" necesita una definición aquí. Los servidores son gratuitos. El modelo es lo que pagas, salvo que ya lo pagues.

Servidor gratuito, plan que ya tienes

Como MCP for Unity funciona con Claude Desktop, VS Code, Cursor, Windsurf, Cline y Gemini CLI, puedes conectarlo al asistente que ya pagas. La capa MCP suma $0. Si tienes el plan Claude Pro, Claude Code ya está incluido, y todo el conjunto cuesta los $20 que ya gastabas.

Modelos abiertos, con reservas

Algunos clientes MCP pueden enviar solicitudes a un modelo de pesos abiertos alojado por ti. Tómalo como un proyecto de fin de semana, no como una configuración lista para usar: la llamada a herramientas es donde los modelos locales pequeños tropiezan, y el propio Unity señala que algunos modelos no componen bien las líneas de comandos. Prueba con la solicitud de resumen de la Console de arriba antes de confiarle una escena.

La CLI de Unity también funciona sin ningún agente. Instala y gestiona versiones del Editor, gestiona proyectos, ejecuta builds sin interfaz y lanza conjuntos de pruebas, lo que la convierte por sí sola en una herramienta gratuita de integración continua.

Para la parte de pensamiento únicamente, como redactar un script de C# o leer un texto de error, pueden servir modelos de chat alojados en PicassoIA como GPT OSS 20B o Granite 8B Code Instruct 128K. Nunca tocan tu Editor, así que copias el código a mano.

Cómo solucionar los errores de conexión habituales

La mayoría de los fallos vienen de una incompatibilidad de versiones o de una ruta, no de Claude. Revisa esta lista en orden.

💡 Cambia una sola cosa a la vez y vuelve a ejecutar la solicitud de resumen de la Console después de cada cambio. Cambiar tres ajustes a la vez a ciegas es lo que convierte un arreglo de diez minutos en una tarde entera.

Arte de juego alrededor de tu flujo de trabajo con MCP

Un servidor MCP mueve objetos por el Editor. No pinta tus texturas ni esculpe tus props, así que esos assets llegan de otro sitio.

Concept art y texturas con IA

Los modelos de imagen cubren el hueco entre "necesito un muro de piedra cubierto de musgo" y un archivo en tu carpeta Assets. Genera imágenes de referencia o candidatos de textura plana con Seedream 4.5, Qwen Image 3 o GPT Image 2, limpia los defectos con PicassoIA Image Editor Pro, luego importa los archivos y pídele a Claude, a través de MCP, que cree un material y lo asigne a los objetos correctos.

Revisa las uniones antes de repetir cualquier textura en mosaico. Una sola imagen generada no ofrece garantía de que se repita limpiamente, así que prueba primero el material en una superficie grande.

Dónde encajan los modelos 3D

El catálogo de PicassoIA se centra en modelos de imagen, video, audio y lenguaje, y una búsqueda en su categoría 3D no devolvió ningún modelo en el momento de escribir esto, así que no te entregará una malla. Lo que sí puede hacer es generar las referencias que necesita un artista 3D o una herramienta de mallas, como vistas frontal, lateral y de tres cuartos de un prop. Mientras tanto, Claude puede esbozar un nivel con formas básicas mediante MCP, y tú sustituyes las mallas reales a medida que llegan.

Cómo usar Sonnet 5 en PicassoIA

Claude Sonnet 5 no controlará tu Editor, pero es una forma rápida de redactar y depurar C# antes de que un script llegue a Unity.

1. Abre la página del modelo Claude Sonnet 5.
2. Rellena una vez el System Prompt: "You write C# for Unity 6. Return one script per code block. No placeholders."
3. Pega el error de la Console y el script en Prompt. También puedes adjuntar una captura de la Console como entrada opcional Image.
4. Define Effort. El valor predeterminado es low, que omite el pensamiento extendido para obtener la respuesta más rápida y barata. Usa high cuando un error abarque varios scripts, y max para los más tercos.
5. Deja Max Tokens en el valor predeterminado de 8.192 salvo que un script largo se corte.
6. Copia la salida en Unity, o pégala en Claude Code como especificación de lo que hay que construir.

💡 La entrada de imagen reduce las imágenes a 0,5 megapíxeles por defecto. Si el texto de la Console se ve borroso en la respuesta, recorta la captura a las líneas del error en lugar de enviar la ventana completa.

¿Prefieres otro modelo? Claude Opus 4.7, Claude 4.5 Haiku y Claude Fable 5 están en la misma colección de modelos de lenguaje.

Crea tu propio arte de juego

Ya tienes un camino funcional desde una frase en la terminal hasta una escena modificada, y una visión clara de lo que cuesta cada pieza. La mitad que falta es el arte que llena la escena.

Abre PicassoIA y pruébalo en tu propio proyecto. Empieza con un prop que llevas tiempo posponiendo, escribe un prompt corto para él en Seedream 4.5, compáralo con el mismo prompt en Qwen Image 3 y quédate con el que encaje en tu escena. Luego deja que tu servidor MCP para Unity lo coloque. Explora la lista completa en picassoia.com/en/all-models y haz algunos experimentos antes de tu próximo build.