Справка › Подключить ИИ-агента (MCP)

Подключить ИИ-агента (MCP)

Обновлено: октябрь 2026

TeachTrack можно вести через вашего ИИ-агента: Codex, Claude Code, Cursor или любой другой, который умеет MCP. Агент видит расписание, учеников, долги и оплаты, ставит и переносит занятия, записывает оплату. Ключ бесплатный и работает на любом тарифе.

Что умеет агент

Показать расписание за период до двух месяцев, время в вашем часовом поясе.
Найти ученика по имени в любом написании и показать режим оплаты, остаток абонемента или долг.
Показать должников, оплаты ученика, сводку недели и доходы за месяц или год.
Отметить занятие проведённым, пропущенным или отменённым, а в группе отметить, кто был. Это учёт, он обратим, поэтому подтверждения не нужно.
С ключом, у которого есть право изменений: поставить занятие или серию, перенести одно занятие, добавить ученика, записать новую оплату.
С подпиской Copilot ещё и закрыть урок: вы рассказываете, что было на занятии, копилот готовит домашку и заметку к следующему уроку. Отправляете домашку ученику вы сами, в кабинете.

Чего агент не умеет: удалять занятия, писать ученикам, править и удалять оплаты, менять серию целиком и настройки кабинета. Это остаётся за вами.

Шаг 1. Создайте ключ

В настройках найдите раздел «Агенты (MCP)», дайте ключу название, например «Codex на ноутбуке», и нажмите «Создать ключ». Ключ показывается один раз, скопируйте его сразу.

Без галочки «Разрешить изменения» ключ только читает: расписание, учеников, долги и доходы. Если агент должен ставить занятия, отмечать уроки и записывать оплаты, поставьте галочку.

Ключей может быть до пяти. Отозванный ключ перестаёт работать сразу.

Шаг 2. Подключите агента

Адрес сервера: https://api.teachtrack.ru/mcp. Ключ передаётся в заголовке Authorization: Bearer <ключ>.

Codex: положите ключ в переменную окружения и добавьте сервер.

export TEACHTRACK_KEY=tt_ваш_ключ
codex mcp add teachtrack --url https://api.teachtrack.ru/mcp --bearer-token-env-var TEACHTRACK_KEY

Строку с export лучше дописать в ~/.zshrc или ~/.bashrc, иначе в новом окне терминала ключа не будет.

Claude Code:

claude mcp add --transport http teachtrack https://api.teachtrack.ru/mcp --header "Authorization: Bearer tt_ваш_ключ"

Cursor: в ~/.cursor/mcp.json или в настройках MCP проекта.

{
  "mcpServers": {
    "teachtrack": {
      "url": "https://api.teachtrack.ru/mcp",
      "headers": { "Authorization": "Bearer tt_ваш_ключ" }
    }
  }
}

Claude и ChatGPT в браузере пока не дают указать ключ в заголовке, с ними подключение не заработает.

Шаг 3. Попробуйте

Спросите агента: «Какие уроки у меня сегодня?», «Отметь урок с Максимом пропущенным», «Перенеси завтрашний урок с Аней на 17:00».

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

Ключ работает как пароль. Не пересылайте его и не кладите в общие файлы и репозитории. Если ключ утёк, отзовите его в настройках и создайте новый.
Мы храним только хэш ключа, сам ключ виден один раз при создании.
Смена пароля отзывает все ключи. После неё создайте новые.
Агент видит только ваших учеников и действует от вашего имени.
Агент получает данные учеников, которые запрашивает. Подключайте сервис, которому доверяете.
Имена учеников пишут люди. Участник открытой встречи сам задаёт своё имя, и в нём может оказаться «указание» для агента. Агенту сказано такие указания не выполнять и спрашивать вас перед каждым изменением, но проверить это мы не можем. Поэтому право изменений давайте только агенту, которому доверяете, и читайте, что он предлагает.
Если агенту нужно только смотреть, выдайте ключ без права изменений: тогда менять ему нечем.
С одного ключа не больше 120 запросов в минуту и не больше четырёх одновременно, а изменений через агента не больше 300 в сутки.

← Все разделы справки Не нашли ответ? Напишите мне