# 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).

```text
https://mcp.bipa.app/mcp
```

### Passo 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`.

```text
https://mcp.bipa.app/mcp
```

### Passo 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.

1.  Gmail Trigger
    
    Dispara quando chega e-mail com assunto "conta" ou "fatura"
    
2.  OpenAI / Claude
    
    Extrai valor, vencimento e chave Pix do corpo do e-mail (JSON estruturado)
    
3.  MCP Client Tool → bipa_pix_pay_key
    
    Chama a ferramenta da Bipa com a chave e valor extraídos
    
4.  Telegram
    
    Te avisa "📲 Pix de R$ 120 pendente no Bipa — aprove no app"
    
5.  Você (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.

## Próximo passo

-   [Tutorial completo: Pix com Claude Code →](/docs/tutoriais/pix-com-claude-code)
-   [É seguro? Entenda o modelo →](/docs/seguranca)
-   [Ferramentas MCP disponíveis →](/docs#tools)