Introdução
Sou o Guerreiro, CEO da PushinPay, e aqui compartilho uma análise detalhada sobre o servidor MCP open source que criamos para cobranças Pix. Este servidor é licenciado sob a licença MIT e está disponível para uso por qualquer desenvolvedor que queira integrar essa funcionalidade ao seu chat.
Funcionalidades Atuais
O servidor MCP open source que criamos oferece duas principais funcionalidades: criar_cobranca_pix e consultar_transacao.
criar_cobranca_pix
Essa funcionalidade permite ao cliente MCP criar uma cobrança Pix. Ela retorna o copia e cola, com opção de split opcional.
consultar_transacao
O recurso consultar_transacao permite ao cliente MCP consultar a situação de uma transação, podendo ser created, paid ou canceled.
consultar_saldo
Porém, o servidor MCP open source não oferece funcionalidades para saque, estorno ou alteração de conta.
Configuração e Instalação
Para instalar o servidor MCP open source, você precisará executar o comando npx -y @pushinpaybr/mcp-server.
Variáveis de Ambiente
Para configurar o servidor, você precisará definir duas variáveis de ambiente: PUSHINPAY_TOKEN e PUSHINPAY_ENV. Por padrão, o servidor está configurado para usar o ambiente de sandbox.
Detalhes Importantes
Valores em Centavos
É importante notar que valores em centavos são interpretados de maneira diferente. Por exemplo, R$ 10,00 é equivalente a 1000 centavos. Portanto, se o modelo de inteligência artificial (IA) enviar 10, a cobrança será de 10 centavos.
Token IP Trabalhado
Se o token do IP for bloqueado, o servidor retornará um erro 401 com a mensagem “IP não configurado”. Este erro deve ser explicitamente explicado no prompt para evitar surpresas.
Limitações e Considerações
Rate Limit por Transação
O servidor MCP open source tem um limite de 1 consulta por minuto por transação, o que evita o loop de perguntas repetitivas.
Código Fonte
O código-fonte do servidor MCP open source está disponível no GitHub: github.com/Pushin-Pay/pushinpay-mcp-server.
Conclusão
O servidor MCP open source para cobrança Pix é uma ferramenta útil para quem já possui um sistema de MCP. Ele oferece funcionalidades para criar e consultar cobranças Pix sem sair do chat, sem permitir permissões de escrita em dinheiro. Compreender e configurar adequadamente este servidor é essencial para aproveitar ao máximo suas funcionalidades.
Comentários