[← Todas as Integrações](/docs)

# Windsurf

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

### 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](/docs).
-   Run `bipa login --web --open` to authenticate before configuring. Use `--web` alone to get the URL without auto-opening the browser.

## Configuração

### 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`.

### Add the Bipa Agents server

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

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

### 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.