Начало работы

MCP (Model Context Protocol) — протокол, который позволяет настроить взаимодействие между языковыми моделями (LLM) и внешними источниками данных и инструментами. Подробнее.

MCP Т-Бизнеса — сервер, который расширяет возможности ИИ-агентов доступом к вашим счетам и операциям в T‑Бизнесе. Вы описываете задачу на обычном языке — агент сам вызывает нужные методы API для Т-Бизнеса и отвечает по результату.

Адрес сервера — https://mcp.tbank.ru/b2b.
Песочница — https://mcp.tbank.ru/sandbox/b2b. Возвращаются мок-данные из песочницы T-API. Для работы используйте Bearer-токен TBankSandboxToken.

Если основные домены не работают — используйте альтернативные: https://developer.tinkoff.ru/mcp/b2b и https://developer.tinkoff.ru/mcp/sandbox/b2b.

Как работает

Взаимодействие происходит между ИИ-агентом на вашей стороне и MCP-сервером API для Т-Бизнеса на стороне банка:

Ваша система — система, где размещен ИИ-агент: например, Claude Desktop или Yandex AI Studio.
ИИ-агент — компонент вашей системы, который отправляет запросы к MCP-серверу по протоколу MCP.
MCP-сервер Т-Бизнеса — компонент API для Т-Бизнеса, который обрабатывает запросы клиента и обращается к методам от имени агента.

Для каких задач подходит

Спросить остатки и обороты по счетам без входа в личный кабинет.
Выгрузить и проанализировать операции за период, по контрагенту и категории.
Встроить чтение выписки в своего ассистента, скрипт или таск-трекер через любой MCP-совместимый чат.
Сформировать счет на оплату контрагенту от имени компании — с указанными услугами или товарами, НДС, сроком оплаты, комментариями, назначением платежа.

MCP Т-Бизнеса в первой версии не подходит для запуска платежей, изменения реквизитов или любых операций с финансовым риском — для этого используйте методы API для Т-Бизнеса напрямую.

Поддерживаемые клиенты

MCP Т-Бизнеса совместим с любыми клиентами, которые поддерживают протокол MCP. Например:

Claude Desktop, Claude Code
Cursor, Windsurf, Qwen Code, Gemini CLI
Yandex AI Studio и другие MCP-совместимые агенты

Отказ от ответственности и условия использования

MCP-сервер T-API предоставляет AI-агентам доступ к данным вашего бизнеса в Т-Банке на основании выпущенного вами токена.

Информационный характер. Ответы AI-агента формируются на основе данных по вашим счетам и носят справочный характер. Агент может ошибаться, неверно интерпретировать данные или представлять их неполно. Принимая решения, проверяйте информацию в официальных каналах Т-Бизнеса — интернет-банк, мобильное приложение, выписки.
Передача данных во внешний сервис. Вы самостоятельно выбираете AI-приложение (хост), в котором используете MCP. При работе ваши данные передаются этому приложению и его провайдеру и обрабатываются на их стороне. Это происходит по вашему решению — Т-Банк не контролирует и не несет ответственности за обработку данных выбранным вами сервисом. Ознакомьтесь с политикой конфиденциальности вашего AI-приложения.
Ответственность за решения. Т-Банк не несет ответственности за решения, действия или убытки, возникшие в результате использования ответов AI-агента.
Доступ и токен. Вы отвечаете за сохранность токена доступа. Рекомендуем выпускать токен с минимально необходимым уровнем прав. При компрометации токена немедленно отзовите его в личном кабинете Т-Бизнеса.
Право на ограничение. Т-Банк вправе ограничить или приостановить доступ к MCP при обнаружении угроз безопасности, нарушений или нетипичной активности.
Объём доступа. Текущая версия предоставляет доступ только на чтение — информация по счетам и операциям. Операции, изменяющие состояние счёта, недоступны.

Подключение

Шаг 1. Авторизуйтесь

Есть два варианта авторизации:

Этот способ подходит, если вы хотите подключить данные своего бизнеса в LLM.

Выпустите токен в личном кабинете Т-Бизнес с нужными доступами. Доступы можно посмотреть в блоке Scopes нужного метода или на странице инструмента.

Про IP-ограничение токена

Запрос к MCP-серверу идет не из интерфейса приложения, а со стороны, где работает MCP-клиент:

для десктопных хостов (Claude Desktop, Cursor, VS Code) — с машины пользователя, IP которой заранее неизвестен и может меняться;
для веб- и облачных хостов (например, Yandex AI Studio) — с серверов провайдера.

Поэтому IP-адрес запроса непредсказуем. Рекомендуем выпускать токен для MCP без IP-ограничения. Если на токене уже включено IP-ограничение и его нужно снять — обратитесь в поддержку.

Шаг 2. Настройте MCP-клиент

Добавьте MCP-сервер Т-Бизнеса в конфигурацию вашего ИИ-приложения. Замените <token> на токен, полученный на шаге 1.

Добавьте блок в файл claude_desktop_config.json (требуется установленный Node.js):

{
  "mcpServers": {
    "t-business": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.tbank.ru/b2b", "-H", "Authorization: Bearer <token>"]
    }
  }
}

Или заголовок через env вместо флага -H:

{
  "mcpServers": {
    "t-business": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.tbank.ru/b2b"],
      "env": {
        "MCP_REMOTE_HEADERS": "Authorization: Bearer <token>"
      }
    }
  }
}

Шаг 3. Проверьте подключение

Перезапустите ИИ-клиент и задайте первый вопрос:

Покажи мои счета и остатки