# Conectar clientes de IA — Godot · AI Game Developer Wiki

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.

Esta página se tradujo automáticamente del inglés. [Lee el original en inglés](https://ai-game.dev/docs/wiki/godot/connecting-ai-clients).

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:

```bash
godot-cli login
```

La 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](https://ai-game.dev/es/docs/wiki/godot/cli#login) y [Autenticación](https://ai-game.dev/docs/auth).

### 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-key` crea una clave nueva, reescribe la configuración y revoca la clave antigua.
- `--oauth` escribe 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.

**Advertencia**

Una clave de proyecto es una credencial. No hagas commit a un repositorio público de archivos de configuración que contengan una (por ejemplo `.mcp.json` o `.cursor/mcp.json`).

## 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](https://github.com/IvanMurzak/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:

1. En el dock, cambia el modo a **Custom**.
2. Deja **Server URL** en `http://localhost:8080`, o introduce otra URL local.
3. 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`:

```bash
./gamedev-mcp-server --client-transport streamableHttp --port 8080
```

### Autorizació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](https://ai-game.dev/es/docs/wiki/godot/configuration#environment-variables).

Para apuntar un agente a un servidor local, pasa la URL a `setup-mcp`:

```bash
godot-cli setup-mcp claude-code ./MyGodotProject --url http://localhost:8080
```

La 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:

```bash
godot-cli setup-mcp cursor ./MyGodotProject
godot-cli setup-mcp codex ./MyGodotProject
godot-cli setup-mcp vscode-copilot ./MyGodotProject --oauth
```

Todas 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:

```bash
godot-cli setup-skills claude-code ./MyGodotProject
```

Esto 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](https://ai-game.dev/es/mcp-endpoint-info).

---

Source (HTML): https://ai-game.dev/es/docs/wiki/godot/connecting-ai-clients

Machine-translated (es) from the English page: https://ai-game.dev/docs/wiki/godot/connecting-ai-clients