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

Bipa

← Todas as Integrações

Windsurf

Codeium's AI-powered editor with MCP server support via Cascade.

Local (stdio)

Pré-requisitos

A Bipa account with an active registration.
Windsurf editor installed.
bipa CLI installed. 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. Use --web alone to get the URL without auto-opening the browser.

Configuração

01

Open Windsurf MCP settings

Go to Windsurf Settings → Cascade → MCP Servers and click Add Server. Or open the Command Palette (Cmd+Shift+P) and search for "MCP". The config file is located at ~/.codeium/windsurf/mcp_config.json.

02

Add the Bipa Agents server

Add the following to the mcpServers object in the config file:

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

03

Reload and verify

Save the config file and reload the window. The Bipa Agents tools will be available in Cascade conversations.

Use Cascade (the AI assistant) to interact with the MCP tools. You can also browse the MCP Marketplace via the MCPs icon in the Cascade panel.

Ferramentas MCP Disponíveis

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

bipa_whoami

Current session info

bipa_account

Account profile

bipa_balance

Check all wallet balances

bipa_limits

Check spending limits

bipa_deposit

Get deposit addresses

bipa_pay

Send a PIX transfer (supports scheduling)

bipa_pix_pay_key

Pay via Pix key

bipa_pix_pay_brcode

Pay via BR Code

bipa_pix_pay_tag

Pay a Bipa user by tag

bipa_pix_pay_trusted_contact

Pay a trusted contact

bipa_pix_pay_recipient

Pay a saved recipient

bipa_pix_brcode_decode

Decode a Pix BR Code

bipa_pix_brcode_preview

Preview a BR Code payment before paying

bipa_pix_tag_preview

Look up a Bipa user by tag

bipa_pix_keys

List Pix keys

bipa_pix_trusted_contacts

List trusted contacts

bipa_pix_recipient_suggestions

Suggest recent recipients

bipa_history

Transaction history

bipa_transactions

Multi-asset transaction list

bipa_transaction_detail

Detail of a specific transaction

bipa_timeline

Unified activity timeline

bipa_tickers

Current BTC/USDT prices

bipa_btc_prices

BTC/BRL price history

bipa_usdt_prices

USDT/BRL price history

bipa_portfolio

Portfolio summary by asset and period

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.