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

# Autenticação MCP

> A chave de API é opcional: sem ela, a IA lê a documentação; com ela, usa a sua conta com as permissões da chave.

O MCP da WyzeCash funciona com e sem chave.

| | Sem chave | Com a chave de API |
| - | - | - |
| Rotas, campos e documentação | Sim | Sim |
| Código pronto (`exemplo_codigo`) | Sim | Sim |
| Prompts | Sim | Sim |
| `testar_chave` | Avisa que falta a chave | Conta, chave e permissões |
| Criar cobranças e links | Não | Sim, com a permissão |
| Consultar cobranças, saldo e extrato | Não | Sim, com a permissão |
| Saque, Pix enviado e estorno | Só a documentação | Só a documentação |

## Mandar a chave

A chave vai no cabeçalho `Authorization`, igual à API:

```http theme={null}
Authorization: Bearer bk_live_SUA_CHAVE
```

Cada página de **Configurar** mostra onde colocar o cabeçalho na sua IA: [Cursor](https://docs.wyzecash.com.br/mcp/cursor.md), [Claude Code](https://docs.wyzecash.com.br/mcp/claude-code.md), [Codex](https://docs.wyzecash.com.br/mcp/codex.md), [VS Code](https://docs.wyzecash.com.br/mcp/vscode.md) e [Claude Desktop](https://docs.wyzecash.com.br/mcp/claude-desktop.md).

## 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](https://docs.wyzecash.com.br/mcp/ferramentas.md).

## 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: ...`).

> [!WARNING]
>
> Toda chave é de produção e todo Pix é real: a cobrança que a IA cria é de verdade. Teste com valores pequenos.


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