# mcp-btg

Даёт ИИ-агентам доступ к банковским операциям и инвестициям в бразильском BTG Pactual через Pix, болето и счета. Требует сертификаты mTLS и доступ к порталу банка.

- 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/btg
- Обновлён: 2026-09-27
- HTML: https://affpapa.org/nevibecode/mcp/mcp-btg

## Что делает

Сервер предоставляет 12 инструментов для работы с инфраструктурой BTG Pactual. Ассистент умеет выставлять моментальные счета Pix с QR-кодами, выпускать болето, запрашивать баланс с выпиской, а также управлять инвестициями. Доступны просмотр позиций по ценным бумагам вроде CDB, LCI или LCA, оформление подписки на фонды и вывод активов.

Для каждого запроса обязательны сразу два фактора авторизации: токен OAuth2 `client_credentials` и взаимный TLS (mTLS). Сертификат и ключ выдаются только после подписания договора на портале BTG Developer. Без локальных файлов ключа и сертификата клиент не установит защищённое соединение.

Версия находится в статусе альфы `0.1.0-alpha.1`. Документация BTG закрыта для публики, поэтому пути эндпоинтов выстроены по спецификациям BACEN Pix v2 и открытым материалам банка, а адреса тестовой среды выдаются партнёрам индивидуально.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `BTG_CLIENT_ID`, `BTG_CLIENT_SECRET`, `BTG_CERT_PATH`, `BTG_KEY_PATH`, `BTG_ENV` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env BTG_CLIENT_ID=<BTG_CLIENT_ID> --env BTG_CLIENT_SECRET=<BTG_CLIENT_SECRET> --env BTG_CERT_PATH=<BTG_CERT_PATH> --env BTG_KEY_PATH=<BTG_KEY_PATH> --env BTG_ENV=<BTG_ENV> --transport stdio btg -- npx -y @codespar/mcp-btg
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add btg --env BTG_CLIENT_ID=<BTG_CLIENT_ID> --env BTG_CLIENT_SECRET=<BTG_CLIENT_SECRET> --env BTG_CERT_PATH=<BTG_CERT_PATH> --env BTG_KEY_PATH=<BTG_KEY_PATH> --env BTG_ENV=<BTG_ENV> -- npx -y @codespar/mcp-btg
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "btg": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-btg"
            ],
            "env": {
                "BTG_CLIENT_ID": "<BTG_CLIENT_ID>",
                "BTG_CLIENT_SECRET": "<BTG_CLIENT_SECRET>",
                "BTG_CERT_PATH": "<BTG_CERT_PATH>",
                "BTG_KEY_PATH": "<BTG_KEY_PATH>",
                "BTG_ENV": "<BTG_ENV>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "btg": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-btg"
            ],
            "env": {
                "BTG_CLIENT_ID": "<BTG_CLIENT_ID>",
                "BTG_CLIENT_SECRET": "<BTG_CLIENT_SECRET>",
                "BTG_CERT_PATH": "<BTG_CERT_PATH>",
                "BTG_KEY_PATH": "<BTG_KEY_PATH>",
                "BTG_ENV": "<BTG_ENV>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e BTG_CLIENT_ID=<BTG_CLIENT_ID> -e BTG_CLIENT_SECRET=<BTG_CLIENT_SECRET> -e BTG_CERT_PATH=<BTG_CERT_PATH> -e BTG_KEY_PATH=<BTG_KEY_PATH> -e BTG_ENV=<BTG_ENV> btg npx -y @codespar/mcp-btg
```
Вместо <…> подставьте свои значения

## Когда брать
- выставлять моментальные счета Pix с QR-кодом
- выпускать и проверять статус болето
- получать выписку и баланс по счёту BTG+
- проверять инвестпортфель по фондам и долговым бумагам

## Примеры запросов агенту
- Сформируй счёт Pix на сумму 150 BRL и покажи QR-код
- Проверь баланс и последние операции по счёту BTG+
- Покажи текущие позиции по фондам и активам с фиксированной доходностью

## Похожие
- [World Monitor](https://affpapa.org/nevibecode/mcp/world-monitor.md) — MCP-сервер · ★ 89408
- [CCXT](https://affpapa.org/nevibecode/mcp/ccxt.md) — MCP-сервер · ★ 44583
- [Finance Toolkit](https://affpapa.org/nevibecode/mcp/finance-toolkit.md) — MCP-сервер · ★ 5458
- [EdgarTools](https://affpapa.org/nevibecode/mcp/edgartools.md) — MCP-сервер · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/nevibecode/mcp/letsfg-flights-hotels.md) — MCP-сервер · ★ 2188
- [AutoTS](https://affpapa.org/nevibecode/mcp/autots.md) — MCP-сервер · ★ 1434

Из того же набора: [codespar/mcp-dev-latam](https://affpapa.org/nevibecode/by/codespar/mcp-dev-latam.md) — 124 карточки

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