Conectar clientes de IA
Conecta Claude Code, Cursor, Copilot, Codex, Gemini y otros clientes MCP a Unity MCP vía el endpoint en la nube de ai-game.dev o un servidor local.
Esta página explica cómo un cliente de IA llega al Unity Editor, qué endpoint e inicio de sesión utiliza y cómo configurar cada agente compatible desde la ventana de AI Game Developer, desde unity-mcp-cli o manualmente.
Dos formas de conectarse
Tu cliente de IA nunca habla directamente con Unity. Ambos se conectan a un servidor MCP, y el servidor enruta las llamadas a herramientas al Editor mediante una conexión SignalR.
| Nube (predeterminado) | Personalizado (local) | |
|---|---|---|
| Servidor | El endpoint alojado https://ai-game.dev/mcp | gamedev-mcp-server, descargado e iniciado por el plugin |
| Conexión del Editor | El plugin se conecta a ai-game.dev | El plugin se conecta a http://localhost:<port> |
| Endpoint del cliente | https://ai-game.dev/mcp/p/<pin> (fijado) o https://ai-game.dev/mcp | http://localhost:<port>, o el binario del servidor por stdio |
| Inicio de sesión | Cuenta de ai-game.dev (flujo de dispositivo OAuth) | Ninguno, OAuth de ai-game.dev o un token compartido |
| Funciona sin conexión | No | Sí, con autorización none o token |
Elige el modo con el interruptor Connection (Custom / Cloud) en la ventana de AI Game Developer. Configuración cubre los ajustes del servidor local.
URLs fijadas
El endpoint base https://ai-game.dev/mcp enruta a uno de tus editores conectados mediante fallback. Eso está bien con un solo proyecto abierto, pero es ambiguo con varios.
Una URL fijada, https://ai-game.dev/mcp/p/<pin>, siempre enruta al Editor de un proyecto. El pin se deriva de la identidad del proyecto. El botón Configure de la ventana y unity-mcp-cli setup-mcp escriben la URL fijada de forma predeterminada; setup-mcp --no-pin escribe la URL base en su lugar. Para el transporte stdio, el pin se pasa como argumento project=<pin>.
Iniciar sesión
El Editor, la CLI y la aplicación de escritorio comparten un único inicio de sesión para toda la máquina en ~/.ai-game-dev/credentials.json. Inicia sesión una vez en cualquiera de ellos:
- En la ventana: modo Cloud, luego Authorize, y después aprueba el código en tu navegador.
- En una terminal:
unity-mcp-cli login. - En la aplicación AI Game Dev: Sign in.
Los tokens se renuevan en segundo plano. Revoke en la ventana cierra la sesión de todas las herramientas de AI Game Dev de la máquina (todos los plugins de motores, las CLI y la aplicación de escritorio) y revoca los tokens en el servidor.
Cómo se autentica el propio cliente de IA depende de la configuración que se haya escrito:
- Clave de proyecto (predeterminada para Cloud HTTP cuando has iniciado sesión). La configuración incluye
Authorization: Bearer agd_pk_…, una clave que no caduca y es revocable, vinculada solo a este proyecto. Las claves se guardan en~/.ai-game-dev/project-keys.json. Regenerate key en la ventana, osetup-mcp --regenerate-key, la reemplaza y revoca la anterior. - OAuth (solo URL). No hay credencial en el archivo; el cliente abre un inicio de sesión en el navegador la primera vez que se conecta. Esto ocurre cuando no has iniciado sesión, o con
setup-mcp --oauth. - Token de acceso personal. Para CI o clientes que no pueden iniciar sesión en el navegador, crea un token en tu cuenta de ai-game.dev (consulta Autenticación) y pásalo con
setup-mcp --token <token>.
Trata las claves de proyecto y los tokens como contraseñas. Archivos como .mcp.json viven en la carpeta de tu proyecto, así que revisa tu .gitignore antes de confirmarlos. Autenticación explica la parte de la cuenta.
Agentes de IA compatibles
El desplegable AI agent de la ventana lista estos configuradores. Configure escribe el archivo indicado; Remove vuelve a quitar la entrada.
| Agente | Archivo de configuración escrito | Id de CLI |
|---|---|---|
| Claude Code | .mcp.json (raíz del proyecto) | claude-code |
| Claude Desktop | claude_desktop_config.json en la carpeta de datos de la aplicación de Claude | claude-desktop |
| Cursor | .cursor/mcp.json | cursor |
| Visual Studio Code (Copilot) | .vscode/mcp.json | vscode-copilot |
| Visual Studio (Copilot) | .vs/mcp.json | vs-copilot |
| Rider (Junie) | .junie/mcp/mcp.json | rider-junie |
| GitHub Copilot CLI | ~/.copilot/mcp-config.json | github-copilot-cli |
| Gemini | .gemini/settings.json | gemini |
| Antigravity | ~/.gemini/config/mcp_config.json y ~/.gemini/antigravity/mcp_config.json | antigravity |
| Cline | cline_mcp_settings.json en el almacenamiento global de VS Code | cline |
| Open Code | opencode.json | open-code |
| Codex | .codex/config.toml | codex |
| Kilo Code | .kilocode/mcp.json | solo en la ventana |
| Zoo Code | .roo/mcp.json | solo en la ventana |
| Unity AI | UserSettings/mcp.json | unity-ai |
| Otro - Personalizado | muestra el JSON para copiar | custom |
Las rutas relativas están dentro de tu proyecto de Unity. La entrada del servidor siempre se llama ai-game-developer. Ejecuta unity-mcp-cli setup-mcp --list para ver los ids que admite tu versión de la CLI.
Configurar con unity-mcp-cli
setup-mcp escribe la misma salida que el botón Configure de la ventana, sin abrir Unity:
unity-mcp-cli setup-mcp claude-code ./MyUnityProject
unity-mcp-cli setup-mcp cursor ./MyUnityProject --transport stdio
unity-mcp-cli setup-mcp claude-code ./MyUnityProject --no-pinEl transporte predeterminado es http. Con --transport stdio, la configuración lanza en su lugar el binario del servidor local. Todas las opciones están en la referencia de la CLI.
Configurar manualmente
Cualquier cliente MCP que admita HTTP puede usar el endpoint alojado. Ejemplo de Claude Code:
claude mcp add --transport http ai-game-developer https://ai-game.dev/mcpUna configuración JSON genérica de mcpServers:
{
"mcpServers": {
"ai-game-developer": {
"url": "https://ai-game.dev/mcp"
}
}
}Sustituye la URL por la URL fijada de tu proyecto (que se muestra en los pasos de configuración manual de la ventana) para apuntar a un solo proyecto. La página del endpoint MCP tiene fragmentos para cada cliente, incluido el formato servers de VS Code y una cabecera PAT.
Servidor local por HTTP
En el modo Custom con el transporte HTTP, apunta el cliente al servidor local. El puerto es el de Server URL en la ventana; los pasos de configuración manual que se muestran para tu agente en la ventana contienen la URL exacta, incluido el pin del proyecto:
{
"mcpServers": {
"ai-game-developer": {
"url": "http://localhost:<port>"
}
}
}Servidor local por stdio
Con el transporte stdio, el cliente inicia él mismo el binario del servidor. En Windows:
claude mcp add ai-game-developer "<project>/Library/mcp-server/win-x64/gamedev-mcp-server.exe" port=<port> plugin-timeout=10000 client-transport=stdioUsa osx-arm64, osx-x64, linux-x64, linux-arm64, win-x86 o win-arm64 para otras plataformas (sin .exe fuera de Windows). Sustituye <project> por la ruta completa del proyecto y <port> por el puerto de la ventana. Solo un agente puede usar un servidor stdio a la vez, y el botón Start/Stop de la ventana está desactivado porque el agente es el propietario del proceso. Prefiere HTTP a menos que tu cliente no admita HTTP.
Después de configurar
Reinicia el cliente de IA, o vuelve a conectar su servidor MCP, para que lea la nueva configuración. Después sigue Primeros pasos para comprobar la conexión. Si el cliente no muestra herramientas, consulta Solución de problemas.