Bipa + n8n: Agentes Financeiros com Pix em Fluxos de Automação
O n8n é o framework de automação open-source favorito dos devs brasileiros para construir agentes de IA. Com o MCP da Bipa, qualquer workflow n8n pode enviar Pix, consultar saldo e pagar contas — sem CNPJ, sem gateway, sem dar senha do banco pra IA.
Por que n8n + Bipa
- n8n já tem node MCP nativo — não precisa escrever integração do zero.
- Rode on-premise — seus workflows não passam por SaaS de terceiros.
- Pix com aprovação biométrica — você aprova cada pagamento no app Bipa. O n8n nunca solta Pix sozinho.
- Combine com qualquer outro node — Telegram, WhatsApp, Gmail, Google Sheets, GPT-4, Claude — todos conversam com a Bipa via MCP.
Como conectar em 5 passos (testado de ponta a ponta)
Passo 1 — Adicione um node MCP
O n8n tem dois nodes MCP, ambos funcionam com o MCP da Bipa — escolha pelo uso: MCP Client para workflows imperativos (executa uma chamada por vez, ótimo pra testar e pra fluxos lineares tipo Gmail Trigger → MCP Client); MCP Client Tool para ficar embaixo de um AI Agent, onde o agente decide qual ferramenta chamar a partir do prompt. Recomendado: n8n 1.119.0+ (onde o OAuth2 + DCR virou estável — PR #21034).
Passo 2 — Configure endpoint e transport
No campo Endpoint URL, cole o endereço abaixo. Em Server Transport, escolha HTTP Streamable (é o transport do MCP 2025-03-26 — o SSE é o legado deprecated). Em Authentication, escolha MCP OAuth2 (deixe em modo Fixed, não Expression).
https://mcp.bipa.app/mcpPasso 3 — Crie a credencial MCP OAuth2 API
Abaixo do dropdown "No credentials yet", clique em Set up credential. No modal que abre: mantenha Use Dynamic Client Registration ligado (é o que faz o PKCE funcionar sem client_id/secret manual), cole o Server URL abaixo, deixe Allowed HTTP Request Domains em All.
https://mcp.bipa.app/mcpPasso 4 — Autorize
Clique em Connect to MCP (o botão fica habilitado assim que você preenche o Server URL). Abre um popup em bipa.app pedindo "Autorizar o n8n" com os escopos Requisitar um pagamento Pix e Consultar seu saldo. Entre com seu celular ou e-mail, receba o código de 6 dígitos, marque os termos e clique em Autorizar acesso. Volta pro n8n automaticamente — a credencial vai mostrar Account connected em verde.
Passo 5 — Escolha uma ferramenta (ou deixe o agente escolher)
De volta ao node, o campo Tool tem um seletor From list já populado com todas as ferramentas da Bipa — o n8n chamou tools/list no servidor automaticamente. Em Input Mode, escolha Manual para testar passando parâmetros à mão, ou Expression para receber parâmetros de nodes anteriores. Quando o node está dentro de um AI Agent, o próprio agente decide qual ferramenta chamar a partir do prompt — você não precisa fixar uma. Para testar a conexão, escolha bipa_balance, Input Mode Manual, clique em Execute step — em segundos o painel Output mostra {"command":"balance","data":{"available":"R$ X,XX"}}. Se apareceu saldo, o OAuth + DCR + MCP 2025-03-26 estão 100% funcionando.
Exemplo: "Agente que paga conta via Pix quando chega no e-mail"
Um workflow real que roda no n8n self-hosted de um dev brasileiro. O n8n monitora o Gmail, extrai valor e chave Pix com GPT, e pede aprovação via Bipa.
- 01Gmail TriggerDispara quando chega e-mail com assunto "conta" ou "fatura"
- 02OpenAI / ClaudeExtrai valor, vencimento e chave Pix do corpo do e-mail (JSON estruturado)
- 03MCP Client Tool → bipa_pix_pay_keyChama a ferramenta da Bipa com a chave e valor extraídos
- 04TelegramTe avisa "📲 Pix de R$ 120 pendente no Bipa — aprove no app"
- 05Você (no celular)Abre o app Bipa, confere, aprova com Face ID. O Pix sai.
Ferramentas MCP mais usadas em n8n
bipa_pix_pay_key- Pagar Pix por chave (CPF, e-mail, telefone, aleatória). Retorna
awaiting_approval— aprovação final no app. bipa_pix_pay_brcode- Pagar Pix copia-e-cola ou QR Code (BR Code). Ideal para contas extraídas por OCR.
bipa_balance- Consultar saldo antes de tentar pagar — evite workflows que tentam pagar sem saldo.
bipa_pix_recipient_suggestions- Sugerir destinatários recentes por nome — útil quando o prompt diz "pague pro João".
bipa_timeline- Puxar histórico para agentes que precisam ver contexto de pagamentos anteriores.