Как подключить T-Bank Business к Claude через MCP

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

T-Bank Business + Claude

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

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

TBANK_API_URL, TBANK_API_TOKEN

Шаг 1 — Получите учётные данные

Настройка занимает около 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).

Шаг 2 — Установите адаптер

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 (руководство по развёртыванию).

Шаг 3 — Добавьте коннектор в Claude

Claude подключается к MCP-серверам двумя разными способами, и с quickstart на localhost работает только один из них.

Claude Code работает на твоём компьютере, поэтому может напрямую использовать локальный endpoint:

claude mcp add --transport http tbank http://localhost:4000/mcp/<server-id> --header "X-API-Key: <your-api-key>"

Проверь подключение командой claude mcp list.

Claude.ai и Claude Desktop добавляют удалённые серверы как пользовательские коннекторы: открой Customize → Connectors, нажми + и выбери Add custom connector (в планах Team и Enterprise его сначала добавляет владелец в Organization settings → Connectors). Claude открывает это соединение из облака Anthropic, а не с твоего компьютера, поэтому URL с localhost там не работает. Нужен экземпляр AnythingMCP с публичным HTTPS-адресом (см. ./setup.sh выше), который доверяет Russian Trusted Root CA (см. шаг 1). Вставь MCP endpoint этого экземпляра и войди в AnythingMCP, когда Claude попросит.

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

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

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

FAQ

Почему T-Bank Business недоступен в AnythingMCP Cloud? T-API предъявляет TLS-сертификат Минцифры России (Russian Trusted Root CA), а AnythingMCP Cloud не доверяет этому корневому сертификату, поэтому каждый вызов завершался бы ошибкой сертификата. В своём экземпляре AnythingMCP вы добавляете корневой сертификат через NODE_EXTRA_CA_CERTS и перезапускаете его.

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

• Страница коннектора
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Gemini
• Подключить к Meta Muse
• Подключить к Microsoft Copilot