T-Bank Business в MCP: счета, выписки и эквайринг в любом AI-агенте

Только self-hosted. T-API Т-Банка предъявляет TLS-сертификат, выданный Russian Trusted Root CA (НУЦ Минцифры), которому AnythingMCP Cloud не доверяет, поэтому этот коннектор недоступен в AnythingMCP Cloud. Он работает в экземпляре AnythingMCP, который вы запускаете сами, после того как корневой сертификат добавлен в его хранилище доверенных сертификатов, как описано ниже.

T-Bank Business

T-Bank Business (T-API, бывший Тинькофф Бизнес): реквизиты компании, счета и остатки, выписки с контрагентами, подтверждения платежей, статус выставленных счетов, терминалы и операции эквайринга. Только чтение.

Настройка

Настройка занимает около 10 минут. Нужен счёт компании в Т-Бизнесе и собственный экземпляр AnythingMCP, который доверяет Russian Trusted Root CA (см. Сертификаты ниже).

1. В Т-Бизнесе (business.tbank.ru) откройте Интеграции > T-API и нажмите Выпустить токен.
2. Укажите IP-адреса, с которых идут вызовы, или, для малого и среднего бизнеса, выберите Отключить проверку адреса. Вызовы идут с адреса вашего сервера AnythingMCP, поэтому разрешите этот адрес или отключите проверку.
3. В разделе К чему будет доступ у API отметьте как минимум информацию о компании (T-Business ID), информацию о счетах (bank-accounts/get) и операции по счетам (выписки); добавьте терминалы эквайринга, счета на оплату и вебхуки, если нужны эти инструменты. Токен можно ограничить отдельными счетами.
4. Скопируйте токен в TBANK_API_TOKEN. Он действует 90 дней с последнего использования, так что регулярно используемый токен не истекает. Чтобы изменить адреса или доступы, выпустите новый токен.
5. Укажите в TBANK_API_URL адрес https://business.tbank.ru/openapi. Для песочницы используйте https://business.tbank.ru/openapi/sandbox с токеном TBankSandboxToken; её ответы не зависят от ваших данных.
6. Установите коннектор и запустите tbank_get_company, чтобы проверить токен.

Сертификаты: T-API предъявляет TLS-сертификат Минцифры России (Russian Trusted Root CA); старые публичные сертификаты отозваны. Сервер, который не доверяет этому корневому сертификату, падает с ошибкой сертификата ещё до HTTP-статуса. Добавьте корневой сертификат (с gosuslugi.ru/crt) в хранилище доверенных сертификатов Node бэкенда AnythingMCP, например NODE_EXTRA_CA_CERTS=/path/russian_trusted_root_ca.pem, и перезапустите его.

Что он читает: компанию, которой принадлежит токен (полное и краткое название, ИНН, КПП, ОГРН, организационно-правовую форму, систему налогообложения, юридический адрес, дату регистрации и банковские реквизиты); счета компании со статусом, типом, валютой, тарифом и остатками; выписки с июня 2023 года с суммой, направлением, категорией, назначением платежа и контрагентом (название, ИНН, КПП, счёт, БИК банка) по каждой операции; банковское подтверждение исполненной операции в PDF; статус счетов, выставленных через T-API; терминалы эквайринга и их операции по картам; и настроенные вебхуки.

Как с ним работает ИИ: остатки берутся из tbank_list_accounts, где balance.otb означает сумму, доступную к расходованию сейчас. Для выписки он вызывает tbank_get_statement с account_number и from (и to) и листает страницы через cursor = nextCursor, пока тот не исчезнет; typeOfOperation Credit означает поступление, Debit списание, а counterparty_inns фильтрует по контрагенту. Как подтверждение платежа он получает tbank_get_payment_document с operationId и operationDate из выписки, и только когда вам нужен документ, потому что PDF большой. Для эквайринга он получает список терминалов через tbank_list_terminals, а затем вызывает tbank_list_terminal_operations по терминалу и дню.

Только чтение: все 8 инструментов только читают. Платежи не создаются и не подписываются, поэтому подтверждать нечего, и ни один инструмент не отключён при установке.

Даты и суммы: параметры и ответы с датой и временем передаются в ISO 8601 в UTC; операции в выходные проводятся следующим рабочим днём. Суммы указаны в валюте счёта (рубли с копейками в дробной части), кроме операций эквайринга, которые передаются в копейках.

Ограничения: выписки 20 вызовов в секунду, счета и компания 6, платёжные документы и эквайринг 1 в секунду. Выписки доступны с июня 2023 года.

Частые ошибки: 401 означает неверный или просроченный токен либо вызов с адреса, который токен не разрешает. 403 означает, что у токена нет доступа к этому методу (выпустите новый токен с нужной отметкой) или счёт не разрешён для этого токена. 422 называет неверный параметр, например номер счёта не из 20 цифр. В каждой ошибке есть errorId, который стоит сообщить поддержке Т-Банка.

Коннектор не проводит платежи, зарплатные реестры и выплаты самозанятым и не охватывает карточные методы за mTLS (secured-openapi) и партнёрскую интеграцию (OAuth).

Спрашивает перед каждым изменением: TBANK_API_URL, TBANK_API_TOKEN

Локальная установка коннектора

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

1. Открой http://localhost:3000 и зарегистрируйся. Первая учётная запись становится администратором.
2. Открой магазин коннекторов (http://localhost:3000/connectors/store), выбери T-Bank Business, введи запрошенные учётные данные (некоторым коннекторам они не нужны) и установи его.
3. В разделе MCP Servers создай сервер и назначь ему коннектор T-Bank Business. На странице сервера скопируй MCP endpoint (http://localhost:4000/mcp/<server-id>) и создай ключ в разделе API keys.

Quickstart слушает только localhost. Если нужен экземпляр, доступный другим людям или облачным AI-клиентам, клонируй репозиторий и запусти ./setup.sh: скрипт настроит домен, HTTPS и OAuth (руководство по развёртыванию).

Доступные инструменты

Примеры запросов

• «Какие сейчас остатки на всех наших счетах в Т-Банке и сколько можно потратить сегодня?»
• «Покажите поступления за прошлую неделю на наш основной счёт с контрагентом и назначением платежа.»
• «Сколько мы заплатили контрагенту с ИНН 7707083893 в этом квартале?»
• «Получите банковское подтверждение самого крупного вчерашнего списания в PDF.»
• «Сколько вчера принесли оплаты картами через наши терминалы эквайринга?»

Следующие шаги

• Подключить к Claude
• Подключить к ChatGPT