Conectar Claude con Unity vía MCP

MCP (Model Context Protocol) es un estándar abierto que permite a Claude conectarse con herramientas externas: bases de datos, editores de código, aplicaciones de diseño. Unity 6 incluye un servidor MCP oficial que le da a Claude acceso directo al editor: puede crear GameObjects, escribir scripts, modificar materiales y consultar el estado de la escena sin que tú tengas que copiar y pegar nada.

Qué es Unity MCP y para qué sirve

Cuando conectas Claude al editor de Unity vía MCP, puedes hacer cosas como estas directamente desde el chat:

• "Crea un cubo rojo en la posición (0, 1, 0) y añádele un Rigidbody."
• "Escribe un script que haga rotar este objeto 90 grados por segundo."
• "Dime cuántos objetos hay en la escena activa y cuáles tienen el tag Enemy."
• "Cambia el material de todos los objetos con el nombre 'Pared' por uno azul semitransparente."

Claude actúa como un asistente que tiene las manos dentro del editor. No es magia: ejecuta las mismas operaciones que tú harías desde el menú o desde código, pero a tu orden y en lenguaje natural.

Requisitos

• Unity 6000.0.42f1 o superior. El servidor MCP está integrado en Unity 6. En versiones anteriores no está disponible.
• Claude Desktop (o Claude Code 1.0+). Descarga Claude Desktop desde claude.ai/download.
• uv, el gestor de entornos de Python. Instálalo con: pip install uv (o brew install uv en Mac).
• Una suscripción de Claude activa (Pro, Max o Team).

Activar Unity MCP en el editor

Abre tu proyecto en Unity 6 y ve a Window → Unity MCP. Se abre una ventana con el estado del servidor. Haz clic en Start Server: Unity levanta un servidor local en el puerto 6400 por defecto y te muestra la ruta del socket.

Deja esa ventana abierta mientras trabajas. El servidor se detiene cuando cierras Unity.

Conectar Claude Desktop o Claude Code

Claude Desktop necesita saber que existe ese servidor MCP. Abre el archivo de configuración:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

Si el archivo no existe, créalo. Añade (o fusiona con lo que ya tengas) este bloque:

{
  "mcpServers": {
    "unity": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp-unity",
        "python",
        "-m",
        "mcp_unity"
      ]
    }
  }
}

Guarda el archivo y reinicia Claude Desktop. En la barra inferior del chat debería aparecer un icono de herramientas con "unity" listado.

Si usas Claude Code en lugar de Claude Desktop, ejecuta en la terminal:

claude mcp add unity -- uv run --with mcp-unity python -m mcp_unity

Cómo usarlo

Con Unity abierto y el servidor activo, abre Claude Desktop y empieza a pedir cosas en lenguaje natural. Algunos ejemplos que funcionan bien:

• Crear objetos: "Añade una esfera con el nombre 'Planeta' en el centro de la escena."
• Scripts: "Escribe un script de movimiento básico con WASD y asígnalo al GameObject llamado 'Player'."
• Consultas: "¿Qué componentes tiene el objeto seleccionado ahora mismo?"
• Modificaciones en masa: "Pon todos los objetos con el tag 'Enemigo' en la capa 'Enemies'."

Claude llama a las herramientas MCP, Unity las ejecuta y el resultado aparece en la escena al instante.

Lo que puede y lo que no puede hacer

Unity MCP da acceso a la mayoría de operaciones del editor, pero tiene límites reales:

• Puede: crear y modificar GameObjects, escribir y asignar scripts, cambiar materiales y colores, leer la jerarquía de la escena, guardar la escena.
• No puede: ejecutar el juego en Play Mode de forma autónoma, importar assets externos, acceder a las preferencias del editor ni modificar el ProjectSettings.

El punto más importante: Claude escribe el código C# que tú le pides, pero no lo compila ni lo prueba. Revisa siempre los scripts antes de darles al Play, especialmente si acceden a archivos del disco o hacen llamadas de red.

Si todavía no has hecho ningún juego, quizá te convenga empezar más abajo, con un juego sencillo en el navegador que la IA escribe entera: lo explicamos en crear un videojuego con IA.