Você vende mentoria, serviço ou produto digital e quer gerar um Pix ou um link de pagamento sem abrir o painel a cada pedido. Com o MCP da AbacatePay, o agente de IA chama as ferramentas da conta — criar produto, emitir Pix, consultar venda — a partir de um pedido em português.
Este é o tutorial do lado de quem cobra. O conceito (o que são pagamentos agênticos e a diferença entre agente que paga e agente que recebe) está em pagamentos agênticos. Visão de produto: /ai-agents.
O que dá para pedir ao agente
Com chave de leitura e escrita e as ferramentas publicadas em /mcp, pedidos típicos:
- Criar produto e link —
createProduct+createPaymentLink - Gerar Pix (QR / copia-e-cola) —
createTransparentPix - Consultar vendas — relatórios como
getRevenueByMethodReport(“quanto vendi este mês?”) - Ver saldo —
getBalanceReport(depende da permissão da chave) - Estornar —
refundCheckout(sempre valor integral) - Sacar —
createPayout(só para a chave Pix da própria empresa; revise antes)
Também existem no servidor, entre outras, createTransparentBoleto, createCheckout, createCustomer, createSubscription, createCoupon, createWebhook, listCheckouts, checkTransparentPix e simulateTransparentPixPayment (teste). Peça só ações cobertas por essas ferramentas.
Para gerar QR via API sem agente: como gerar QR Code Pix via API.
O que você precisa
- Conta AbacatePay ativa
- Chave de API v2 em app.abacatepay.com/api-keys — chaves v1 não funcionam no MCP. Comece com só leitura ou modo de teste; avance para leitura e escrita quando for criar cobrança de verdade
- Um cliente MCP — Claude, ChatGPT (modo desenvolvedor em planos pagos), Cursor, Claude Code, VS Code com Copilot, Windsurf, n8n ou agente próprio com SDK
Conectar o MCP não tem mensalidade nem adesão: você paga as taxas das cobranças pagas. Detalhe técnico e lista de clientes: /mcp. Anúncio do produto: MCP Server de pagamentos.
Passo a passo: conectar o MCP
O servidor remoto usa o endereço https://mcp.abacatepay.com/mcp, transporte Streamable HTTP (JSON-RPC). Autenticação: OAuth 2.0 com registro dinâmico, PKCE S256 e token opaco mcp_at_ — ou chave v2 no header Authorization: Bearer / X-API-Key. No OAuth, a chave não vai para o assistente.
Fluxo alinhado ao que está em /mcp:
Claude.ai
- Abra Configurações → Conectores
- Adicione um conector personalizado com
https://mcp.abacatepay.com/mcp - Conclua o OAuth (o conector do Claude.ai exige OAuth)
- Em plano Team ou Enterprise, o dono da organização adiciona o conector primeiro
ChatGPT
- Configurações → Apps e conectores → Avançado
- Ligue o Modo desenvolvedor (disponível em planos pagos, conforme /mcp)
- Criar conector, informe a URL do MCP e autentique com OAuth
O conector do ChatGPT está documentado para o modo desenvolvedor em planos pagos.
Cursor e outros clientes
Qualquer cliente MCP remoto por HTTP pode apontar para o mesmo endereço. Vários aceitam chave v2 no header além do OAuth. Há também a opção de rodar o servidor local em stdio com Bun (código aberto MIT no GitHub AbacatePay/abacatepay-mcp), descrita em /mcp.
Depois de conectar, faça um pedido de consulta (“quanto vendi este mês?”) com chave só leitura ou teste antes de criar cobrança real.
Fale com o time sobre MCP e cobrança com Pix.
Exemplos de prompt em português e o que acontece
Use frases claras; o valor R$ 149 abaixo é exemplo de prompt, não métrica de vendas.
| Você pede | O agente tende a usar | Resultado |
|---|---|---|
| “Cria um link de R$ 149 pra mentoria” | createProduct + createPaymentLink |
Produto + link de pagamento para você enviar ao cliente |
| “Gera um Pix de R$ 100 para o pedido 1042” | createTransparentPix |
Cobrança Pix (QR / copia-e-cola) amarrada ao pedido |
| “Quanto vendi este mês?” | getRevenueByMethodReport (ou relatório equivalente) |
Resumo de receita por meio |
| “Simula o pagamento desse Pix de teste” | simulateTransparentPixPayment |
Paga o Pix só com chave de teste |
| “Estorna essa cobrança” | refundCheckout |
Reembolso do valor integral |
| “Saca para a chave Pix da empresa” | createPayout |
Saque — revise destino e valor antes de confirmar |
Confira no painel o que foi criado antes de mandar o link ou o QR ao cliente. Para o desenho de QR e API: como gerar QR Code Pix via API.
Como confirmar que o Pix caiu
O chat pode dizer que a cobrança foi criada; liberar o pedido depende do status pago.
- Configure um webhook na conta (
createWebhookou pelo painel) para o evento de pagamento - Só libere acesso, envio ou agenda quando o webhook confirmar
- Em dúvida, consulte a cobrança no painel ou via ferramenta de listagem/consulta
Guia dedicado: confirmar pagamento Pix automaticamente. Produto Pix: /pix.
Segurança
- Comece com chave só leitura ou modo de teste
- Troque para leitura e escrita só quando for criar cobrança, estornar ou sacar
- Revise valor e destinatário antes de enviar o Pix/link ao cliente e antes de estorno/saque
- Estorno pela ferramenta = valor integral (sem parcial)
- Saque só para a chave Pix da própria empresa
- Apagou a chave no painel → o acesso do agente acaba; cada chamada aparece na conta
Mais contexto de risco e dos dois lados do mercado: pagamentos agênticos.
Agentes prontos no marketplace
Se preferir um agente já montado em vez de conectar o MCP do zero, veja o marketplace em /agents. Na listagem pública aparecem opções como Link na Hora, Laura Financeira, Operação SaaS e Integrador. Abra o card do agente para ver o que ele cobre — use só o que estiver descrito lá.
Visão geral do produto: /ai-agents.
Perguntas frequentes
Quanto custa cada Pix gerado pelo agente?
A taxa do Pix é R$ 0,80 fixo por cobrança paga, com saldo na hora. Conectar o MCP em si não tem mensalidade — você paga quando a cobrança é paga. Detalhe: /mcp e /pix.
O agente vê meu saldo?
Há ferramenta de relatório de saldo (getBalanceReport em /mcp). O que o agente enxerga depende da permissão da chave (só leitura vs leitura e escrita) e do modo (teste vs produção).
E se o agente errar o valor?
Revise o link ou o QR antes de enviar ao cliente. Treine o fluxo no modo de teste (simulateTransparentPixPayment só com chave de teste). Se precisar desfazer uma cobrança já paga, o estorno pela ferramenta é do valor integral.
Funciona no ChatGPT?
Sim, pelo fluxo de conector com Modo desenvolvedor descrito em /mcp — a página indica esse modo em planos pagos. Autentique com OAuth na URL https://mcp.abacatepay.com/mcp. Não conte com o plano gratuito sem conferir a documentação atual do ChatGPT e da AbacatePay.
Preciso de CNPJ?
Veja precisa de CNPJ? MEI também vale.
Fale com o time sobre Pix, MCP e agentes.
Leia também: pagamentos agênticos · pagamentos agênticos com a AbacatePay · MCP · marketplace de agentes · Pix · link de pagamento · como gerar QR Code Pix via API · confirmar pagamento Pix automaticamente · MCP Server de pagamentos