Servidor MCP

Agentes de IA compatíveis com o Model Context Protocol (Claude, Cursor, VS Code e outros) podem usar a API como ferramentas pelo servidor MCP em https://api.alphagateway.com.br/mcp (transporte HTTP).

Autenticação: a mesma API Key, no header x-api-key (ou Authorization: Bearer <API Key>). Use uma chave exclusiva para o agente, fácil de revogar.
Ferramentas: uma por operação desta documentação, com o mesmo operationId como nome. As regras da API valem igual: escopos, ambiente da organização, idempotência e IPs permitidos. Comece por getAccountContext para ver o ambiente e as permissões da chave.
Permissões: o agente faz tudo o que a chave permite. Os escopos são por funcionalidade: quem consulta saques também pode criá-los. Para um agente que não deve sacar, crie uma chave sem PIX_OUT; uma chave sem escopos permite inclusive saques, que em produção movimentam dinheiro de verdade.
Restrições da chave: chave com domínios permitidos não funciona no MCP (clientes de IA não enviam Origin). IPs permitidos só funcionam em clientes que rodam na sua máquina ou no seu servidor, como Claude Code, Cursor e VS Code.

Configuração (Claude Code em .mcp.json, Cursor em ~/.cursor/mcp.json). No Claude Code, ${ALPHA_API_KEY} é lido da variável de ambiente, para a chave não ficar no arquivo; no Cursor, escreva ${env:ALPHA_API_KEY}:

{
  "mcpServers": {
    "alpha-gateway": {
      "type": "http",
      "url": "https://api.alphagateway.com.br/mcp",
      "headers": { "x-api-key": "${ALPHA_API_KEY}" }
    }
  }
}

No VS Code (.vscode/mcp.json) a chave raiz é servers em vez de mcpServers, e a chave vai num input ("x-api-key": "${input:alpha-api-key}", declarado em inputs com "type": "promptString" e "password": true): o VS Code pede o valor na primeira conexão. No Claude Code pela linha de comando (a chave fica gravada na configuração do Claude Code):

claude mcp add --transport http alpha-gateway https://api.alphagateway.com.br/mcp --header "x-api-key: sua-api-key-aqui"

Pagamentos

Conta

Webhooks

IA e automação