Claude.ai

Connect Bipa Agents directly in the browser. No local installation required — just add the remote MCP server URL and authenticate.

Remote (HTTP + OAuth)

Prerequisites

A Bipa account with an active registration.
A Claude Pro, Team, or Enterprise subscription (MCP integrations require a paid plan).

Setup

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

Open Claude.ai Connectors

Go to claude.ai → click your profile icon → Settings → Connectors (also called Custom Connectors).

Add Bipa Agents

Click Add Connector and enter the MCP server URL:

https://mcp.bipa.app/mcp

Complete OAuth authorization

Claude.ai will redirect you to the Bipa authorization page. Sign in with your Bipa account, review the permissions, and approve. You will be redirected back to Claude.ai automatically.

The OAuth flow uses PKCE. Your access token is managed by Claude.ai and refreshed automatically.

Start using Bipa Agents tools

In any new conversation, Claude will have access to all Bipa Agents tools. Try asking: "What is my current balance?" or "Look up PIX key [email protected]".

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.