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

# Claude

Conecte o Bipa Agents ao Claude Desktop via CLI local, ou ao Claude.ai diretamente via servidor MCP remoto — sem necessidade de instalação.

### Pré-requisitos

-   Uma conta **Bipa** com cadastro ativo.
-   **Claude Desktop** instalado (para modo local) — baixe em [claude.ai/download](https://claude.ai/download).
-   **bipa CLI** instalado (para modo local): `curl -fsSL https://agents.bipa.app/install.sh | sh`.
-   Execute `bipa login --web --open` para autenticar antes de configurar o Claude Desktop (somente modo local).

## Configuração Local (stdio)

### Abra as configurações do Claude Desktop

Clique no menu **Claude** → **Configurações** → **Desenvolvedor** → **Editar Config**. Isso abre o arquivo `claude_desktop_config.json`.

### Adicione o servidor MCP do Bipa Agents

Adicione o seguinte à configuração `mcpServers`:

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

Se o comando bipa não for encontrado, certifique-se de que ~/.local/bin está no seu PATH ou use o caminho completo do binário.

### Reinicie o Claude Desktop

Feche e reabra o Claude Desktop. Você deverá ver o ícone de **ferramentas MCP** (martelo) na entrada do chat, confirmando a conexão.

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

### Abra o Claude.ai no navegador

Acesse [claude.ai](https://claude.ai) e faça login. O MCP remoto está disponível nos planos **Pro, Team e Enterprise**.

### Adicione o servidor MCP remoto

Abra **Configurações** → **Integrações** → **Adicionar integração**. Insira a URL do servidor:

```
https://mcp.bipa.app/mcp
```

O Claude.ai descobrirá automaticamente os endpoints OAuth e redirecionará você para autorizar com o Bipa.

### Autorize com o Bipa

Você será redirecionado para a página de autorização do Bipa. Faça login e aprove as permissões solicitadas. Você voltará ao Claude.ai automaticamente, com as ferramentas do Bipa Agents prontas para uso.

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