Что агент делает со счетом в Точке
Точка описывает работу с ИИ-агентами в своей документации. Ее MCP-сервер по адресу api.tochka.com/mcp дает 6 инструментов: список компаний, список счетов, данные счета, баланс, выписку и создание платежа на подпись. В каталоге SkillFoxx этого сервера пока нет, зато есть серверы независимых авторов с более широким набором операций.
- Балансы, операции и подготовка платежа. MCP для банка Точка дает 7 инструментов поверх боевого API. Платеж сначала показывается превью и уходит в интернет-банк только с флагом confirm, а лимит суммы и белый список получателей задаются переменными окружения.
- Счета, УПД и эквайринг. MCP-сервер банка Точка покрывает больше 30 операций, включая выставление счетов с PDF, создание УПД, СБП и рекуррентные подписки. Он же работает как CLI с выводом в JSON.
- Сверка выписки с учетом. FinContext MCP разворачивается в Yandex Cloud клиента и показывает кэш по счетам Точки и МоегоСклада. Сверка выписки и прогноз кассового разрыва доступны по платной Pro-лицензии. Для пробы есть демо-режим без токенов.
Как получить JWT-ключ API Точки
Ключ выпускают в интернет-банке на вкладке «Сервисы», в разделе «Интеграции и API». Для обычной интеграции там есть кнопка «Создать JWT-ключ», а для агента по MCP банк предлагает «Создание JWT-ключа для LLM». Дальше задают название, срок доступа и разрешения, а выпуск подтверждают кодом из SMS.
По умолчанию отмечены все разрешения. Для агента, который смотрит баланс и выписки, хватит «Получение информации по счетам» и «Создание выписок». Право «Создание и получение платежей» лучше не выдавать. Один токен работает с одной компанией, и для второго ИП или юрлица нужен отдельный.
У JWT нет refresh-токена. Задача на перевыпуск появляется в интернет-банке за 7 дней до конца срока. Ключ перевыпускают вручную, и вместе с ним меняется client_id. OAuth 2.0 нужен, если интеграция работает для других клиентов банка. Его использует MCP для банка Точка, где access-токен живет около суток, а refresh около месяца.
Банк работает на TLS-сертификатах Минцифры, поэтому Russian Trusted Root CA и Sub CA нужно добавить в хранилище того окружения, где запущен сервер. Для Node.js путь к сертификату задают переменной NODE_EXTRA_CA_CERTS. После сертификатов подключается сам сервер.
npx skillfoxx add mcp/tochka-bank-mcp
Тестовая среда Точки
Песочница доступна по адресу enter.tochka.com/sandbox/v2 с единым токеном sandbox.jwt.token. Генерировать ключи для нее не нужно. Тестовая компания имеет customerCode 1234567ab. Ответы в песочнице зафиксированы и не зависят от переданных значений, поэтому она проверяет формат запросов и авторизацию, а бизнес-логику не проверяет.
Оплатить платежную ссылку в песочнице нельзя. Сценарии с подтверждением человеком работают только на боевом слое. У MCP для банка Точка песочница подключается отдельным базовым URL. С нее и стоит начинать проверку агента.
Риски доступа к счету
Агент действует от имени компании в пределах разрешений токена. Выписка раскрывает контрагентов, суммы и назначения платежей, поэтому даже ключ только на чтение передает модели чувствительные данные. Утекший токен банк советует удалить и выпустить новый.
В обоих серверах с платежами исходящий платеж ждет подписи человека в интернет-банке. Но у MCP-сервера банка Точка операции эквайринга capture и refund списывают и возвращают деньги сразу, а трекер оплат хранит данные счетов в незашифрованном JSON на диске.
У серверов с платежами широкий уровень доступа, а у FinContext расширенный. VPN ни одному из них не нужен. Сервера от самого банка в каталоге пока нет. Оферта на Open API ограничивает интеграцию 1000 запросами в минуту.