Skip to main content
Glama

MyT MCP — рабочий календарь и парковка

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 делать нельзя.

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

Related MCP server: time-messenger-mcp-server

Установка

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.

Дисклеймер

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

Available Tools

9 tools
calendar_cancelОтмена встречиA

Отменить встречу — НЕОБРАТИМО, уведомление уйдёт всем участникам.

Работает только у организатора. Спроси подтверждение с названием и временем, прежде чем вызывать.

occurrence — КАКОЕ вхождение отменяем. Достаточно даты: «2026-08-05», «завтра». Тул сам найдёт в этом дне нужную встречу и возьмёт её исходный момент — то есть ключ, который требует kairos. Для разовой встречи можно не передавать вовсе. Точный момент из kairos (2026-08-05T12:00:00+00:00) тоже принимается, если он у тебя откуда-то есть.

Для ПОВТОРЯЮЩЕЙСЯ встречи дата обязательна: сама встреча знает только начало ВСЕЙ серии, а отмена по нему возвращает 200 и не отменяет ничего. 200 здесь вообще ничего не доказывает, поэтому тул после отмены перечитывает день и печатает, что вышло на самом деле — верь этой строке, а не факту вызова.

Inputs: appointment_id (required), occurrence. Returns: result

calendar_eventДетали встречиA
Read-onlyIdempotent

Детали встречи: участники, ссылка на созвон, место, повестка, повторяемость.

appointment_id — из calendar_schedule().

Для ПОВТОРЯЮЩЕЙСЯ встречи kairos отдаёт не то вхождение, которое ты открыл, а мастер серии: start там — дата ПЕРВОЙ встречи серии, часто многолетней давности. Поле «повторяется» об этом скажет; время конкретного вхождения бери из calendar_schedule().

Inputs: appointment_id (required). Returns: result

calendar_respondОтвет на приглашениеA

Ответить на приглашение: «пойду» / «не пойду» / «может быть».

Ответ видят организатор и все участники, и он перезаписывает предыдущий — покажи пользователю НАЗВАНИЕ встречи и выбранный ответ, прежде чем звать.

response: пойду/да/Accept, не пойду/нет/Decline, может быть/Tentative. Чужие формулировки не угадываются — при непонятном значении будет ошибка. comment — необязательный текст организатору (уходит в поле answer).

Kairos пускает не чаще одного ответа в 5 секунд; тул сам ждёт и повторяет один раз, так что серия ответов подряд — это нормально, просто небыстро.

Inputs: response (required), appointment_id (required), comment. Returns: result

calendar_scheduleРабочее расписаниеA
Read-onlyIdempotent

Рабочее расписание из MyT (корпоративный календарь, НЕ банк).

Пустые даты = сегодня; date_to включительно, принимаются «завтра»/«послезавтра». Один день = один запрос к kairos (так же ходит само приложение), поэтому диапазон ограничен 14 днями — дальше вызови ещё раз со сдвигом.

Время приводится к поясу СОТРУДНИКА и подписано в шапке. Kairos отдаёт момент в UTC, а офисы компании стоят в восьми поясах, от +02:00 до +10:00, поэтому пояс берётся из офиса сотрудника (workplacer), а не предполагается. Переопределить: переменная окружения MYT_TZ («+05:00» или «Asia/Yekaterinburg») — нужна тому, кто уехал или работает не из своего офиса.

Дальше: calendar_event(id) — участники, ссылка на созвон, повестка; calendar_respond(id, «пойду»/«не пойду»/«может быть») — ответить.

Inputs: limit, date_to, date_from. Returns: result

myt_refresh_sessionОбновление корпоративной сессииA

Обменять refresh-токен MyT на свежий access — принудительно, прямо сейчас.

Обычно НЕ нужен: обмен делается сам перед каждым запросом, за 120 секунд до истечения, поэтому нулевой остаток в myt_status() не значит «сессия умерла». Тул для двух случаев, которые сами собой не покрываются: проверить именно REFRESH-токен (access бывает жив, а refresh уже отозван администратором), и обновиться перед длинной цепочкой вызовов, чтобы обмен не пришёлся на середину брони.

Refresh-токен при обмене НЕ ротируется: сервер возвращает тот же самый. Поэтому повторный вызов ничего не сжигает — звать можно свободно.

Если refresh-токен мёртв — MYT SESSION EXPIRED. Дальше только полный перелогин (.venv/bin/python login_cli.py <логин>), он требует пароля и SMS, и ни один тул его не заменит. Пароль у пользователя не спрашивай.

Inputs: no named parameters. Returns: result

myt_statusСтатус корпоративной сессииA
Read-onlyIdempotent

Жива ли корпоративная сессия MyT — проверяет ЗАПРОСОМ, а не арифметикой. Секретов не печатает.

Токен продлевается сам перед любым запросом, за 120 секунд до истечения, поэтому нулевой остаток НЕ значит «сессия мертва». Этот тул делает обычный читающий запрос и отвечает по его результату — про состояние на сервере, а не про часы на машине, где крутится MCP. Обновить сессию принудительно — myt_refresh_session().

Как и любой читающий тул здесь, он может по дороге переминтить токен и переписать файл сессии: это поддержание доступа, а не изменение чего-то в мире пользователя. Если запись не удалась, ответ об этом скажет — молча «успешно» не вернёт.

Чего не может ни один тул — полного перелогина: он требует пароля и SMS и живёт в .venv/bin/python login_cli.py <логин>. Если сессия действительно мертва, ответ так и скажет; предлагать пользователю передать пароль не надо.

MyT — рабочее приложение Т-Банка. Если у тебя подключён ещё и банковский MCP: это другой аккаунт и другая сессия, его refresh_session() сюда не относится.

Inputs: no named parameters. Returns: result

office_bookingsМои брони в офисеA
Read-onlyIdempotent

Мои брони в офисе: парковка, рабочее место, локеры (MyT, НЕ банк).

Пустая дата = сегодня. Возвращает брони НАЧИНАЯ с этой даты, а не только за неё — то есть одного вызова хватает, чтобы увидеть всё окно вперёд.

Отменить бронь парковки этот MCP не умеет: такого запроса нет, а угадывать метод и путь на живом сервисе нельзя. Отмена — в приложении MyT.

Inputs: date. Returns: result

parking_bookБронь места на парковкеA

Забронировать место на парковке — занимает реальное место, денег не двигает.

date и place_id обязательны: place_id — это place_id из parking_places(). Пустые car_number/car_model/building_id берутся из прошлой брони.

Сервер отвечает 200 с ПУСТЫМ телом и на успех, и молча — поэтому тул после записи перечитывает брони и печатает то, что действительно сохранилось. Номер машины при этом вернётся транслитом (А000АА000 → A000AA000): так его хранит workplacer, это не ошибка.

Inputs: date (required), place_id (required), car_model, car_number, +1 more. Returns: result

parking_placesСвободные места на парковкеA
Read-onlyIdempotent

Свободные места на парковке офиса на дату (MyT, НЕ банк).

Пустая дата = завтра: бронь открывается заранее, и «сегодня» почти всегда уже поздно. building_id пустой = здание последней брони, иначе первое из списка.

Стоит 4 запроса (настройки, здания, прошлая бронь, рекомендации) — это ровно то, что нужно, чтобы ответить «где мне парковаться» одним вызовом: список зданий, окно бронирования, машина по умолчанию и сами места.

Дальше: parking_book(date, place_id) — id места это mapElementId.

Inputs: date, building_id. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 9 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action: session status vs refresh, calendar schedule/event/respond/cancel, parking availability/booking, and office bookings listing. The descriptions clearly differentiate the two session tools and the calendar action verbs, leaving no ambiguity.

    Naming Consistency4/5

    Tool names follow a consistent domain-prefix pattern: myt_ for session, calendar_ for calendar, parking_ for parking, office_ for office bookings. Within each domain, names mix nouns (status, schedule, places) and verbs (refresh, respond, cancel, book), but the overall structure is predictable and readable.

    Tool Count5/5

    9 tools is well-scoped for the stated purpose: the server covers session management, calendar operations, and parking/office bookings without bloat. Each tool serves a distinct need and earns its place.

    Completeness3/5

    The set covers core workflows well: calendar has list/detail/respond/cancel, parking has availability and booking, and office bookings offers a read-only summary. However, obvious gaps exist: parking bookings cannot be canceled, and there is no tool to create or update calendar events, leaving some operations as dead ends.

    Related MCP Connectors

    Related MCP Servers