Esta página foi traduzida automaticamente do inglês. Leia o original em inglês.

Endpoint MCP

Uma URL para todos os clientes de IA

Aponte qualquer cliente de IA compatível com MCP para https://ai-game.dev/mcp e ele acessa a engine do jogo que você tem aberta — Unity, Unreal Engine ou Godot. Ferramentas, prompts e recursos são negociados quando o cliente se conecta, então não há esquema para copiar.

URL do endpoint
https://ai-game.dev/mcp
Transporte
Streamable HTTP
Login
OAuth 2.1Chave de projetoToken de acesso
Protocolo
MCP · JSON-RPC 2.0

O caminho mais rápido: deixe o setup-mcp escrever

Cada CLI de engine grava o arquivo de configuração certo para o seu cliente: a URL fixada ao projeto mais uma chave de projeto, então o cliente se conecta na hora, sem precisar fazer login. Adicione --oauth para uma configuração só com URL que faz login pelo navegador. O app desktop faz o mesmo ao configurar um projeto.

# Unity — writes the pinned URL + a project key for Claude Code
unity-mcp-cli setup-mcp claude-code ./MyUnityProject

# Unreal Engine (the project path is a flag)
unreal-mcp-cli setup-mcp cursor --path ./MyUnrealProject

# Godot, URL-only config that signs in over OAuth
godot-cli setup-mcp gemini ./MyGodotProject --oauth

Guias de instalação com o comando exato para cada cliente: Unreal Engine · Unity · Godot

Login

OAuth 2.1 — login pelo navegador, nada para colar

Clientes que oferecem suporte à autorização MCP fazem login pelo navegador na primeira conexão (código de autorização com PKCE e registro dinâmico de cliente) e depois mantêm os próprios tokens. A configuração contém apenas a URL. O comando login das próprias CLIs de engine usa o fluxo de código do dispositivo: ele imprime um código que você aprova no navegador.

Chaves de projeto — o que o setup-mcp grava

Uma chave de projeto (agd_pk_…) pertence a um projeto e é enviada como bearer token junto com a URL fixada. O setup-mcp cria a chave e a grava na configuração do cliente, então o cliente funciona sem login pelo navegador. Remova um projeto da sua conta e a chave para de funcionar.

/mcp ou /mcp/p/<pin>

https://ai-game.dev/mcp é o endpoint base: o servidor encaminha para um dos seus editores conectados. https://ai-game.dev/mcp/p/<pin> fica fixado a um projeto e sempre chega ao editor desse projeto, mesmo quando vários estão abertos. O setup-mcp grava a URL fixada. Saiba mais no guia de autenticação.

Tokens de acesso pessoais — para CI e scripts

Para CI ou um cliente que não consegue abrir um navegador, crie um token de acesso pessoal na sua página de tokens de acesso e envie-o como um token bearer.

Como é uma requisição

Toda requisição é uma mensagem JSON-RPC 2.0 via Streamable HTTP. Uma resposta grande ou progressiva é transmitida de volta como Server-Sent Events, então envie os dois tipos de conteúdo em Accept. Este curl lista as ferramentas do seu editor conectado com um token de acesso:

curl -N -X POST "https://ai-game.dev/mcp" \
  -H "Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'
AuthorizationBearer YOUR_PERSONAL_ACCESS_TOKENUm token de acesso pessoal ou uma chave de projeto; clientes OAuth enviam o próprio token
Acceptapplication/json, text/event-streamOs dois tipos: as respostas podem vir em streaming
Content-Typeapplication/jsonO corpo JSON-RPC
method"initialize" | "tools/list" | "tools/call" | …Métodos MCP padrão

Configuração para seu cliente

Escolha seu cliente e copie a configuração. A primeira aba faz login via OAuth; a aba de token de acesso é para CI. Qualquer coisa que fale MCP funciona — 14 clientes estão listados aqui.

Toda URL abaixo é a base https://ai-game.dev/mcp. Para fixar um cliente a um projeto, use https://ai-game.dev/mcp/p/<pin> — o setup-mcp grava a URL fixada para você.

Settings → Connectors → Add custom connector
Name: ai-game-dev
URL:  https://ai-game.dev/mcp
Endpoint no ar. /api/status informa a integridade atual do endpoint.