Esta página se tradujo automáticamente del inglés. Lee el original en inglés.

Conexión de clientes de IA

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.

Actualizado el 4 de noviembre de 2026 Ver como Markdown

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) 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).

Cloud (predeterminado)Custom
ServidorEl endpoint alojado en ai-game.devUn gamedev-mcp-server que ejecutas tú, normalmente en localhost
Inicio de sesiónTu cuenta de ai-game.dev, flujo de código de dispositivoOpcional: ninguno, un token compartido u OAuth
Qué se ejecuta en localEl editor y su puenteEl editor, su puente y el servidor local
Recomendado paraLa mayoría de usuarios, varias máquinas, trabajo a través de firewallsConfiguraciones 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 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 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:

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).

# 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

AgenteId de setup-mcpArchivo de configuración
Claude Codeclaude-code.mcp.json (proyecto)
Claude Desktopclaude-desktopclaude_desktop_config.json (usuario)
Cursorcursor.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 CLIgithub-copilot-cli~/.copilot/mcp-config.json (usuario)
Geminigemini.gemini/settings.json (proyecto)
Antigravityantigravitymcp_config.json en ~/.gemini/ (usuario)
Clineclinecline_mcp_settings.json en el almacenamiento global de VS Code (usuario)
Open Codeopen-codeopencode.json (proyecto)
Codexcodex.codex/config.toml (proyecto)
Kilo Codekilo-code.kilocode/mcp.json (proyecto)
Cualquier otro cliente MCPcustommcp.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. La descripción general del ecosistema muestra cómo funcionan juntos el servidor, los plugins y la aplicación.