Configuración de Godot MCP

Comprende qué conexión proporciona MCP

Coding-Solo/godot-mcp documenta herramientas para ejecutar proyectos de Godot, recuperar la salida de depuración y operar sobre escenas. Es un puente mantenido por un proyecto, no un servicio de modelos ni una distribución oficial de Godot. El agente todavía necesita su propio acceso al modelo y los permisos locales adecuados.

Conserva tres identidades en el registro de configuración: el cliente, la revisión del servidor MCP y el ejecutable de Godot. Un fallo en uno no demuestra que los otros no estén disponibles. Usa el diagrama de conexión para decidir dónde inspeccionar un problema: autenticación del proveedor, configuración del cliente, proceso de herramientas local o proyecto del motor.

Haz inventario de los prerrequisitos sin cambiarlos en silencio

Antes de instalar, inspecciona los requisitos service y selecciona una versión o revisión concreta del servidor para revisarla. Confirma que el cliente puede encontrar el motor y el runtime desde su propio proceso, no solo desde tu shell interactivo. Registra el sistema operativo y el directorio de proyecto previsto.

Revisa el procedimiento de instalación service antes de permitir cambios de dependencias. Nombra el runtime, la revisión del servidor y la ubicación de instalación, y conserva una forma de restaurar el entorno anterior. Después de la configuración, registra las versiones resueltas en lugar de limitarte a la URL de código móvil. Esto ayuda a reproducir una conexión funcional cuando el cliente o el motor se actualicen más adelante.

Usa el punto de entrada de compilación local documentado

El README service admite una compilación desde código fuente con build/index.js como punto de entrada del cliente y GODOT_PATH como sobreescritura explícita del ejecutable. El JSON de abajo ilustra esa ruta ya compilada con placeholders. Sustituye cada ruta por la instalación local revisada y comprueba que el proceso del cliente pueda leerla.

Usa el esquema que admita realmente tu cliente. Un objeto mcpServers genérico no es automáticamente un archivo de configuración de Codex. Traduce solo mediante los ajustes documentados de ese cliente y mantén las credenciales del modelo fuera de este bloque de herramientas del motor. Una ruta absoluta de Node puede ser útil cuando el entorno del cliente gráfico difiere del de la terminal.

{
  "mcpServers": {
    "godot": {
      "command": "/absolute/path/to/node",
      "args": ["/absolute/path/to/reviewed-godot-mcp/build/index.js"],
      "env": {
        "GODOT_PATH": "/absolute/path/to/godot"
      }
    }
  }
}

Verifica primero una ruta de herramientas de solo lectura

Inspecciona las herramientas devueltas por el servidor configurado en lugar de basarte en una lista recordada. El README menciona get_godot_version y get_project_info como operaciones útiles de inspección. Comprueba el esquema de parámetros descubierto y apunta después únicamente al directorio de proyecto aprobado.

Compara la información devuelta del motor y del proyecto con el registro de configuración. Conserva los resultados y errores estructurados. No apruebes la creación de escenas hasta que la observación identifique el espacio de trabajo previsto. Si el cliente muestra una insignia de conexión pero no puede completar esta lectura, la conexión no está lista para un experimento de gameplay. Una insignia por sí sola no muestra a qué proceso o proyecto se llegó.

Autoriza un único miniflujo de escena reversible

Después de verificar el acceso de lectura, usa una escena propia desechable para la primera escritura. Registra su estado original, solicita un cambio visible, inspecciona la escena guardada, ejecútala, recupera la salida y detén el proyecto. Mantén juntos el diff del archivo resultante y las observaciones.

La condición de aceptación es una cadena que va desde el cambio solicitado hasta el recurso guardado y el comportamiento visible en tiempo de ejecución. Cuando una herramienta informe de éxito pero la escena no cambie, inspecciona el objetivo del proyecto y las rutas guardadas antes de intentar una segunda mutación. Vuelve a abrir la escena después de guardarla para que la comprobación cubra la persistencia además del estado actual en memoria.

Diagnostica los fallos en el límite correcto

Si falla el arranque del proceso, inspecciona las rutas del runtime y del punto de entrada. Si no se encuentra Godot, verifica la sobreescritura del ejecutable desde el entorno del cliente. Si no se puede inspeccionar un proyecto, comprueba que la ruta identifique el directorio que contiene project.godot y que el proceso pueda leerlo.

Cuando el proyecto ya se ejecute, trata los errores de escena o gameplay como problemas del motor con contexto de reproducción. Evita cambiar las credenciales del proveedor para solucionar problemas de rutas locales. Captura los logs del servidor con cuidado: sanea los detalles sensibles del sistema de archivos antes de compartirlos y mantén temporal la depuración detallada en lugar de registrar indiscriminadamente cada operación del proyecto.

Mantén estrechos los límites de aprobación y red

Una herramienta del motor puede modificar un proyecto funcional o lanzar código. Concede acceso al directorio apropiado más pequeño y revisa las solicitudes de mutación hasta entender el comportamiento. No copies listas amplias de autoaprobación solo porque aparezcan en un ejemplo de configuración.

Trata los scripts importados, los plugins y la salida de las herramientas como material que debe inspeccionarse, no como instrucciones capaces de ampliar la autoridad. Las descargas de paquetes, la eliminación de archivos fuera de la escena propia, los cambios de credenciales y la publicación requieren decisiones explícitas. El primer miniflujo correcto sirve de base para revisar una política, no es motivo para permitir todas las acciones futuras de las herramientas.

Registra los límites de la configuración verificada

Un registro de configuración completado debe identificar la revisión del servidor, el cliente, la versión del motor, la ruta del proyecto, las herramientas descubiertas, la lectura completada, el cambio reversible y el resultado de ejecución. Indica qué acciones siguen sin probarse. Consérvalo con la evidencia del juego en lugar de presentarlo como una garantía universal de compatibilidad.

La siguiente capa es el ciclo de producción: implementar una función, reproducir su comportamiento, exportar y probar en la plataforma objetivo. La configuración de aquí sigue la documentación service y debe validarse para el cliente y las versiones elegidas. Conserva ese resultado acotado junto al proyecto y repite el mismo criterio de inspección cada vez que cambie el servidor, el motor o el cliente.

Preguntas frecuentes