Tbank Myt

MCP-сервер для MyT, внутреннего приложения Т-Банка для сотрудников: расписание встреч, ответы на приглашения, отмена встречи, свободные машиноместа и бронь парковки в офисе.

Это не банковский MCP. Другой аккаунт, другие хосты, другая сессия. Если тебе нужны счета, переводы и продукты — это tbank-mcp, отдельный сервер; они не пересекаются и не мешают друг другу.

Что умеет

10 тулов. Календарь: calendar_schedule, calendar_event, calendar_respond, calendar_cancel. Парковка и офис: parking_places, parking_book, parking_cancel, office_bookings. Сессия: myt_status, myt_refresh_session.

2 скила — myt-calendar и myt-parking: порядок вызовов, правила подтверждения и то, что через MCP делать нельзя.

Чего тут нет, намеренно: создать или перенести встречу, забронировать переговорку, снять бронь рабочего места или локера. Соответствующих запросов у клиента не наблюдалось, а собирать их наугад на живом рабочем сервисе — это разослать мусор коллегам или снять чужую бронь.

Установка

git clone <этот репозиторий> tbank-myt && cd tbank-myt
python3 -m venv .venv && .venv/bin/pip install -e .
# Пакет называется tbank_myt, а не src: соседний банковский MCP ставит «src», и в
# одном окружении они затирали бы друг друга.

# MCP-сервер:
claude mcp add myt -- ./.venv/bin/python -m tbank_myt.server

# Скилы — КОПИЯ, за репозиторием она не следует. Повторяй после каждого pull,
# иначе установленные скилы описывают старую версию тулов:
cp -r skills/* ~/.claude/skills/

Вход — пароль не доходит до агента

.venv/bin/python login_cli.py <корпоративный логин>   # из клона
# или, если пакет установлен:  tbank-myt-login <корпоративный логин>
# [1/2] Пароль (не отображается): ****
#     SMS отправлена: +7 XXX ***-**-XX
# [2/2] SMS-код: ****
#
# ✓ ГОТОВО! Сессия сохранена: ~/.local/share/tbank-myt/session.json (права 0600).

Тула, принимающего пароль, здесь нет. Рабочий пароль открывает не один сервис, а все рабочие системы, и цена его попадания в транскрипт несопоставима с удобством.

Дальше сессия продлевается сама — обменом refresh-токена перед каждым запросом, за 120 секунд до истечения. Поэтому токен_живёт_ещё_секунд: 0 в myt_status() — это не «сессия умерла», а «прошёл час с прошлого вызова». myt_refresh_session() запускает обмен принудительно: он нужен, чтобы проверить именно refresh-токен (access бывает жив, когда refresh уже отозван). Здешний refresh-токен при обмене не ротируется, так что звать его можно свободно.

Полный вход нужен только когда тул сказал MYT SESSION EXPIRED. Работающий MCP-сервер подхватит новую сессию сам, со следующего же вызова: он сверяет файл перед каждым обращением. Перезапускать его или переподключать MCP не нужно — раньше было нужно, и об этом никто не догадывался, потому что тул продолжал советовать вход, который человек только что сделал.

Часовой пояс

Kairos отдаёт время встреч в UTC, а тулы приводят его к поясу сотрудника и подписывают в шапке. Пояс не угадывается: в workplacer 66 зданий в восьми поясах, от +02:00 до +10:00, поэтому он берётся из офиса самого сотрудника.

MYT_TZ переопределяет — +05:00 или Asia/Yekaterinburg. Нужен тому, кто уехал, работает удалённо или сидит не в том офисе, что записан в кадрах. Если офис определить не удалось, тулы возьмут Москву и скажут об этом в шапке, а не покажут молча неверный час.

Доверие сертификатам

kairos.tbank.ru и workplacer.tbank.ru проходят на системных CA. А вот magentbep.tcsbank.ru — хост выдачи и обмена токена — нет: он отдаёт цепочку с Russian Trusted Root CA (Минцифры), которого не везёт ни один системный стор. Без него не работает ни вход, ни продление, то есть ничего.

Корень приколот по SHA-256 и лежит в ca/roots/. Сертификаты никогда не берутся из сети — подробности в шапке src/tls.py.

Переменные окружения

Переменная	Что делает
MYT_SESSION	Путь к файлу сессии (по умолчанию ~/.local/share/tbank-myt/session.json)
MYT_PASSWORD	Пароль для login_cli.py вместо ввода с клавиатуры
MYT_TZ	Часовой пояс сотрудника: +05:00 или Asia/Yekaterinburg
MYT_TRACE	0 выключает трассировку вызовов
MYT_TRACE_FILE	Куда писать трассировку вызовов
MYT_EXTRA_CA	Дополнительный PEM в хранилище доверия

Тесты

.venv/bin/python tests/run_all.py

Тесты — обычные скрипты, без pytest; каждый запускается в своём процессе, а логи уводятся во временный каталог, чтобы прогон не дописывал ничего в реальные файлы.

Один из них, test_installed_package.py, проверяет не код, а установку: он поднимает сервер подпроцессом из постороннего каталога и говорит с ним по MCP — ровно как клиент, который стартует его из домашней директории. Остальные тесты кладут корень репозитория в sys.path и по построению не замечают, что pip install -e . устарел; а видно это только как Failed to connect в клиенте, без объяснения причины. Если этот тест упал — переустанови пакет.

Форма каждого запроса сверена с реальным трафиком клиента и закреплена фикстурой tests/fixtures/myt.json: структура настоящая, а люди, темы встреч, названия офисов и машина — синтетические. Отдельно проверяется то, что дороже всего стоило понять: floorId=nil уходит литеральной строкой, ответ на встречу пускают не чаще раза в 5 секунд, а 200 с пустым телом на брони и отмене ничего не значит — поэтому тулы перечитывают состояние и печатают его, а не факт успешного вызова.

Безопасность

• Пароль не проходит через агента: только вход отдельным процессом и getpass.
• Файл сессии — 0600; запись атомарная, и провал записи не выдаётся за успех.
• Номер машины и корпоративный логин не попадают в трассировку дословно.
• Захваты трафика и файл сессии — в .gitignore.

Дисклеймер

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