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

Bipa

← Todas as Integrações

Claude Code

O agente CLI da Anthropic suporta MCP nativamente. Adicione o servidor do Bipa Agents com um único comando.

Local (stdio) Remote (HTTP + OAuth)

Pré-requisitos

Uma conta Bipa com cadastro ativo.
Claude Code instalado (npm i -g @anthropic-ai/claude-code).
bipa CLI instalado (para modo local).

Configuração Local (stdio)

01

Adicione o servidor MCP local

Execute o seguinte comando no terminal. Use --scope project para salvar em .mcp.json (nível do projeto) ou --scope user para configuração global em ~/.claude.json.

claude mcp add bipa -- bipa mcp serve --stdio

02

Verifique a conexão

Inicie uma sessão do Claude Code e pergunte "Quais ferramentas MCP estão disponíveis?":

claude

Certifique-se de ter executado bipa login --web --open (ou bipa login --web e abrir a URL manualmente) antes de adicionar o servidor.

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 MCP remoto

Execute o seguinte comando no terminal:

claude mcp add --transport http bipa https://mcp.bipa.app/mcp

02

Autentique

Na primeira vez que você usar uma ferramenta do Bipa Agents, o Claude Code abrirá seu navegador para concluir o fluxo OAuth com o Bipa. Após a autorização, o token é armazenado automaticamente.

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.