Точка Банк через MCP: 71 метод, конверт Data и деньги, которые движутся в обе стороны

Обзор

Расчётный счёт — данные, которые сложнее всего вытащить из банковского кабинета в рабочий процесс: балансы, выписки, статус платежей, СБП. У Точка Банка есть открытый API для этого, и Mira подключает его целиком — 71 метод в семнадцати разделах — через MCP-сервер, который видит Claude, Cursor и любой другой клиент протокола.

Это первый коннектор в категории «Финансы» Mira — до этого момента она существовала только как заголовок, зарезервированный под будущие банковские и кассовые интеграции.

Что доступно

Устройство, которое стоит знать заранее

Два способа получить токен — и они не взаимозаменяемы

У Точки есть JWT-ключ, который человек выпускает сам в интернет-банке (Сервисы → Интеграции и API → Создать JWT-ключ) — без одобрения банком, без похода к нам за авторизацией. И есть полноценный OAuth 2.0 — но он рассчитан на сервис, который работает от имени других клиентов банка, с их согласия: подходит платформе-агрегатору, а не подключению собственного счёта.

Mira подключает счёт владельца проекта — свой, не чужой, — поэтому коннектор устроен на JWT-ключе. Поле формы одно: сам ключ. client_id, который банк показывает рядом с ключом при создании, нужен отдельно — только для настройки вебхуков — и необязателен.

Тело запроса — конверт, а не плоский JSON

Почти все методы Точки ждут тело вида {"Data": {...поля...}} — обёртка обязательна, даже когда все поля внутри пустые. Три метода вебхуков — исключение: их тело плоское. Ещё одно исключение — метод разрешений: поле Risks спецификация кладёт рядом с Data, а не внутри него. В MCP это скрыто целиком: модель называет поля, а конверт собирает инструмент.

Деньги — две шкалы, которые легко перепутать

Платежи и эквайринг считаются в рублях дробным числом: 700.33 — это 700 рублей 33 копейки. А QR-коды СБП — все три вида — считаются в копейках целым числом: 500000 — это 5000 рублей. Спутать шкалу значит либо создать QR на сумму в сто раз меньше нужной, либо, наоборот, попытаться принять в сто раз больше. Единица явно названа при каждом действии, где это важно — общего правила у поставщика нет, и выдумывать его нельзя.

Барьер: деньги двигаются в обе стороны

Из 71 метода 31 меняет данные, но только 5 переводят деньги по-настоящему: создание платежа, списание при двухэтапной оплате, списание по подписке и два вида возврата. Остальные меняющие действия — создание QR-кода, ссылки на оплату, подписки, счёта — это предложение заплатить, а не факт оплаты: деньги придут только если и когда кто-то по ним заплатит.

Это отличает Точку от рекламных кабинетов вроде Ozon Performance, где «тратит» значит «тратит НАШИ деньги». У банка деньги движутся в обе стороны — иногда наши, иногда чужие, которые проходят через нас, — и ошибиться в любую сторону одинаково дорого.

Номер счёта содержит «/» — и это нормально

У Точки счета названы вида 40817810802000000008/044525104. У большинства API символ «/» в идентификаторе — признак чужой попытки вставить лишний сегмент в адрес запроса. Здесь — законная часть номера счёта. Инструмент не отвергает такие значения, а кодирует их: «/» превращается в %2F и остаётся частью одного сегмента пути, а не создаёт новый маршрут. Оба требования выполняются одновременно — счета с «/» работают, а попытка подменить путь так и остаётся одним закодированным куском текста.

Как это выглядит через MCP

Сколько денег на счетах и когда последнее поступление?

Claude запрашивает балансы по всем счетам и последние операции, не заходя в интернет-банк.

Заказать выписку за август по расчётному счёту и дождаться результата

Claude заказывает выписку, опрашивает готовность через составное действие wait_for_statement и возвращает данные, как только банк их подготовил — без ручного «проверьте через минуту».

Что защищено от случайного действия

Создание платежа, списание по эквайрингу или подписке, любой из двух возвратов — требуют разрешения на запись у источника и подтверждения. Барьер выведен из той же таблицы, где описан каждый метод, — тем же устройством, что у Авито и Ozon Performance в Mira.

Как подключить

1. Интернет-банк Точки → Сервисы → Интеграции и API → Создать JWT-ключ.
2. Задать срок жизни и разрешения, скопировать ключ и, если нужны вебхуки, client_id рядом с ним.
3. В Mira: проект → источники → Точка Банк → вставить ключ.

Дальше Точка Банк доступна и в чате Mira, и через MCP-сервер в Claude, Cursor или другом клиенте с поддержкой протокола.