MCP de Pagamentos para Agentes de IA — Pix pelo Claude, ChatGPT e mais

Bipa

Cursor

Editor de código com IA e suporte nativo a MCP. Adicione o Bipa Agents via configurações, arquivo de projeto ou pelo link de instalação rápida.

Local (stdio) Remote (HTTP + OAuth)

Conexão Rápida

Adicionar ao Cursor (local)

Pré-requisitos

Uma conta Bipa com cadastro ativo.
Cursor versão 0.45 ou superior.
bipa CLI instalado (para modo local).

Configuração Local (stdio)

01

Abra as Configurações do Cursor

Abra as Configurações do Cursor (não as do VS Code) → acesse a seção MCP. Clique em Adicionar novo servidor MCP.

02

Configure o servidor

Escolha o transporte stdio e insira o comando. Alternativamente, crie um arquivo .cursor/mcp.json na raiz do projeto:

{
  "mcpServers": {
    "bipa": {
      "command": "bipa",
      "args": ["mcp", "serve", "--stdio"]
    }
  }
}

03

Ative o servidor

Após adicionar, o servidor aparece no painel de configurações do MCP. Certifique-se de que o toggle está ativado (verde). O Cursor se conectará automaticamente.

Use o Composer (modo Agente) ou o Chat para interagir com as ferramentas MCP.

Configuração Remota (HTTP + OAuth)

Conecte-se diretamente ao servidor MCP remoto do Bipa Agents. Nenhuma instalação local é necessária. A autenticação é feita via OAuth 2.1 com PKCE.

01

Adicione o servidor remoto via configurações

Abra as Configurações do Cursor → MCP → Adicionar novo servidor MCP. Escolha o transporte HTTP e insira a URL.

02

Ou use um arquivo de configuração do projeto

Crie o arquivo .cursor/mcp.json na raiz do projeto:

{
  "mcpServers": {
    "bipa": {
      "url": "https://mcp.bipa.app/mcp"
    }
  }
}

03

Autentique

O Cursor cuidará do fluxo OAuth 2.1 automaticamente. Você será redirecionado ao app Bipa para autorizar o acesso.

Ferramentas MCP Disponíveis

Uma vez conectado, as seguintes ferramentas ficam disponíveis para o assistente de IA:

29/29

Conta & sessão

5

bipa_whoami Informações da sessão atual
bipa_account Perfil da conta
bipa_balance Verifique todos os saldos da carteira, incluindo o cofrinho
bipa_limits Verifique os limites de gastos
bipa_deposit Obtenha endereços de depósito

Pagamentos Pix

6

bipa_pay Envie uma transferência Pix (suporta agendamento)
bipa_pix_pay_key Pague via chave Pix
bipa_pix_pay_brcode Pague via BR Code
bipa_pix_pay_tag Pague um usuário Bipa pela tag
bipa_pix_pay_trusted_contact Pague um contato de confiança
bipa_pix_pay_recipient Pague um destinatário salvo

Consultas Pix

7

bipa_pix_brcode_decode Decodifique um BR Code Pix
bipa_pix_brcode_encode Gere um BR Code Pix estático a partir de uma chave
bipa_pix_brcode_preview Visualize um pagamento via BR Code antes de pagar
bipa_pix_tag_preview Busque um usuário Bipa pela tag
bipa_pix_keys Liste as chaves Pix
bipa_pix_trusted_contacts Liste os contatos de confiança
bipa_pix_recipient_suggestions Sugestões de destinatários recentes

Boletos & contas

3

bipa_bank_slip_preview Visualize um boleto antes de pagar
bipa_pay_bank_slip Pague um boleto — requer aprovação no app
bipa_dda_list Liste os boletos registrados no DDA

Histórico & transações

4

bipa_history Histórico de transações
bipa_transactions Lista de transações multi-asset
bipa_transaction_detail Detalhe de uma transação específica
bipa_timeline Timeline unificada de toda a atividade

Cotações & portfólio

4

bipa_tickers Preços atuais de BTC/USDT
bipa_btc_prices Histórico de preços BTC/BRL
bipa_usdt_prices Histórico de preços USDT/BRL
bipa_portfolio Resumo do portfólio por ativo e período

Como a Autenticação Funciona

Modo local: O CLI autentica abrindo seu navegador. Você faz login pelo app Bipa e o token de sessão é armazenado localmente.

Modo remoto: O cliente MCP lida com o OAuth 2.1 automaticamente. Ele descobre os endpoints via /.well-known/oauth-authorization-server, redireciona você ao app Bipa para autorização e troca o código por um token de acesso usando PKCE.