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

Conecte Claude Code, Cursor, Copilot, Codex, Gemini e outros clientes MCP ao Unity MCP via endpoint de nuvem do ai-game.dev ou servidor local.

Esta página foi traduzida automaticamente do inglês. [Leia o original em inglês](https://ai-game.dev/docs/wiki/unity/connecting-ai-clients).

Esta página explica como um cliente de IA chega ao Unity Editor, qual endpoint e login ele usa, e como configurar cada agente suportado a partir da janela do AI Game Developer, do `unity-mcp-cli`, ou manualmente.

## Duas formas de conectar

Seu cliente de IA nunca fala diretamente com o Unity. Ambos se conectam a um servidor MCP, e o servidor encaminha as chamadas de ferramentas ao Editor por uma conexão SignalR.

|  | Nuvem (padrão) | Personalizado (local) |
| --- | --- | --- |
| Servidor | O endpoint hospedado `https://ai-game.dev/mcp` | `gamedev-mcp-server`, baixado e iniciado pelo plugin |
| Conexão do Editor | O plugin se conecta ao ai-game.dev | O plugin se conecta a `http://localhost:<port>` |
| Endpoint do cliente | `https://ai-game.dev/mcp/p/<pin>` (fixado) ou `https://ai-game.dev/mcp` | `http://localhost:<port>`, ou o binário do servidor via stdio |
| Login | Conta ai-game.dev (fluxo de dispositivo OAuth) | Nenhum, OAuth do ai-game.dev, ou um token compartilhado |
| Funciona offline | Não | Sim, com autorização `none` ou `token` |

Escolha o modo com o seletor **Connection** (**Custom** / **Cloud**) na janela do AI Game Developer. [Configuração](https://ai-game.dev/pt-br/docs/wiki/unity/configuration#connection-modes) cobre as configurações do servidor local.

## URLs fixadas

O endpoint base `https://ai-game.dev/mcp` encaminha para um dos seus editores conectados por fallback. Isso funciona bem com um único projeto aberto, mas é ambíguo com vários.

Uma URL **fixada**, `https://ai-game.dev/mcp/p/<pin>`, sempre encaminha para o Editor de um projeto. O pin é derivado da identidade do projeto. O botão **Configure** da janela e `unity-mcp-cli setup-mcp` gravam a URL fixada por padrão; `setup-mcp --no-pin` grava a URL base. Para o transporte stdio, o pin é passado como um argumento `project=<pin>`.

## Fazendo login

O Editor, a CLI e o aplicativo desktop compartilham um único login por máquina em `~/.ai-game-dev/credentials.json`. Faça login uma vez em qualquer um deles:

- Na janela: modo Cloud, depois **Authorize**, depois aprove o código no navegador.
- Em um terminal: `unity-mcp-cli login`.
- No [aplicativo AI Game Dev](https://ai-game.dev/docs/app): **Sign in**.

Os tokens são renovados em segundo plano. **Revoke** na janela desconecta todas as ferramentas do AI Game Dev na máquina (todos os plugins de engine, as CLIs e o aplicativo desktop) e revoga os tokens no servidor.

Como o próprio cliente de IA se autentica depende da configuração gravada:

- **Chave de projeto (padrão para Cloud HTTP quando você está conectado).** A configuração carrega `Authorization: Bearer agd_pk_…`, uma chave que não expira e pode ser revogada, vinculada apenas a este projeto. As chaves ficam em `~/.ai-game-dev/project-keys.json`. **Regenerate key** na janela, ou `setup-mcp --regenerate-key`, substitui a chave e revoga a antiga.
- **OAuth (somente URL).** Nenhuma credencial no arquivo; o cliente abre um login no navegador na primeira vez que se conecta. Você obtém isso quando não está conectado, ou com `setup-mcp --oauth`.
- **Personal Access Token.** Para CI ou clientes que não conseguem fazer login pelo navegador, crie um token na sua conta ai-game.dev (veja [Autenticação](https://ai-game.dev/docs/auth)) e passe-o com `setup-mcp --token <token>`.

Trate chaves de projeto e tokens como senhas. Arquivos como `.mcp.json` ficam na pasta do projeto, então verifique seu `.gitignore` antes de commitá-los. [Autenticação](https://ai-game.dev/docs/auth) explica o lado da conta.

## Agentes de IA suportados

O menu suspenso **AI agent** da janela lista estes configuradores. **Configure** grava o arquivo mostrado; **Remove** retira a entrada novamente.

| Agente | Arquivo de configuração gravado | Id da CLI |
| --- | --- | --- |
| Claude Code | `.mcp.json` (raiz do projeto) | `claude-code` |
| Claude Desktop | `claude_desktop_config.json` na pasta de dados de aplicativos do 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` e `~/.gemini/antigravity/mcp_config.json` | `antigravity` |
| Cline | `cline_mcp_settings.json` no armazenamento global do VS Code | `cline` |
| Open Code | `opencode.json` | `open-code` |
| Codex | `.codex/config.toml` | `codex` |
| Kilo Code | `.kilocode/mcp.json` | somente na janela |
| Zoo Code | `.roo/mcp.json` | somente na janela |
| Unity AI | `UserSettings/mcp.json` | `unity-ai` |
| Outro - Personalizado | mostra o JSON para copiar | `custom` |

Caminhos relativos são dentro do seu projeto Unity. A entrada do servidor é sempre chamada `ai-game-developer`. Execute `unity-mcp-cli setup-mcp --list` para ver os ids que a sua versão da CLI suporta.

**Dica**

O Claude Desktop e o Unity AI não usam skills geradas, e a entrada Custom permite escolher a pasta de skills. Para os outros agentes, ative também **Skills > Auto-generate** (ou execute `setup-skills`) para que o agente aprenda RQL.

## Configurar com unity-mcp-cli

`setup-mcp` grava a mesma saída do botão **Configure** da janela, sem abrir o 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
```

O transporte padrão é `http`. Com `--transport stdio`, a configuração inicia o binário do servidor local. Todas as flags estão na [referência da CLI](https://ai-game.dev/pt-br/docs/wiki/unity/cli#setup-mcp).

## Configurar manualmente

Qualquer cliente MCP compatível com HTTP pode usar o endpoint hospedado. Exemplo com Claude Code:

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

Uma configuração JSON genérica de `mcpServers`:

```json
{
  "mcpServers": {
    "ai-game-developer": {
      "url": "https://ai-game.dev/mcp"
    }
  }
}
```

Substitua a URL pela URL fixada do seu projeto (mostrada nas etapas de configuração manual da janela) para direcionar a um projeto específico. A [página do endpoint MCP](https://ai-game.dev/pt-br/mcp-endpoint-info) tem snippets para todos os clientes, incluindo o formato `servers` do VS Code e um cabeçalho PAT.

### Servidor local via HTTP

No modo Custom com o transporte HTTP, aponte o cliente para o servidor local. A porta é a que aparece em **Server URL** na janela; as etapas de configuração manual mostradas para o seu agente na janela contêm a URL exata, incluindo o pin do projeto:

```json
{
  "mcpServers": {
    "ai-game-developer": {
      "url": "http://localhost:<port>"
    }
  }
}
```

### Servidor local via stdio

Com o transporte stdio, o cliente inicia o próprio binário do servidor. No 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
```

Use `osx-arm64`, `osx-x64`, `linux-x64`, `linux-arm64`, `win-x86` ou `win-arm64` para outras plataformas (sem `.exe` fora do Windows). Substitua `<project>` pelo caminho completo do projeto e `<port>` pela porta indicada na janela. Apenas um agente pode usar um servidor stdio por vez, e o botão Start/Stop da janela fica desativado porque o agente é o dono do processo. Prefira HTTP, a menos que seu cliente não tenha suporte a HTTP.

## Depois de configurar

Reinicie o cliente de IA, ou reconecte o servidor MCP dele, para que leia a nova configuração. Depois, siga os [Primeiros passos](https://ai-game.dev/pt-br/docs/wiki/unity/getting-started#verify) para verificar a conexão. Se o cliente não mostrar ferramentas, consulte a [Solução de problemas](https://ai-game.dev/pt-br/docs/wiki/unity/troubleshooting#no-tools).

---

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

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