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:

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.