Skip to main content
O MCP da WyzeCash funciona com e sem chave.

​
Mandar a chave

A chave vai no cabeçalho Authorization, igual à API:
Cada página de Configurar mostra onde colocar o cabeçalho na sua IA: Cursor, Claude Code, Codex, VS Code e Claude Desktop.

​
Criar uma chave só para a IA

1

Abra o painel

Em Integrações e API › Developer API, crie uma chave com um nome fácil de reconhecer, como “IA do Cursor”.
2

Marque só o que a IA pode fazer

Por exemplo /payments/create, /payments/get e /payments/list para criar e consultar cobranças, ou Só consultas para a IA apenas ler.
3

Guarde numa variável de ambiente

A chave aparece uma vez só. Deixe em BUKIOPAY_API_KEY, nunca no código nem no repositório.
4

Teste

Peça para a IA: “teste a minha chave da WyzeCash”. A ferramenta testar_chave mostra a conta e as permissões, nunca o segredo.

​
Permissões

Cada ferramenta da conta usa a permissão da rota dela, e a IA só vê as ferramentas que a chave pode usar: com /payments/create, aparece criar_cobranca; sem ela, não aparece. A lista completa está em Ferramentas.

​
Regras que continuam valendo

  • Limite: 100 pedidos por minuto por conta, somando a API e o MCP (429 RATE_LIMITED). O endereço /mcp aceita até 120 pedidos por minuto por IP.
  • IP liberado: se a chave só vale em alguns IPs, o MCP respeita. O IP é o da internet do computador onde a IA roda.
  • Idempotência: criar_cobranca e criar_link sempre mandam a Idempotency-Key: a IA pode passar a dela (ex.: o código do pedido); sem ela, uma nova é gerada.
  • Erros: o que a API recusaria volta como erro da ferramenta, com a situação, o código e a mensagem (ex.: Erro 403 FORBIDDEN: ...).
Toda chave é de produção e todo Pix é real: a cobrança que a IA cria é de verdade. Teste com valores pequenos.