> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alphagateway.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Servidor MCP

> Use a API como ferramentas em agentes de IA (Claude, Cursor, VS Code).

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}`:

```json theme={null}
{
  "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):

```bash theme={null}
claude mcp add --transport http alpha-gateway https://api.alphagateway.com.br/mcp --header "x-api-key: sua-api-key-aqui"
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.