Conectar clientes de IA
Conecta Claude Code, Cursor, Copilot, Codex, Gemini y otros clientes MCP a Godot MCP vía el endpoint en la nube de ai-game.dev o tu servidor local.
Godot MCP tiene dos lados que se conectan ambos a un servidor MCP: el addon en el editor de Godot y el cliente de IA con el que chateas. Esta página explica los dos modos de conexión, cómo funciona el inicio de sesión y cómo escribir la configuración de MCP para cada agente compatible con godot-cli setup-mcp o el botón Configure del dock.
Modo Cloud (predeterminado)
En el modo Cloud, el addon se conecta al backend alojado en https://ai-game.dev y tu cliente de IA se conecta al endpoint MCP https://ai-game.dev/mcp. No se ejecuta nada adicional en tu máquina y funciona a través de firewalls. Este es el modo predeterminado y el que recomendamos para la mayoría de la gente.
Inicia sesión con el flujo de dispositivo
La autenticación en la nube usa el flujo de autorización de dispositivo de OAuth 2.1. Nunca copias un token a mano:
godot-cli loginLa CLI imprime un código corto, abre tu navegador y espera hasta que lo apruebes. La credencial (token de acceso, token de refresco rotativo y caducidad) se guarda en el almacén de la máquina ~/.ai-game-dev/credentials.json (modo de archivo 0600 en macOS y Linux, protegido con DPAPI en Windows). El addon del editor, las demás CLI de los motores y la app AI Game Dev la recogen, y los tokens de acceso caducados se refrescan automáticamente. Hacer clic en Authorize en el dock ejecuta el mismo flujo desde dentro de Godot.
Flags útiles de login: --force inicia sesión de nuevo sobre una credencial existente, --project <path> mantiene una credencial separada por proyecto y --tools-only crea una credencial más restringida para runners de CI. Consulta la referencia de godot-cli y Autenticación.
URLs de proyecto fijadas
El endpoint simple https://ai-game.dev/mcp enruta tu agente a uno de tus editores conectados. Eso es ambiguo cuando hay varios proyectos abiertos, así que setup-mcp escribe por defecto una URL fijada: https://ai-game.dev/mcp/p/<pin>, donde el pin se deriva del proyecto. Un agente iniciado con esa configuración siempre llega al editor de este proyecto. Pasa --no-pin si quieres la URL simple.
Claves de proyecto
Cuando has iniciado sesión, setup-mcp coloca una clave de proyecto en la configuración del agente como Authorization: Bearer agd_pk_…. Una clave de proyecto no caduca y solo funciona para el pin de este proyecto, así que no puede acceder a otros proyectos de tu cuenta. Se crea una vez por proyecto y se reutiliza desde ~/.ai-game-dev/project-keys.json.
--regenerate-keycrea una clave nueva, reescribe la configuración y revoca la clave antigua.--oauthescribe en su lugar una configuración solo con URL: el agente inicia sesión con su propio prompt de OAuth.- Sin un inicio de sesión en la máquina, la configuración también es solo con URL.
Modo Custom: tu propio servidor
En el modo Custom, el addon se conecta a una URL de servidor que elijas, por ejemplo un servidor en tu propia máquina. El servidor es GameDev-MCP-Server, de código abierto, el mismo binario que usan Unity MCP y Unreal MCP.
La forma más sencilla es dejar que el addon lo ejecute:
- En el dock, cambia el modo a Custom.
- Deja Server URL en
http://localhost:8080, o introduce otra URL local. - Haz clic en Start Server. El addon descarga la build del servidor para su versión de servidor fijada desde GitHub (HTTPS, solo github.com), la almacena en caché en
.godot/mcp-server/<platform>/, la inicia y se conecta.
Stop Server lo detiene, y cerrar el editor también lo detiene. Las descargas se omiten en entornos de CI. Para ejecutar un servidor tú mismo en su lugar, descarga un binario de release o la imagen Docker aigamedeveloper/mcp-server:
./gamedev-mcp-server --client-transport streamableHttp --port 8080Autorización para un servidor personalizado
El modo Custom tiene un interruptor Authorization Token con tres valores:
| Valor | Significado |
|---|---|
none | Sin autenticación. Está bien para un servidor que solo escucha en tu propia máquina. |
oauth | Envía el token de tu cuenta de ai-game.dev con la sesión iniciada, pero solo a un servidor localhost (localhost, 127.0.0.0/8, ::1). |
token | Un token bearer. Haz clic en New para generar uno; se almacena enmascarado. |
Para cualquier host no local con oauth, el addon se niega a enviar el token de tu cuenta; configura GODOT_MCP_TOKEN en su lugar. Las variables de entorno para ambos modos se enumeran en Configuración.
Para apuntar un agente a un servidor local, pasa la URL a setup-mcp:
godot-cli setup-mcp claude-code ./MyGodotProject --url http://localhost:8080La configuración de un servidor local nunca lleva una clave de proyecto.
Agentes y archivos de configuración compatibles
Ejecuta godot-cli setup-mcp --list para ver todos los id de agente. Estos son los id que conoce la CLI actual y dónde escribe la configuración:
| Agente | id | Archivo de configuración |
|---|---|---|
| Claude Code | claude-code | .mcp.json en el proyecto |
| Claude Desktop | claude-desktop | Usa un conector personalizado de Claude (ver abajo) |
| Cursor | cursor | .cursor/mcp.json |
| Visual Studio Code (Copilot) | vscode-copilot | .vscode/mcp.json |
| Visual Studio (Copilot) | vs-copilot | .vs/mcp.json |
| Rider (Junie) | rider-junie | .junie/mcp/mcp.json |
| GitHub Copilot CLI | github-copilot-cli | ~/.copilot/mcp-config.json |
| Gemini | gemini | .gemini/settings.json |
| Antigravity | antigravity | ~/.gemini/config/mcp_config.json y ~/.gemini/antigravity/mcp_config.json |
| Cline | cline | cline_mcp_settings.json en el almacenamiento global de VS Code |
| Open Code | open-code | opencode.json |
| Codex | codex | .codex/config.toml |
| Kilo Code | kilo-code | .kilocode/mcp.json |
| Cualquier otro cliente MCP | custom | mcp.json en el proyecto |
Ejemplos:
godot-cli setup-mcp cursor ./MyGodotProject
godot-cli setup-mcp codex ./MyGodotProject
godot-cli setup-mcp vscode-copilot ./MyGodotProject --oauthTodas las configuraciones usan el transporte HTTP (type: http y una URL). En Codex la clave va en http_headers.
Claude Desktop y claude.ai
Claude Desktop no acepta una entrada de servidor HTTP desde claude_desktop_config.json. En su lugar, Claude Desktop y claude.ai acceden al endpoint en la nube como un conector personalizado de Claude: añade un conector personalizado en los ajustes de Claude, pega la URL en la nube fijada del proyecto e inicia sesión con tu cuenta de ai-game.dev. Claude Desktop no puede usar un servidor en modo Custom, porque Godot MCP no ofrece transporte stdio para ello. Para un servidor local, usa un agente de la tabla que admita HTTP, como Claude Code.
Configurar desde el dock
La sección AI agent del dock hace el mismo trabajo que setup-mcp: elige tu agente de la lista y luego haz clic en Configure (o en Reconfigure). La línea de estado indica si el archivo de configuración del agente está listo, y aparece un aviso Reconfiguration Required cuando cambias la URL del servidor, el modo o la autorización después de configurar. Remove elimina la entrada de Godot MCP de la configuración de ese agente.
Skills para tu agente
Algunos agentes leen archivos de skills (SKILL.md) que les enseñan cómo usar las herramientas. La fila Skills, dentro de la sección AI agent del dock, puede generarlos (Generate, o el interruptor Auto-generate). Desde una terminal:
godot-cli setup-skills claude-code ./MyGodotProjectEsto escribe los archivos en la carpeta de skills del agente, como .claude/skills para Claude Code, sin necesidad de tener el editor en ejecución. setup-skills --list muestra qué agentes admiten skills.
Configuraciones para copiar y pegar
Si tu cliente no está en la lista, sirve cualquier cliente MCP que admita servidores HTTP: apúntalo a https://ai-game.dev/mcp (o a la URL fijada) y deja que inicie sesión con OAuth, o añade una cabecera bearer. Hay fragmentos listos para muchos clientes en la página del endpoint MCP.