← Volver al blog

Conecta Codex o ChatGPT a Unity MCP

Conecta Codex o ChatGPT a Unity MCP: pasos de Unity según la guía de instalación. Codex Open/Copy. ChatGPT STDIO: relay, --port, raíz de Assets. Verifica la Hi…

Publicado
  • unity
  • mcp
  • codex
  • chatgpt
  • tutorial
  • unity-mcp
  • ai

Qué cubre esta guía

¿Cómo conectas Codex o ChatGPT a Unity MCP? Los pasos del lado de Unity (importar, activar, iniciar el servidor) coinciden con Unity MCP install y Claude Code + Unity MCP. Esta guía es solo de configuración del cliente MCP: Codex Open/Copy y ChatGPT configuración STDIO.

Dos rutas:

  1. Codex CLI — en One-click Configuration, elige Codex CLI, luego Open (automático) o Copy de un fragmento de config.toml
  2. ChatGPT de escritorio o web — sin Open; traslada los ajustes del relay copiados al formulario MCP STDIO (comando, argumentos, directorio de trabajo del proyecto Unity)

Al terminar, deberías tener:

  • Unity MCP Server en estado Running en el editor, con el puerto mostrado en el panel
  • unity-mcp (o equivalente) registrado en el cliente con las herramientas visibles
  • Un prompt de solo lectura que liste los GameObjects raíz en la Hierarchy de la escena activa

Producto: Unity MCP

Requisitos previos

ElementoNotas
UnitySe recomienda 2022.3+ / Unity 6 (consulta las notas de soporte actuales del proveedor)
Unity MCPImportado y activado (guía de instalación)
Servidor en ejecuciónEl panel muestra Running; anota el puerto (6589 es un valor predeterminado común; usa el de tu panel)
Codex CLI o ChatGPTSoporte MCP con un servidor STDIO personalizado
Proyecto UnityEl proyecto que quieres que use el agente está abierto en Unity
Red localEl bridge suele escuchar en 127.0.0.1; no expongas el puerto en internet público

El valor de --port debe coincidir con el panel de Unity MCP, no con un número fijo de un blog o una captura.

Parte 1: Unity (igual que la guía de instalación)

Si Unity MCP aún no está configurado, sigue Unity MCP install: Add package from disk → activa en el panel MCP → Start service hasta que esté Running → habilita las herramientas en Tool management.

Los pasos siguientes asumen que Unity ya está Running.

Parte 2: Codex CLI

  1. Panel de Unity MCP → One-click Configuration → Codex CLI
  2. Open para escribir la configuración MCP, o Copy para el config.toml manual
  3. Solo como ejemplo de forma; usa tus rutas y puerto copiados (las rutas de Windows difieren de macOS):
[mcp_servers.unity-mcp]
command = "/Users/<you>/.unitymcp/relay/<relay-id>/unity-mcp-relay"
args = ["--stdio", "--port", "<panel-port>"]
  1. Reinicia Codex CLI o recarga MCP según la documentación de Codex
  2. Confirma que aparecen unity-mcp y sus herramientas

Para el contexto completo de Unity + CLI, consulta Claude Code + Unity MCP (mismos pasos de Unity, cliente distinto).

Parte 3: ChatGPT de escritorio o web

En el panel de Unity MCP, usa Codex CLI → Copy para los ajustes del relay, luego traslada los campos TOML a ChatGPT. Al añadir un servidor puedes definir Name y Type (STDIO). Al actualizar una entrada Unity-mcp existente, los campos siguientes coinciden con la captura.

Interfaz de ChatGPT (inglés)Valor
Name (al añadir)unity-mcp (igual que el nombre de la sección TOML)
Type (al añadir)STDIO (no HTTP/SSE)
Start commandRuta completa desde command = "..." hasta unity-mcp-relay (usa la salida de Copy en Windows, Linux o macOS)
ParametersTres líneas: --stdio → --port → puerto numérico del panel
Environment variablesDéjalo vacío
Environment variable inheritanceDéjalo vacío
Working directoryRaíz del proyecto Unity (carpeta que contiene Assets). Evita valores predeterminados genéricos como ~/code

Referencia de la interfaz de ChatGPT de escritorio

ChatGPT de escritorio: Plug-ins → MCP → Update Unity-mcp — comando de inicio, tres parámetros (--stdio, --port, número de puerto) y directorio de trabajo como en la tabla

La ruta del relay, el puerto y la carpeta del proyecto en la captura son solo ejemplos; usa la salida de Copy de tu panel y la ruta local del directorio padre de Assets.

Haz clic en Save, luego cierra por completo y reinicia la app de ChatGPT de escritorio (en web, actualiza e inicia una nueva sesión antes de probar MCP).

Por qué importa el directorio de trabajo

El relay se comunica con ChatGPT por STDIO, pero aún necesita la raíz del proyecto Unity del editor que tienes abierto. Cambia esta ruta cuando cambies de proyecto.

Qué significan los ajustes copiados

  • unity-mcp-relay — relay local entre el cliente MCP y Unity MCP Server en el editor
  • --stdio — ejecuta el relay como subproceso con entrada/salida estándar
  • --port — debe coincidir con el puerto del servicio Running; un puerto incorrecto o un servidor detenido provoca fallos o tiempos de espera

Verifica la conexión

Envía primero un prompt de solo lectura, por ejemplo:

Lista los GameObjects raíz de la escena activa de Unity vía MCP.

Si la respuesta coincide con la Hierarchy de Unity, prueba una escritura pequeña (p. ej., crea un GameObject vacío MCP_SmokeTest y luego elimínalo). Haz commit al control de versiones antes de cambios grandes.

Si el servidor está Running pero el editor no aparece en las instancias activas, consulta las preguntas frecuentes de Unity MCP install.

Chuleta de clientes

ClienteAcción típica en el panel
Cursorauto configure con un clic
Claude Code / Gemini CLICopy CLI command → ejecutar en la terminal
Codex CLIOpen o Copy → config.toml
ChatGPT de escritorio / webCopy de los ajustes del relay → formulario STDIO + directorio de trabajo

Resumen: Qué clientes de IA soporta Unity MCP

Preguntas frecuentes

¿Funciona Codex Copy para ChatGPT?
Sí: el mismo comando y argumentos; ChatGPT también necesita el directorio de trabajo correcto.

¿Falló la conexión MCP en ChatGPT?
Comprueba: Unity Running; que --port coincida con el panel; que la ruta del relay exista y sea ejecutable; que el directorio de trabajo sea el padre de Assets; Save y reinicia el cliente.

¿No hay herramientas de Unity en Codex?
Prueba de nuevo Open en el panel, o vuelve a pegar Copy en config.toml y reinicia Codex. Si sigue atascado → instancias activas.

¿Todavía tengo que escribir todo el C# a mano?
Para scripts del día a día, la IA puede crear y adjuntar componentes vía MCP: tú revisas los cambios, compilas y pruebas en Play mode. Mantén la propiedad humana de la arquitectura, las redes y las rutas críticas (FAQ de clientes).

Próximos pasos

Más guías que te pueden interesar