mcp-banco-do-brasil — MCP-сервер для Claude Code: Pix и boleto
Подключает агента к API Banco do Brasil: создаёт заряды Pix, выпускает boleto, показывает баланс и выписку по счёту.
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Что делает 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 фиксируйте точную версию пакета: поведение между минорными выпусками может поменяться.
Какие задачи решает
- выставить счёт через Pix и отдать клиенту QR-код
- вернуть полученный Pix по endToEndId
- проверить, кому принадлежит ключ DICT, до перевода
- выпустить boleto и потом отменить его до оплаты
- снять баланс и выписку по счёту за нужный период
Примеры запросов агенту
- Создай заряд Pix на 250 реалов и покажи QR-код
- Проверь по ключу DICT, на кого он зарегистрирован
- Выпусти boleto по этому заказу и верни nosso_numero
Как установить mcp-banco-do-brasil
Командой платформы
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 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 сервера
Файл настроек
{
"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 сервера
Файл настроек
{
"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 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 сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-banco-do-brasil
Как установить mcp-banco-do-brasil в Claude Code?
Выполните `claude mcp add mcp-banco-do-brasil -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_KEY_PATH=<BB_KEY_PATH> -- npx -y @codespar/mcp-banco-do-brasil`.
Что делает mcp-banco-do-brasil?
Даёт агенту доступ к API Banco do Brasil: заряды и возвраты Pix, ключи DICT, boleto через Cobranças, баланс и выписка по conta-corrente.
Что нужно для работы в продакшене?
OAuth-пара BB_CLIENT_ID и BB_CLIENT_SECRET, ключ шлюза BB_DEVELOPER_APP_KEY, а для Pix v2 в production ещё сертификат и ключ mTLS через BB_CERT_PATH и BB_KEY_PATH.
