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

Bipa

Codex

O Codex da OpenAI suporta servidores MCP. Conecte o Bipa Agents pela interface de Configurações ou por um arquivo YAML local.

Local (stdio) Remote (HTTP + OAuth)

Pré-requisitos

Uma conta Bipa com cadastro ativo.
Codex instalado — npm i -g @openai/codex.

Configuração Local (stdio)

01

Edite o arquivo de configuração do Codex

Abra (ou crie) o arquivo ~/.codex/config.yaml e adicione o servidor MCP do Bipa Agents:

mcpServers:
  bipa:
    command: bipa
    args:
      - mcp
      - serve
      - --stdio

Requer bipa CLI instalado: curl -fsSL https://agents.bipa.app/install.sh | sh. Se o bipa não estiver no seu PATH, use o caminho absoluto.

02

Verifique a conexão

Inicie uma sessão do Codex. As ferramentas do Bipa Agents estarão disponíveis automaticamente. Experimente:

codex "Qual é meu saldo no Bipa?"

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

Abra Settings → MCP Servers → Add server. Defina o nome como Bipa, selecione Streamable HTTP como tipo e insira a URL:

https://mcp.bipa.app/mcp

02

Salve e autorize

Clique em Save, depois clique em Authorize. Você será redirecionado ao app Bipa para concluir o fluxo OAuth.

03

Verifique a conexão

Inicie uma sessão do Codex. As ferramentas do Bipa Agents estarão disponíveis automaticamente. Experimente:

codex "Qual é meu saldo no Bipa?"

Ferramentas MCP Disponíveis

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

bipa_whoami

Informações da sessão atual

bipa_account

Perfil da conta

bipa_balance

Verifique todos os saldos da carteira

bipa_limits

Verifique os limites de gastos

bipa_deposit

Obtenha endereços de depósito

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

bipa_pix_brcode_decode

Decodifique um BR Code Pix

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

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

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.