MagnusPay
MagnusPay

Começar

Autenticação MCP

API Key, headers e segurança da conta

API Key

O MCP usa a mesma API Key da integração (formato magnus_...). Crie a sua em Painel → Credenciais. Envie em um destes headers na configuração do cliente MCP:

headershttp
Authorization: Bearer magnus_SUA_CHAVE
# ou
X-API-Key: magnus_SUA_CHAVE

O servidor repassa a chave para a API como X-API-Key em cada operação. A chave não é registrada em log nem devolvida para o agente (o debug_api_key mostra só o começo e o fim dela).

Testando a chave sem editor

curlbash
curl -X POST "https://api.magnuspay.com.br/mcp" \
  -H "Authorization: Bearer magnus_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"debug_api_key","arguments":{}}}'

Sem chave, o servidor responde 401 com a mensagem de como autenticar.

O que protege a sua conta

Toda tool passa pela API normal, então as mesmas regras de uma integração valem para a IA:

ProteçãoComo funciona no MCP
Operações do catálogoSó as operações documentadas podem ser executadas; caminhos arbitrários são bloqueados
Segurança de transferênciasSe ativa no painel, saque e transferência exigem verificationCode — a IA não saca sem o seu código
IPs permitidosSe a chave tem lista de IPs, vale o IP de quem está usando o MCP (o seu computador/servidor)
Rate limit200 requisições/min por IP, igual à API (veja Rate Limiting)
Confirmação no editorSaque e transferência são marcados como destrutivos: Cursor, Claude e VS Code pedem confirmação antes de rodar

🔐 Boas práticas

Guarde a chave em variável de ambiente ou no gerenciador de segredos do editor, nunca no repositório (adicione .cursor/mcp.json e .vscode/mcp.json ao .gitignore se colocar a chave direto neles). Se a chave vazar, revogue em Credenciais e gere outra. Para agentes autônomos, ative a segurança de transferências.
MCP ServerCursor