# Conexión de clientes de IA — Unreal Engine · AI Game Developer Wiki

Conecta Claude Code, Cursor, Copilot, Codex, Gemini y otros clientes MCP a Unreal MCP mediante la nube de ai-game.dev o un servidor local.

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

Esta página explica cómo un cliente de IA llega a tu Unreal Editor, cómo funciona el inicio de sesión y cómo escribir la configuración MCP para cada agente compatible. Si solo quieres el camino más rápido, el botón **Configure** de la sección **AI agent** del editor (consulta [Primeros pasos](https://ai-game.dev/es/docs/wiki/unreal/getting-started#ai-client)) hace todo esto por ti.

## Cloud o Custom: elige un modo de conexión

La sección **Connection** de la ventana de AI Game Developer tiene un conmutador **Custom / Cloud**. El mismo ajuste es `UNREAL_MCP_CONNECTION_MODE` (consulta [Configuración](https://ai-game.dev/es/docs/wiki/unreal/configuration)).

|  | Cloud (predeterminado) | Custom |
| --- | --- | --- |
| Servidor | El endpoint alojado en ai-game.dev | Un `gamedev-mcp-server` que ejecutas tú, normalmente en `localhost` |
| Inicio de sesión | Tu cuenta de ai-game.dev, flujo de código de dispositivo | Opcional: ninguno, un token compartido u OAuth |
| Qué se ejecuta en local | El editor y su puente | El editor, su puente y el servidor local |
| Recomendado para | La mayoría de usuarios, varias máquinas, trabajo a través de firewalls | Configuraciones totalmente locales, trabajo sin conexión, CI |

## Modo Cloud

En el modo Cloud, el puente se conecta a ai-game.dev y tu cliente de IA se conecta al mismo endpoint, `https://ai-game.dev/mcp`. El servidor enruta las llamadas a herramientas del cliente a tu editor. Consulta la [página del endpoint MCP](https://ai-game.dev/es/mcp-endpoint-info) para ver el endpoint en sí.

### Inicia sesión con el flujo de código de dispositivo

Inicias sesión una vez por máquina. Cualquiera de estas opciones funciona y todas comparten un mismo almacén de credenciales (`~/.ai-game-dev/credentials.json`) con la app, los demás plugins de motor y las CLI:

- En el editor: elige **Cloud**, haz clic en **Authorize**, abre la página de verificación, introduce el código de usuario que aparece en la ventana y aprueba.
- En un terminal: `unreal-mcp-cli login`.
- En la app AI Game Dev: inicia sesión como de costumbre.

**Advertencia:** **Revoke** en el editor cierra la sesión de toda la máquina, no solo la de este proyecto. El editor pide confirmación antes, porque se cierra la sesión de todas las herramientas de AI Game Dev que comparten la credencial (plugins de motor, CLI y la app de escritorio).

En la [página de autenticación](https://ai-game.dev/docs/auth) se explica cómo funcionan las cuentas, los dispositivos y los tokens.

### URLs vinculadas al proyecto

Si tu cuenta tiene varios editores conectados, un cliente que use la URL simple `https://ai-game.dev/mcp` puede llegar al equivocado. Por eso el plugin y `unreal-mcp-cli setup-mcp` escriben por defecto una URL **vinculada al proyecto**:

```text
https://ai-game.dev/mcp/p/<pin>
```

El vínculo se deriva de la carpeta del proyecto, así que el cliente siempre se enruta al editor de este proyecto. Usa `setup-mcp --no-pin` para escribir la URL simple en su lugar.

### Claves de proyecto

Cuando la máquina tiene la sesión iniciada, una configuración Cloud también incluye una **clave de proyecto**, una cabecera `Authorization: Bearer agd_pk_…` vinculada a este proyecto. Con ella, el agente no necesita iniciar sesión por su cuenta. La clave no caduca, se puede revocar y se almacena en caché en `~/.ai-game-dev/project-keys.json` para que todos los agentes del proyecto la reutilicen.

- `setup-mcp --oauth` escribe en su lugar una configuración solo con URL; el agente realiza entonces su propio inicio de sesión OAuth.
- `setup-mcp --regenerate-key`, o el botón **Regenerate key** de la sección AI agent del editor, crea una clave nueva, reescribe con ella los agentes configurados y revoca la anterior.
- Un `--token` explícito tiene prioridad sobre ambos.

Si la máquina no tiene la sesión iniciada, la configuración es solo con URL y el agente inicia sesión por sí mismo.

## Modo Custom: un servidor local

En el modo Custom, el puente se conecta a un servidor que tú controlas, normalmente el `gamedev-mcp-server` compartido que se ejecuta en tu máquina. Cada proyecto recibe un puerto local fijo en el rango de 20000 a 29999, derivado de la ruta del proyecto, de modo que el editor y la CLI coinciden en él sin necesidad de configuración.

Para ejecutarlo desde el editor:

1. Cambia la sección Connection a **Custom**.
2. En la tarjeta **MCP server**, elige el transporte **http** y haz clic en **Start**. El editor descarga la versión fijada del servidor si falta, la inicia y la detiene cuando el editor se cierra. El botón Start solo funciona con el modo Custom y el transporte http.
3. Elige un modo de **Authorization**: **none** (local, anónimo), **token** (un secreto compartido; **New** genera uno, mantén pulsado **Reveal** para verlo) u **oauth**.

Para iniciarlo desde un terminal en su lugar, usa `unreal-mcp-cli open ./YourProject --start-server --connection-mode Custom`, o establece `UNREAL_MCP_START_SERVER=true` con `unreal-mcp-cli configure`.

**Nota:** Si apuntas un servidor local al editor pero la ventana sigue diciendo Cloud, el puente se conecta a ai-game.dev y tu servidor local responde "No connected clients". Establece el modo Custom explícitamente. Pasar `--host` a `unreal-mcp-cli open` selecciona Custom automáticamente.

## Escribir la configuración del cliente con setup-mcp

`unreal-mcp-cli setup-mcp <agent>` escribe una entrada de configuración de MCP para un agente. Lee los ajustes de conexión guardados del proyecto, así que abre antes el proyecto en el editor una vez (o pasa `--url`).

```bash
# Claude Code: writes .mcp.json in the project
unreal-mcp-cli setup-mcp claude-code --path ./YourProject

# Cursor, with the local server over stdio instead of http
unreal-mcp-cli setup-mcp cursor --path ./YourProject --transport stdio

# Print the snippet without writing anything
unreal-mcp-cli setup-mcp vscode-copilot --path ./YourProject --dry-run

# List every agent and its config path
unreal-mcp-cli setup-mcp --list
```

Con `--transport stdio`, la CLI descarga la versión fijada de `gamedev-mcp-server` en `<project>/Intermediate/UnrealMCP/server/` y el agente inicia ese servidor por sí mismo.

### Agentes compatibles

| Agente | Id de `setup-mcp` | Archivo de configuración |
| --- | --- | --- |
| Claude Code | `claude-code` | `.mcp.json` (proyecto) |
| Claude Desktop | `claude-desktop` | `claude_desktop_config.json` (usuario) |
| Cursor | `cursor` | `.cursor/mcp.json` (proyecto) |
| Visual Studio Code (Copilot) | `vscode-copilot` | `.vscode/mcp.json` (proyecto) |
| Visual Studio (Copilot) | `vs-copilot` | `.vs/mcp.json` (proyecto) |
| Rider (Junie) | `rider-junie` | `.junie/mcp/mcp.json` (proyecto) |
| GitHub Copilot CLI | `github-copilot-cli` | `~/.copilot/mcp-config.json` (usuario) |
| Gemini | `gemini` | `.gemini/settings.json` (proyecto) |
| Antigravity | `antigravity` | `mcp_config.json` en `~/.gemini/` (usuario) |
| Cline | `cline` | `cline_mcp_settings.json` en el almacenamiento global de VS Code (usuario) |
| Open Code | `open-code` | `opencode.json` (proyecto) |
| Codex | `codex` | `.codex/config.toml` (proyecto) |
| Kilo Code | `kilo-code` | `.kilocode/mcp.json` (proyecto) |
| Cualquier otro cliente MCP | `custom` | `mcp.json` (proyecto) |

El desplegable **AI agent** del editor ofrece el mismo tipo de configuración en un clic, además de **Remove** para eliminar la entrada, los enlaces **Tutorial** y **Download / Docs**, y **Generate skill files** para los agentes que admiten skills.

## Claude Code y Unreal Engine

Claude Code lee `.mcp.json` desde la carpeta en la que lo inicias. Así que, para Claude Code en Unreal:

1. Ejecuta `unreal-mcp-cli setup-mcp claude-code --path ./YourProject` (o **Configure** en el editor con Claude Code seleccionado).
2. Inicia Claude Code desde la carpeta del proyecto.
3. Pídele que "list the actors in the current level" para confirmar que las herramientas de Unreal están disponibles.

Opcionalmente, `unreal-mcp-cli setup-skills --path ./YourProject` escribe una skill de Claude Code (`.claude/skills/unreal-mcp/SKILL.md`) que le indica a Claude cómo manejar el servidor MCP de este proyecto.

## Otros clientes

Hay fragmentos de configuración listos para usar de muchos clientes, incluidos algunos no listados arriba, en la [página del endpoint MCP](https://ai-game.dev/es/mcp-endpoint-info). La [descripción general del ecosistema](https://ai-game.dev/es/docs/ecosystem) muestra cómo funcionan juntos el servidor, los plugins y la aplicación.

---

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

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