tbank-myt
This server allows T-Bank employees to manage their work calendar, respond to meeting invitations, cancel organized meetings, and handle office parking and other office-related bookings within the internal MyT application.
Session Management:
myt_status— Check if the corporate session is alive.myt_refresh_session— Force-refresh the access token.
Calendar Management:
calendar_schedule— View work schedule for a date range (up to 14 days).calendar_event— Get meeting details (participants, link, location, etc.).calendar_respond— Respond to invitations (accept, decline, tentative).calendar_cancel— Cancel meetings you organized (irreversible, notifies participants).
Parking & Office Bookings:
parking_places— Find available parking spots for a date.parking_book— Book a parking spot.office_bookings— View existing office bookings (parking, workspaces, lockers).
Limitations: The server cannot create/reschedule meetings, book meeting rooms, cancel workspace/locker/parking bookings, or perform full login (login is done separately).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@tbank-myt забронируй парковочное место на завтра"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
Переменные окружения
Переменная | Что делает |
| Путь к файлу сессии (по умолчанию |
| Пароль для |
| Часовой пояс сотрудника: |
|
|
| Куда писать трассировку вызовов |
| Дополнительный 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 toolscalendar_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Детали встречиARead-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Рабочее расписаниеARead-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Статус корпоративной сессииARead-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Мои брони в офисеARead-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Свободные места на парковкеARead-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
Scored across 9 tools
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.
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.
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.
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
MCP server for lacita - appointment management software
MCP Server for an Agent Task Marketplace
MCP server for Travel & Transportation
MCP server for Product Management
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server that seamlessly interacts with your Google Calendar, Gmail, Drive and so on.30MIT
- AlicenseBqualityBmaintenanceMCP server for T-Bank's Time Messenger (Mattermost-based) that enables AI assistants to read and send messages, manage threads, search channels and users, and track unread messages.34314 npm7MIT
- AlicenseNot gradedqualityDmaintenanceUnified MCP server for calendar access connecting Exchange (EWS), Google Calendar, and CalDAV through a single MCP interface, enabling multi-calendar event management via natural language.1MIT
- FlicenseAqualityDmaintenanceAn MCP server that allows you to book and cancel office cab and lunch reservations using natural language, with optional automation features like attendance-based scheduling and Outlook leave detection.6-