# mcp-banco-do-brasil

Подключает агента к API Banco do Brasil: создаёт заряды Pix, выпускает boleto, показывает баланс и выписку по счёту.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Автор: codespar
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/banking/banco-do-brasil
- Обновлён: 2026-09-27
- HTML: https://affpapa.org/nevibecode/mcp/mcp-banco-do-brasil

## Что делает

Сервер отдаёт агенту 13 инструментов. По Pix это создание и чтение заряда (cob), возврат (devolução), а также работа с ключами DICT: поиск владельца, регистрация и удаление. По Cobranças — выпуск boleto, чтение по `nosso_numero` и отмена до оплаты. Плюс баланс и выписка по conta-corrente за период.

Авторизация устроена в три слоя. OAuth2 `client_credentials` берёт токен на `oauth.{env}.bb.com.br` и держит его в кеше примерно до минуты перед истечением. Ключ шлюза `gw-dev-app-key` уходит параметром в каждом вызове. Для Pix v2 в продакшене BACEN требует mTLS, поэтому `BB_CERT_PATH` и `BB_KEY_PATH` обязательны в production; в песочнице обычно хватает TLS, и сертификат там не нужен.

Статус — alpha `0.1.0-alpha.1`. Полные спецификации OpenAPI в портале разработчика открываются только после онбординга мерчанта, поэтому пути по boleto, счёту и выписке собраны по публичным страницам BB и соглашениям, общим с Itaú, Santander и Bradesco. Непроверенные пути помечены `TODO(verify)` в `src/index.ts`. На версиях `0.1.x` фиксируйте точную версию пакета: поведение между минорными выпусками может поменяться.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `BB_CLIENT_ID`, `BB_CLIENT_SECRET`, `BB_DEVELOPER_APP_KEY`, `BB_CERT_PATH`, `BB_KEY_PATH`, `BB_ENV` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env BB_CLIENT_ID=<BB_CLIENT_ID> --env BB_CLIENT_SECRET=<BB_CLIENT_SECRET> --env BB_DEVELOPER_APP_KEY=<BB_DEVELOPER_APP_KEY> --env BB_CERT_PATH=<BB_CERT_PATH> --env BB_KEY_PATH=<BB_KEY_PATH> --transport stdio banco-do-brasil -- npx -y @codespar/mcp-banco-do-brasil
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера

### Codex

**Командой платформы**
```bash
codex mcp add banco-do-brasil --env BB_CLIENT_ID=<BB_CLIENT_ID> --env BB_CLIENT_SECRET=<BB_CLIENT_SECRET> --env BB_DEVELOPER_APP_KEY=<BB_DEVELOPER_APP_KEY> --env BB_CERT_PATH=<BB_CERT_PATH> --env BB_KEY_PATH=<BB_KEY_PATH> -- npx -y @codespar/mcp-banco-do-brasil
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "banco-do-brasil": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-banco-do-brasil"
            ],
            "env": {
                "BB_CLIENT_ID": "<BB_CLIENT_ID>",
                "BB_CLIENT_SECRET": "<BB_CLIENT_SECRET>",
                "BB_DEVELOPER_APP_KEY": "<BB_DEVELOPER_APP_KEY>",
                "BB_CERT_PATH": "<BB_CERT_PATH>",
                "BB_KEY_PATH": "<BB_KEY_PATH>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "banco-do-brasil": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-banco-do-brasil"
            ],
            "env": {
                "BB_CLIENT_ID": "<BB_CLIENT_ID>",
                "BB_CLIENT_SECRET": "<BB_CLIENT_SECRET>",
                "BB_DEVELOPER_APP_KEY": "<BB_DEVELOPER_APP_KEY>",
                "BB_CERT_PATH": "<BB_CERT_PATH>",
                "BB_KEY_PATH": "<BB_KEY_PATH>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e BB_CLIENT_ID=<BB_CLIENT_ID> -e BB_CLIENT_SECRET=<BB_CLIENT_SECRET> -e BB_DEVELOPER_APP_KEY=<BB_DEVELOPER_APP_KEY> -e BB_CERT_PATH=<BB_CERT_PATH> -e BB_KEY_PATH=<BB_KEY_PATH> banco-do-brasil npx -y @codespar/mcp-banco-do-brasil
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера

## Когда брать
- выставить счёт через Pix и отдать клиенту QR-код
- вернуть полученный Pix по endToEndId
- проверить, кому принадлежит ключ DICT, до перевода
- выпустить boleto и потом отменить его до оплаты
- снять баланс и выписку по счёту за нужный период

## Примеры запросов агенту
- Создай заряд Pix на 250 реалов и покажи QR-код
- Проверь по ключу DICT, на кого он зарегистрирован
- Выпусти boleto по этому заказу и верни nosso_numero

## Похожие
- [MCP Toolbox for Databases](https://affpapa.org/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP-сервер · ★ 16717
- [PostHog MCP Server](https://affpapa.org/nevibecode/mcp/posthog-mcp-server.md) — MCP-сервер · ★ 40409
- [OpenWork MCP Gateway](https://affpapa.org/nevibecode/mcp/openwork-mcp-gateway.md) — MCP-сервер · ★ 24242
- [Keploy](https://affpapa.org/nevibecode/mcp/keploy.md) — MCP-сервер · ★ 18727
- [Nhost](https://affpapa.org/nevibecode/mcp/nhost.md) — MCP-сервер · ★ 9366
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP-сервер · ★ 7506

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md