mcp-btg — MCP-сервер для Claude Code: что делает и как установить
Даёт ИИ-агентам доступ к банковским операциям и инвестициям в бразильском BTG Pactual через Pix, болето и счета. Требует сертификаты mTLS и доступ к порталу банка.
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Что делает 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 и открытым материалам банка, а адреса тестовой среды выдаются партнёрам индивидуально.
Какие задачи решает
- выставлять моментальные счета Pix с QR-кодом
- выпускать и проверять статус болето
- получать выписку и баланс по счёту BTG+
- проверять инвестпортфель по фондам и долговым бумагам
Примеры запросов агенту
- Сформируй счёт Pix на сумму 150 BRL и покажи QR-код
- Проверь баланс и последние операции по счёту BTG+
- Покажи текущие позиции по фондам и активам с фиксированной доходностью
Как установить mcp-btg
Командой платформы
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 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Вместо <…> подставьте свои значения
Файл настроек
{
"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>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"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 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Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-btg
Как установить mcp-btg в Claude Code?
Выполните команду `claude mcp add mcp-btg -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> -- npx -y @codespar/mcp-btg`. Подставьте полученные в банке ключи и полные пути к файлам mTLS.
Что делает mcp-btg?
Сервер связывает агента с API банка BTG Pactual. С его помощью модель может выставлять счета Pix, оформлять болето, запрашивать баланс и управлять инвестиционными заявками.
Зачем для работы обязательно нужен mTLS?
Бразильский центробанк BACEN обязывает использовать взаимный TLS для протокола Pix v2, а BTG распространяет это правило на все свои сервисы. Без связки клиентского сертификата и приватного ключа вызовы отклоняются.
