1
GuerreiroPUSHINPAY
1 min de leitura ·

Dei Pix para uma IA: servidor MCP open source para criar cobrança pelo chat

Sou o Guerreiro, CEO da PushinPay. A gente publicou um servidor MCP open source (licença MIT) para quem quer que o Claude, o Cursor ou outro cliente MCP crie e consulte cobranças Pix sem sair do chat.

O que a v1 faz (de propósito, pouco):

criar_cobranca_pix: devolve o copia e cola, com split opcional
consultar_transacao: created, paid ou canceled
consultar_saldo: disponível e bloqueado

O que ela não faz: saque, estorno ou alteração de conta. IA com permissão ampla de escrita em dinheiro de verdade é roteiro de filme de terror, então começamos com leitura e criação de cobrança.

Instalar:

npx -y @pushinpaybr/mcp-server

Variáveis: PUSHINPAY_TOKEN e PUSHINPAY_ENV (sandbox por padrão).

Detalhes que podem te poupar tempo:

Valores em centavos: R$ 10,00 é 1000. Se o modelo mandar 10, a cobrança sai de 10 centavos, então vale deixar isso claro no prompt.
O token nunca vai para o log.
Token com IP travado volta 401 “IP não configurado”. A IA não adivinha isso sozinha, então o erro precisa ser explícito.
Rate limit de 1 consulta por minuto por transação, o que evita o agente em loop perguntando “já pagou?”.

Código: github.com/Pushin-Pay/pushinpay-mcp-server

Pergunta para quem já constrói MCP: vocês expõem ação de escrita em dinheiro (estorno, saque) para o agente, ou deixam fora? Eu estou inclinado a deixar fora.

Carregando publicação patrocinada...
1

A restrição a leitura e criação de cobrança, excluindo saque e estorno, é a decisão correta. A lógica é simples: criar uma cobrança Pix gera um débito futuro para o usuário, mas não move o ativo imediatamente. Um saque ou estorno, por outro lado, move o ativo real instantaneamente.

O risco de loop de IA se concentra na ação de saque. Se um modelo alucinar e executar saque repetidamente, o prejuízo é imediato e irreversível em segundos. Na criação de cobrança, mesmo que o agente entre em loop, ele apenas gera múltiplos "copias e cola" para o usuário aprovar. A barreira de segurança está na interface de aprovação humana antes da transferência final.

Deixe saque e estorno fora do escopo dos agentes. A ação de escrita em dinheiro deve passar por um checkpoint de confirmação humana explícita antes de ser executada.

1

Valeu, DHEIVER! Foi exatamente esse raciocínio. E tem um detalhe que ajuda: a tarifa é só sobre Pix pago, então se o agente entrar em loop e gerar 50 cobranças, ninguém paga nada por isso rs. Saque e estorno, por enquanto, ficam no painel, com gente olhando.