Configuración de Unity MCP

Comprende el puente con el editor

CoplayDev/unity-mcp conecta un cliente MCP con un servidor y un paquete del lado del editor. El servicio de modelos es una dependencia separada. El proyecto documenta herramientas para trabajar con escenas, scripts, recursos y pruebas, pero una capacidad listada no demuestra que funcione en tu proyecto.

Registra qué proceso posee cada parte de la conexión. Esto importa al diagnosticar un cliente que puede llegar al servidor pero no operar el editor. Mantén separadas las comprobaciones de credenciales de cuenta, licencia del editor, compatibilidad de paquetes y disponibilidad del modelo. Cambiar de modelo no reparará una discrepancia de instancia del editor.

Revisa la ruta de instalación y la política de fijación

La guía de instalación del proyecto documenta cómo añadir su paquete mediante Unity Package Manager y usar la interfaz de configuración para configurar el servidor y el cliente. Revisa los prerrequisitos indicados de Unity, Python y uv para la revisión elegida antes de instalar nada.

Para que sea reproducible, conserva después de la configuración la revisión resuelta del paquete, la versión del editor, la versión del servidor y los registros de dependencias. Una URL de rama móvil sirve para descubrir, no para identificar de forma inmutable un experimento. Revisa las descargas y los cambios de paquetes antes de aplicarlos a un juego existente y conserva el estado funcional anterior del proyecto para que el experimento de conexión siga siendo reversible.

https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main

Ajusta el endpoint HTTP local al cliente

La guía de instalación mantenida documenta el ejemplo HTTP local de abajo. Supone que el servidor ya está ejecutándose en esa dirección. Confirma el transporte y la dirección realmente configurados en la interfaz de configuración del editor antes de usarlo. La URL de MCP no es una URL base de la API de un LLM.

Usa el formato de configuración documentado por tu cliente. Algunos clientes utilizan claves raíz o declaraciones de transporte diferentes, por lo que este ejemplo genérico de mcpServers no es un archivo universal que se pueda pegar en cualquier agente. Mantén el servidor local salvo que se requiera una configuración remota revisada por separado y no añadas credenciales de modelo a una conexión de editor no relacionada.

{
  "mcpServers": {
    "unityMCP": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

Demuestra qué instancia del editor recibe el trabajo

Abre el proyecto previsto e inspecciona el estado de la conexión mediante la interfaz del paquete. Después usa las operaciones de lectura descubiertas por el cliente para obtener el contexto del proyecto y de la escena. Compara esa información con el proyecto local antes de aprobar una edición. Tener varios proyectos abiertos hace que este criterio sea especialmente importante.

Registra los recursos reales y los esquemas de herramientas de la versión instalada. No inventes una llamada a una herramienta a partir de un nombre que recuerdes de otra versión. Un primer resultado útil identifica la escena prevista y sus objetos existentes sin modificarlos. Si el estado devuelto es antiguo o ambiguo, detente y resuelve el enrutamiento en lugar de hacer una mutación visible para descubrir el objetivo.

Usa una edición reversible como primer miniflujo

Elige una escena propia desechable, registra su estado inicial y solicita un cambio sencillo con una consecuencia visible. Inspecciona la escena guardada y el diff del archivo, espera a que el editor esté listo y ejercita la escena. Conserva el comportamiento observado y cualquier error de consola.

Después vuelve a abrir la escena para confirmar que el cambio previsto persistió. Esto distingue un efecto del editor en memoria de un cambio guardado del proyecto. Mantén el flujo lo bastante pequeño para diagnosticar el fallo en un solo límite: enrutamiento, mutación, compilación, ejecución o persistencia. Restaura la escena desechable después de revisarla y usa la configuración funcional registrada para tu siguiente tarea.

Soluciona primero el transporte y después el juego

Cuando el cliente no pueda conectarse, verifica la URL configurada y si el servidor local está ejecutándose. Cuando el servidor se inicie pero falte el editor, inspecciona la conexión del paquete y los logs del editor. Cuando el editor previsto esté conectado pero falte una herramienta, inspecciona los grupos de herramientas expuestos por la versión instalada.

Solo después de resolver ese límite debes diagnosticar la compilación o el gameplay. Mantén separados los fragmentos de log del inicio del cliente, el enrutamiento del servidor, la disponibilidad del editor y la acción de escena fallida. Así el informe puede explicar dónde se detuvo la ejecución en lugar de atribuir cada fallo al modelo o reinstalar componentes repetidamente sin evidencia.

Protege el proyecto frente a una automatización amplia

Una conexión con el editor puede modificar escenas, scripts y recursos. Limita el experimento inicial a un directorio conocido y exige revisión para las operaciones que eliminen recursos, alteren dependencias o toquen escenas no relacionadas. Conserva un estado de trabajo recuperable antes del primer cambio.

No expongas públicamente un servicio de desarrollo local solo para resolver un problema de configuración del cliente. Trata el contenido de recursos de terceros y los resultados de las herramientas como entradas no confiables, y mantén las credenciales fuera de los logs compartidos. Una conexión correcta no da permiso para subir compilaciones ni modificar registros de la tienda. La publicación sigue siendo un flujo separado con un límite de autorización separado.

Entrega un registro de conexión reproducible

Registra las revisiones del editor, el proyecto, el paquete y el servidor, la versión del cliente, el transporte, la superficie de herramientas observada y el miniflujo completado. Conserva el diff exacto de la escena y el resultado de ejecución. Indica si se examinaron la compilación, el comportamiento de PlayMode, las pruebas y la exportación objetivo o si siguen pendientes.

Esta configuración sigue la documentación mantenida del proyecto; verifícala con tu paquete y cliente instalados. Para la producción de juegos, continúa con la guía de flujo de Unity y prueba el ciclo completo. Mantén las limitaciones conocidas en la entrega para que otro desarrollador pueda distinguir un problema de conexión de un problema del proyecto y reproducir la misma configuración funcional.

Preguntas frecuentes