Atualizado em 21/07/2026 · Equipe ZuckPay
Vender Online / MCP e IA
MCP: conecte sua conta de pagamento a uma IA
MCP (Model Context Protocol) é o padrão aberto que permite a um assistente de IA acessar dados de um serviço externo diretamente na conversa. A ZuckPay mantém um servidor MCP oficial de código aberto que conecta a conta do vendedor a Claude Code, Claude Desktop ou Cursor — permitindo consultar vendas, saldo e transações, e até criar cobranças PIX, sem sair do terminal ou editor.
Instalar o servidor MCP
npm install -g zuckpay-mcp
Depois de instalado, adicione o servidor MCP nas configurações do seu cliente de IA (Claude Code, Claude Desktop ou Cursor) com o client_id/client_secret da sua conta ZuckPay.
O que dá para fazer via IA
- Consultar saldo disponível e histórico de transações
- Perguntar sobre vendas recentes em linguagem natural
- Criar cobrança PIX diretamente pela conversa com a IA
- Consultar status de uma transação específica
- Iniciar saque via PIX — sempre com confirmação explícita, nunca automático
Segurança: a IA não move dinheiro sozinha
A ferramenta de saque é desativada por padrão via feature flag e exige um parâmetro de confirmação explícita além de limites de valor e validação de formato de chave PIX. Nenhuma tool aceita URL arbitrária, credenciais nunca aparecem em log, e o servidor roda com limite de corpo de requisição e proteção contra abuso — pensado para uso real de produção, não só demonstração.
Perguntas frequentes
O que é MCP (Model Context Protocol)?
MCP é um protocolo aberto que permite a um agente de IA (como Claude) se conectar diretamente a um serviço externo — neste caso, uma conta de gateway de pagamento — para consultar dados ou executar ações sem que o usuário precise copiar informação manualmente entre sistemas.
Como conectar minha conta ZuckPay a uma IA?
Instale o servidor MCP oficial (npm install zuckpay-mcp), configure com as credenciais da sua conta e adicione como servidor MCP no Claude Code, Claude Desktop ou Cursor. A partir daí, a IA pode consultar vendas, saldo e transações diretamente na conversa.
O MCP da ZuckPay pode mover dinheiro sozinho?
A ferramenta de saque exige confirmação explícita por parâmetro e está desativada por padrão via feature flag, com limites de valor e validação de chave PIX — a IA não movimenta dinheiro sem uma confirmação humana clara.