Claude Desktop

Anthropic's desktop app has first-class MCP support. Connect locally via the CLI or point to the remote server.

Local (stdio) Remote (HTTP + OAuth)

Prerequisites

A Bipa account with an active registration.
bipa CLI installed (for local mode). 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 Claude Desktop (local mode only). Use --web alone to get the URL without auto-opening the browser.

Local Setup (stdio)

Open Claude Desktop settings

Click the Claude menu → Settings → Developer → Edit Config. This opens the claude_desktop_config.json file.

Add the Bipa Agents MCP server

Add the following to your mcpServers configuration:

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

Restart Claude Desktop

Close and reopen Claude Desktop. You should see the MCP tools icon (hammer) in the chat input, confirming the connection.

If the bipa command is not found, ensure ~/.local/bin is in your PATH or use the full path to the binary.

Remote Setup (HTTP + OAuth)

Connect directly to the Bipa Agents remote MCP server. No local installation required. Authentication is handled via OAuth 2.1 with PKCE.

Open Claude Desktop settings

Click the Claude menu → Settings → Developer → Edit Config.

Add the remote MCP server

Add the following to your mcpServers configuration:

{
  "mcpServers": {
    "bipa": {
      "url": "https://mcp.bipa.app/mcp"
    }
  }
}

Authenticate via OAuth

Restart Claude Desktop. When you first use a Bipa Agents tool, Claude will open your browser to complete the OAuth flow with Bipa. After authorization, the token is managed automatically.

The remote server uses OAuth 2.1 with PKCE. No API keys to manage.

Available MCP Tools

Once connected, the following tools become available to the AI assistant:

bipa_pix_pay_key

Pay for any service or API

bipa_balance

Check all wallet balances

bipa_history

Transaction history

bipa_deposit

Get deposit addresses

bipa_pix_keys

List Pix keys

bipa_pix_brcode_decode

Decode a Pix BR Code

bipa_limits

Check spending limits

bipa_account

Account profile

bipa_whoami

Current session info

bipa_ln_pay

Pay Lightning invoice

bipa_card_create

Create virtual Mastercard

How Authentication Works

Local mode: The CLI authenticates by opening your browser. You sign in with the Bipa app and the session token is stored locally.

Remote mode: The MCP client handles OAuth 2.1 automatically. It discovers endpoints via /.well-known/oauth-authorization-server, redirects you to the Bipa app for authorization, and exchanges the code for an access token using PKCE.