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

Bipa

← Todas as Integrações

Claude Desktop

Anthropic's desktop app has first-class MCP support. Connect locally via the CLI or point to the remote server.

Local (stdio) Remote (HTTP + OAuth)

Pré-requisitos

A Bipa account with an active registration.
bipa CLI installed (for local mode). Prefer the managed installer: curl -fsSL https://agents.bipa.app/install.sh | sh. Developer package-manager installs are listed in the docs.
Run bipa login --web --open to authenticate before configuring Claude Desktop (local mode only). Use --web alone to get the URL without auto-opening the browser.

Configuração Local (stdio)

01

Open Claude Desktop settings

Click the Claude menu → Settings → Developer → Edit Config. This opens the claude_desktop_config.json file.

02

Add the Bipa Agents MCP server

Add the following to your mcpServers configuration:

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

03

Restart Claude Desktop

Close and reopen Claude Desktop. You should see the MCP tools icon (hammer) in the chat input, confirming the connection.

If the bipa command is not found, ensure ~/.local/bin is in your PATH or use the full path to the binary.

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

Open Claude Desktop settings

Click the Claude menu → Settings → Developer → Edit Config.

02

Add the remote MCP server

Add the following to your mcpServers configuration:

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

03

Authenticate via OAuth

Restart Claude Desktop. When you first use a Bipa Agents tool, Claude will open your browser to complete the OAuth flow with Bipa. After authorization, the token is managed automatically.

The remote server uses OAuth 2.1 with PKCE. No API keys to manage.

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.