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

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 se tradujo automáticamente del inglés. [Lee el original en inglés](https://ai-game.dev/docs/wiki/unity/connecting-ai-clients).

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](https://ai-game.dev/es/docs/wiki/unity/configuration#connection-modes) 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](https://ai-game.dev/docs/app): **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, o `setup-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](https://ai-game.dev/docs/auth)) 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](https://ai-game.dev/docs/auth) 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.

**Consejo**

Claude Desktop y Unity AI no usan skills generadas, y la entrada Custom te permite elegir la carpeta de skills. Para los demás agentes, activa también **Skills > Auto-generate** (o ejecuta `setup-skills`) para que el agente aprenda RQL.

## Configurar con unity-mcp-cli

`setup-mcp` escribe la misma salida que el botón **Configure** de la ventana, sin abrir Unity:

```bash
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-pin
```

El 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](https://ai-game.dev/es/docs/wiki/unity/cli#setup-mcp).

## Configurar manualmente

Cualquier cliente MCP que admita HTTP puede usar el endpoint alojado. Ejemplo de Claude Code:

```bash
claude mcp add --transport http ai-game-developer https://ai-game.dev/mcp
```

Una configuración JSON genérica de `mcpServers`:

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

```json
{
  "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:

```bash
claude mcp add ai-game-developer "<project>/Library/mcp-server/win-x64/gamedev-mcp-server.exe" port=<port> plugin-timeout=10000 client-transport=stdio
```

Usa `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](https://ai-game.dev/es/docs/wiki/unity/getting-started#verify) para comprobar la conexión. Si el cliente no muestra herramientas, consulta [Solución de problemas](https://ai-game.dev/es/docs/wiki/unity/troubleshooting#no-tools).

---

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

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