{
  "markdown": "# MCP-сервер для бизнес-API Сбербанка — счета, выписки и платежи через ИИ\n\nЕсли вы искали, как подключить СберБизнес API к нейросети, посмотреть баланс и выписку по расчётному счёту или собрать платёж не открывая интернет-банк — это оно. 8 инструментов: счета, баланс, выписки, платежи, контрагенты. Спрашиваете «сколько пришло на счёт за неделю» — получаете сумму и список поступлений.\n\n[![npm](https://img.shields.io/npm/v/@theyahia/sber-mcp)](https://www.npmjs.com/package/@theyahia/sber-mcp)\n[![CI](https://github.com/theYahia/sber-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/theYahia/sber-mcp/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![smithery badge](https://smithery.ai/badge/@theyahia/sber-mcp)](https://smithery.ai/server/@theyahia/sber-mcp)\n\nЧасть серии [WWmcp](https://github.com/theYahia/WWmcp) от [@theYahia](https://github.com/theYahia).\n\n## Быстрый старт\n\n### Claude Desktop\n\n```json\n{\n  \"mcpServers\": {\n    \"sber\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@theyahia/sber-mcp\"],\n      \"env\": {\n        \"SBER_TOKEN\": \"ваш-bearer-токен\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add sber -e SBER_TOKEN=ваш-токен -- npx -y @theyahia/sber-mcp\n```\n\n### VS Code / Cursor\n\n```json\n{\n  \"servers\": {\n    \"sber\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@theyahia/sber-mcp\"],\n      \"env\": {\n        \"SBER_TOKEN\": \"ваш-bearer-токен\"\n      }\n    }\n  }\n}\n```\n\n### Windsurf\n\n```json\n{\n  \"mcpServers\": {\n    \"sber\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@theyahia/sber-mcp\"],\n      \"env\": {\n        \"SBER_TOKEN\": \"ваш-bearer-токен\"\n      }\n    }\n  }\n}\n```\n\n### Streamable HTTP (удалённо / Docker)\n\n```bash\nPORT=3000 npx -y @theyahia/sber-mcp --http\n```\n\nЭндпоинты:\n- `POST /mcp` — MCP Streamable HTTP транспорт\n- `GET /health` — проверка здоровья (`{ \"status\": \"ok\", \"tools\": 8 }`)\n\n## Переменные окружения\n\nАвторизация — **либо** прямой Bearer-токен, **либо** пара OAuth-кредов:\n\n| Переменная | Обязательна | Описание |\n|---|:--:|---|\n| `SBER_TOKEN` | один из | Прямой Bearer-токен API (синоним `SBER_ACCESS_TOKEN`) |\n| `SBER_CLIENT_ID` + `SBER_CLIENT_SECRET` | один из | OAuth client_credentials |\n| `SBER_BASE_URL` | нет | API-хост (дефолт `https://fintech.sberbank.ru:9443`) |\n| `SBER_OAUTH_URL` | нет | OAuth-эндпоинт (дефолт `https://api.sberbank.ru:8443/prod/tokens/v2/oauth`) |\n| `SBER_OAUTH_SCOPE` | нет | Space-separated scope (дефолт `GET_STATEMENT_ACCOUNT PAY_DOC_RU GET_CLIENT_ACCOUNTS`) |\n| `SBER_TIMEOUT_MS` | нет | Таймаут запроса в мс (дефолт 30000) |\n| `SBER_PFX_PATH` / `SBER_PFX_PASSPHRASE` | нет | mTLS: путь к `.p12`/`.pfx` и пароль |\n| `SBER_CERT_PATH` / `SBER_KEY_PATH` / `SBER_CA_PATH` | нет | mTLS: отдельные PEM-файлы (альтернатива PFX) |\n| `PORT` | нет | Порт HTTP-транспорта (дефолт 3000) |\n\n## Инструменты (8)\n\n### Счета\n\n| Инструмент | Описание |\n|---|---|\n| `get_accounts` | Список счетов клиента |\n| `get_balance` | Баланс по счёту |\n\n### Выписки\n\n| Инструмент | Описание |\n|---|---|\n| `get_statement` | Выписка по счёту за период (список транзакций, пагинация) |\n| `summarize_transactions` | Сводка: количество, поступления, списания, чистый итог |\n\n### Платежи\n\n| Инструмент | Описание |\n|---|---|\n| `create_payment` | Создание платёжного поручения (идемпотентно по RqUID) |\n| `get_payment_status` | Статус платежа по ID |\n\n### Контрагенты / Организация\n\n| Инструмент | Описание |\n|---|---|\n| `list_counterparties` | Список сохранённых контрагентов |\n| `get_company_info` | Сведения об организации (реквизиты, ИНН, счета) |\n\n## Demo-промпты\n\n```\nПокажи мои счета и баланс по рублёвому счёту\n```\n\n```\nСделай сводку транзакций по счёту 40702… за май: сколько пришло, сколько ушло, чистый итог\n```\n\n```\nСоздай платёжку на 150 000 ₽ контрагенту ООО «Ромашка», БИК 044525225, назначение «Оплата по договору №7», затем проверь статус\n```\n\n## Архитектура\n\n- **Авторизация**: прямой Bearer-токен (`SBER_TOKEN`) **или** OAuth client_credentials\n  (`SBER_CLIENT_ID`/`SBER_CLIENT_SECRET`, Basic-auth + scope), при необходимости поверх mTLS.\n- **Идемпотентность**: каждая денежная операция несёт один стабильный `x-Introspect-RqUID`\n  (32 hex) + `rq_uid` в теле, который **переиспользуется на всех ретраях** — Сбер дедуплицирует\n  повтор и не создаёт второй платёж. Можно передать свой ключ.\n- **Таймаут / ретраи**: 30с (настраивается), 3 попытки на 429/5xx/таймаут/сетевой сбой с\n  экспоненциальной задержкой (1с, 2с, 4с). Refresh OAuth-токена защищён от конкуренции.\n- **Транспорт**: stdio (по умолчанию) или Streamable HTTP (`--http` / `PORT`).\n\n## Соответствие API\n\nБоевой СберБизнес API закрыт за **mTLS и заявкой в банк**, поэтому реализация **не проверена\nпротив живого окружения**. Дефолты хостов, путей и scope соответствуют официальной документации\n([developers.sber.ru/docs/ru/sber-api](https://developers.sber.ru/docs/ru/sber-api/overview),\n[developers.sber.ru](https://developers.sber.ru/)) на дату ресёрча, но **точные пути\nэндпоинтов и имена параметров сверяйте с вашим интеграционным договором** — у Сбера сосуществуют\nпоколения API (v2 direct / v3 partners). Все хосты переопределяются через `SBER_BASE_URL`,\n`SBER_OAUTH_URL`, `SBER_OAUTH_SCOPE`. Пометки `VERIFY` в исходниках указывают на места,\nтребующие сверки.\n\n## Лицензия\n\nMIT — часть серии [WWmcp](https://github.com/theYahia/WWmcp).\n\n---\n\nЧасть [WWmcp](https://github.com/theYahia/WWmcp) · Telegram: [@vhodvai](https://t.me/vhodvai)\n",
  "bytes": 5484,
  "sha": "60ef2d0a6098ff3f5d903e8551dc7775dd08e14302f789d4e4b161f1138ba79b",
  "repo_slug": "theyahia/sber-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_theyahia_sber_mcp_631c2a0b/readme"
}