ИИ-агент для онлайн-школы на Prodamus.XL: подключить по MCP просто, научить работать в кабинете — нет

Подключить ИИ-агента к кабинету онлайн-школы сейчас проще, чем настроить новый тариф. У Prodamus.XL есть MCP-сервер для администратора: две команды, вход через браузер, и агент видит около тысячи операций платформы. Первые полчаса кажется, что сотрудник готов: агент сам находит заказы, читает чаты, считает подписчиков.

Потом он сохраняет письмо, платформа отвечает «готово», а в письме пусто. Отвечает человеку туда, куда тот не писал. Делает копию страницы, и копия сразу опубликована. Ничего из этого не ошибка модели: так ведёт себя платформа, и агент об этом не знает, пока ему не скажут.

С 14 октября 2026 года наш агент в Claude Code ведёт админку школы NeyroHub на Prodamus.XL. За две недели у нас набралось около 160 записей в журнале действий и 48 «граблей» — случаев, когда что-то пошло не так. В этом гайде подключению отведён один раздел, а главное — про то, как обучить ИИ-агента работать в кабинете: где хранится его знание, какие правила выросли из ошибок и как устроена страховка, чтобы он ничего не удалил сам.

Как подключить ИИ-агента к Prodamus.XL

MCP (Model Context Protocol) — стандартный способ подключить к ИИ-агенту внешнюю систему: агент получает набор операций и вызывает их, а платформа отвечает данными. Подробно про сам протокол — в гайде «Что такое MCP».

У Prodamus.XL MCP-сервер работает от имени администратора школы. Если школы на платформе ещё нет, начни с регистрации в Prodamus.XL — это наша спецссылка.

Всё для подключения платформа собрала на одной странице кабинета: Настройки → «ИИ-ассистенты (MCP)». Там адрес сервера https://mcp.xl.ru/admin, инструкции для дюжины приложений, примеры первых вопросов и объяснение, как устроен доступ. MCP у XL пока в режиме beta: найденные ошибки платформа просит присылать в техподдержку.

Кабинет школы, Настройки → «ИИ-ассистенты (MCP)», 28.10.2026.

Подключение — три шага: скопировать адрес, добавить его в приложение как MCP-сервер, войти в аккаунт XL в браузере. Ключ в настройки вставлять не нужно, пароль агенту не передаётся. По описанию в кабинете запросы ассистента проходят те же проверки доступа, что и админка: он работает от имени ключа доступа и может ровно то, что разрешают права ключа, и только в своей школе. Об этом — в разделе про доступ сотрудникам.

Тот же раздел: вкладка Claude Code, режим «Войти через XL».

Команды для популярных приложений мы свели в один блок — выбери своё и скопируй.

claude mcp add --transport http xl https://mcp.xl.ru/admin

codex mcp add xl --url https://mcp.xl.ru/admin
codex mcp login xl

{
  "mcpServers": {
    "xl": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.xl.ru/admin"]
    }
  }
}

{
  "mcpServers": {
    "xl": { "url": "https://mcp.xl.ru/admin" }
  }
}

{
  "mcpServers": {
    "xl": { "serverUrl": "https://mcp.xl.ru/admin" }
  }
}

Проверка простая: попроси агента показать список каналов чата и курсов школы. Ответил списком — подключение работает.

Одна особенность XL, которую стоит знать сразу: операций около тысячи, и агент не получает их все списком. Сервер даёт ему «мета-инструменты»: найти операцию по задаче, посмотреть её схему, прочитать или изменить. Поиск по каталогу — только на английском, поэтому агент сам переводит «найди неоплаченные заказы» в «order», «payment». Это нормально: просто не удивляйся, что первые запросы он строит по-английски.

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

Настоящий обмен с нашей школой 28.10.2026, вызовы и ответ — как в сессии, оформление упрощено для читаемости.

Почему подключённый агент ещё не сотрудник

У агента после подключения есть руки, но нет опыта работы именно в этом кабинете. Мы столкнулись с тремя проблемами, которые никакая модель не решит сама.

Платформа говорит «готово», а делает не то. Письмо, сохранённое через форму, молча теряет тело. Картинка курса «сохраняется» с ответом «успешно», но остаётся старой, потому что нужно другое поле. Сообщение отмечено отправленным, а через минуту получает статус ошибки по таймауту. Агент, который верит ответу платформы, доложит «сделано» о том, чего нет.

API и интерфейс видят разное. Часть диалогов (внутренний канал кабинета) через API не видна вообще. Признака «продление активно», который есть в интерфейсе, в ответе API нет. Агент, который смотрит только через API, однажды пропустит сообщение человека или примет отключённую подписку за активную.

Цена ошибки — люди и деньги. Рассылка по всей базе не отзывается. Массовое действие с пустым фильтром задевает всех учеников школы. Сообщение о возврате, отправленное не из того места, уходит «от системы», и его уже не исправить.

Поэтому вопрос не в том, умеет ли агент вызывать операции, — умеет. Вопрос в том, как настроить ИИ-агента, чтобы он знал ловушки конкретной платформы и не делал необратимого без человека.

Как обучить ИИ-агента работать с кабинетом: пять слоёв

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

1. Файл инструкций проекта

В папке, из которой агент работает с кабинетом, лежит файл инструкций — CLAUDE.md для Claude Code или AGENTS.md для Codex (как его собрать — в гайде про CLAUDE.md и файл о себе). В нём три части:

• в начале сессии: прочитать текущее состояние, план и обязательно журнал граблей по теме задачи;
• во время работы: каждое изменение записать в журнал действий, после сохранения открыть объект заново и сверить;
• в конце: запись о сессии, новые грабли, решения владельца.

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

2. Журнал действий

Каждое изменение в живой админке — строка в отдельном журнале: когда, раздел, что сделано, какой объект, кто подтвердил. Это не бюрократия. Когда через три дня ученик спрашивает «почему мне пришло два письма», ответ находится за минуту, а не реконструкцией по памяти. И когда что-то сломалось, видно, что именно агент менял перед этим.

3. Журнал граблей

Каждая ошибка — запись: что случилось, чем обернулось, какое правило из этого выросло и где оно закреплено. Агент читает грабли по теме задачи в начале каждой сессии. Так из одной ошибки получается правило, и та же ошибка случается заметно реже: агент знает о ней до начала работы.

Несколько правил, которые у нас выросли именно так:

• «Сохранено» — не значит сохранено. После каждого сохранения агент открывает объект заново и сверяет поля. Выросло из письма, которое платформа приняла без ошибки и сохранила без тела.
• Копия живёт своей жизнью. Копия страницы сайта в XL создаётся сразу опубликованной. Способа скопировать её без публикации мы не нашли, поэтому агент следующим же вызовом, без пауз и вопросов, снимает копию с публикации и проверяет это. Короткое окно остаётся, так что копируем только то, что не страшно показать на несколько секунд. Копия рассылки в форме ничего не сохраняет до кнопки «Создать», но сама подставляет отправку на ближайшее время: время агент выставляет явно и называет человеку до сохранения.
• Ответ — туда, откуда пришёл вопрос. У одного человека бывает несколько каналов и даже несколько профилей. Агент отвечает в тот диалог, где человек написал, и проверяет дубли профиля.
• Заказы — по дате оплаты, а не создания. Продление создаётся заранее, а оплачивается позже, поэтому выборка по дате создания теряет платежи.

4. Скиллы на повторяющиеся процессы

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

• Куратолог разбирает входящие сообщения: читает все каналы через API, потом проходит интерфейс вторым кругом (иначе часть сообщений не видна), отбирает важное, проверяет оплату и доступ человека, готовит ответ в тоне школы. Отвечает после «да».
• Подписолог смотрит непродлённые подписки: кто не продлил, была ли попытка списания, привязана ли карта, перешёл ли человек на другой факультет. В кабинете он только читает, а результат — отчёт и список, кому написать куратору.

Как выглядит скилл изнутри — упрощённый фрагмент «железных правил» Подписолога (без внутренних путей и полей):

Подписолог — контроль непродлённых подписок.

Перед стартом: прочитай грабли про продления и решение владельца о правилах продлений.
Время в отчёте — по Москве, в API даты — в UTC.

Железные правила:
1. В кабинете только читаешь. Подписку, доступ, карту и задачи не меняешь.
2. Управление подпиской — дело самого человека: подсказываем, как включить или
   выключить продление, но не делаем это за него.
3. Людям не пишешь без подписи владельца.
4. Персональные данные — только в папке данных, в журналы — без телефонов и почт.
5. Не судишь: в отчёте только факты — попытки списания, ошибка, привязана ли карта, история.

Результат: отчёт за период + выжимка владельцу: красные флаги (сорвалось втихую),
на контроле, ушли сами, перешли на другой факультет, кому написать сегодня.

С таким скиллом просьба «посмотри, кто не продлил за октябрь» превращается в один и тот же отчёт каждую неделю, а не в новую импровизацию. Отдельно — алгоритм возврата, о нём ниже. Хороший признак, что процессу нужен скилл: ты второй раз объясняешь агенту одно и то же.

5. Протокол «да» и страховка от удалений

Последний слой — то, что агент не делает без человека. И здесь мы не полагаемся только на текст инструкций.

«Да» — явное и конкретное. Перед действием агент показывает список: что создаст, изменит, опубликует или отправит, с названиями. Подтверждение — короткая фраза из закрытого списка: «да», «давай», «делай», «отправляй», «поехали». Вопрос, «подожди», «да, но…» и правка текста подтверждением не считаются. Правило про правку текста появилось после случая, когда агент принял исправленный черновик за разрешение и отправил сообщение. Теперь в денежных вопросах он ждёт отдельного «отправляй».

Удаление — отдельным сообщением на каждое. Общее «да» на удаления не распространяется: агент показывает, что уйдёт, и ждёт подтверждения именно на это удаление.

Массовые действия — только с фильтром по id. Пустой фильтр в XL задевает все записи школы.

Хук в Claude Code. Инструкцию агент может понять не так, поэтому у нас есть второй рубеж, который от понимания не зависит. Хук — короткий скрипт, который Claude Code запускает перед каждым вызовом операции XL. Если в названии операции есть «delete», «remove», «clear» и похожие слова или стоит флаг подтверждения, Claude Code останавливается и показывает окно: «разрешить?». Нажимает человек.

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

Правила работы в кабинете школы (Prodamus.XL, MCP).

1. В начале сессии прочитай журнал граблей по теме задачи. В конце допиши новые грабли и запись о сессии.
2. Каждое изменение в кабинете сразу записывай строкой в журнал действий: время, раздел, действие, объект, кто подтвердил.
3. После любого сохранения открой объект заново и сверь поля с тем, что собирался сохранить. Ответ «успешно» не доказательство.
4. Перед действием, которое создаёт, меняет, публикует или отправляет, покажи список действий с названиями и жди моего «да». Вопрос, «подожди», «да, но…» и правка текста — не подтверждение.
5. Удаление — только после отдельного «да» на каждое удаление. Сначала покажи, что именно уйдёт.
6. Массовые действия — только с фильтром по id. Пустой фильтр задевает всю школу.
7. Копию страницы сразу следующим вызовом снимай с публикации и проверяй. В копии рассылки выставляй время отправки явно и называй его мне до сохранения.
8. Отвечай человеку в тот диалог, куда он написал. Проверь, нет ли у него второго профиля.
9. Платежи и заказы ищи по дате оплаты. Большие выборки бери маленькими страницами.
10. Если API и интерфейс показывают разное, остановись: ничего не меняй, перечитай объект ещё раз и покажи мне оба результата.
11. Секреты (ключи, пароли, токены) не пиши ни в файлы, ни в ответы.

Сам хук — пара десятков строк. Вот упрощённая версия, которую можно положить в .claude/hooks/ своего проекта:

#!/usr/bin/env python3
# PreToolUse-хук: любое удаление через MCP платформы — только с подтверждения человека
import json, re, sys

data = json.load(sys.stdin)
inp = data.get("tool_input") or {}
op = str(inp.get("operationId", ""))
confirm = str(inp.get("confirm", "")).lower() == "true"

if re.search(r"delete|remove|clear|purge|destroy|erase|wipe", op, re.I) or confirm:
    print(json.dumps({"hookSpecificOutput": {
        "hookEventName": "PreToolUse",
        "permissionDecision": "ask",
        "permissionDecisionReason": f"Удаление ({op or 'confirm=true'}) — только с подтверждения человека.",
    }}, ensure_ascii=False))

Нужен установленный Python 3 (на Mac он обычно уже есть). Сохрани скрипт как .claude/hooks/confirm-delete.py и подключи его в .claude/settings.json проекта:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "mcp__xl__invoke_operation",
        "hooks": [
          { "type": "command", "command": "python3 \"$CLAUDE_PROJECT_DIR/.claude/hooks/confirm-delete.py\"" }
        ]
      }
    ]
  }
}

mcp__xl__invoke_operation — имя инструмента, через который агент меняет данные в XL (сервер у нас называется xl). Если у тебя сервер назван иначе, имя будет другим: его видно в окне разрешения, когда агент первый раз вызывает операцию. Проверка: перезапусти Claude Code, попроси агента удалить тестовый тег и нажми «отказать». Окно должно появиться до удаления, а тег — остаться на месте. Как устроены хуки, описано в документации Claude Code.

Доступ сотрудникам: свой ключ и минимум прав

Агент работает не только у владельца. Наш куратор клуба ведёт подписки со своим агентом в Codex — у него своя версия скилла Подписолога. Права владельца ему не нужны, а работать «из-под чужой учётки» — плохая идея: в журналах не разберёшь, кто что сделал. Поэтому у сотрудника свой ключ доступа к API школы, через который работает его агент, и на этом ключе — ровно те права, которые нужны его задаче.

Настройки → Ключи доступа / API-ключи: у каждого агента свой ключ. Секрет ключа на экране не показываем и в файлы не пишем.

Что мы узнали, настраивая такой ключ:

• Новый ключ создаётся без прав. Агент куратора подключился, но не видел ни одного участника. Ошибки не было — просто пустые ответы.
• Права ключа ставит владелец и только в интерфейсе. У куратора нет раздела настроек школы, поэтому галок прав в карточке ключа он не видит. Через API права ключа не читаются и не меняются: проверить, что выдано, можно только глазами, открыв карточку ключа заново.
• Выдавай минимум под задачу. Для отчёта по подпискам хватило двух галок: просмотр профиля контакта и просмотр доступа (факультет и дата окончания). Редактирование, удаление, задачи, продажи и платежи не выдали. Платежи — доступ владельца.
• Права не режутся по продуктам. В разделе «Продажи» только общие галки на все заказы и платежи школы. Если сотруднику нужен один факультет, выдать «только его» нельзя: либо все платежи, либо ничего.
• Не у всего есть галка «удаление». Позже ключу добавили работу с курсами и библиотеками без удаления, видео и файловый менеджер — как у куратора в его профиле. У видео и файлового менеджера отдельной галки «удаление» нет, так что удалять через них ключ, скорее всего, сможет. Это учитываем в правилах агента.
• Ключ при смене прав не меняется. Сотруднику не нужно ничего перевыпускать и переподключать: права подхватятся сами.
• Галка раздела выдаёт весь раздел. Подразделы в карточке свёрнуты, и клик по галке верхнего уровня включает всё внутри. Разворачивай стрелкой справа и ставь галки по одной.

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

Что агент делает в кабинете, а что решает человек

За две недели агент взял на себя почти всю рутину админки. Граница везде одна: агент готовит, проверяет и следит, а решение и необратимые шаги остаются за человеком.

Пара примеров, как это выглядит в цифрах. Рассылка сценарием на сегмент — один вызов и около 40 секунд вместо ручной отправки. Обложки курсов: агент за одну ночь подготовил 57 вариантов для 19 курсов (по три на курс), утром владелец выбрал, и агент загрузил их одним заходом, не удаляя старые. Про рассылки подробно — в отдельном гайде «Рассылки школы через ИИ-агента».

Был и день, когда агент оказался особенно полезен. Однажды у платформы был сбой: деньги в Prodamus прошли, а заказы в XL не создались, у части людей система потом списала повторно. Сверка «оплаты против заказов» нашла все такие случаи, и результат совпал с ручной проверкой. Компенсацию выбирал человек.

Возврат по шагам: где агент, где человек

Возврат — лучший пример того, как делить работу. Деньги, доступ и сообщение человеку: ошибка в любом месте неприятна. Поэтому у нас это отдельный алгоритм, и агент идёт по нему шаг за шагом.

1. Сводка (только чтение). Агент находит все профили человека, включая дубли, его заказы, доступы и диалог, где он попросил возврат. Решение «возвращаем» принимает владелец.
2. Возврат в Prodamus оформляет человек. Это деньги, и кнопку жмёт он.
3. Автопродление агент проверяет в интерфейсе, а не по API, и снимает только по слову владельца.
4. Заказ отменяется, в нём отмечается возврат. Агент проверяет, что статус платежа сменился.
5. Доступ убирается — по отдельному «да», после того как агент показал, что уйдёт и что останется. Иначе человеку продолжат приходить напоминания и попытки списания.
6. Сообщение человеку — по шаблону, после «да» на готовый текст, и только из диалога в интерфейсе: через API оно уходит «от системы», и его не исправить.
7. Закрытие: записи в журналы и проверка через несколько дней, что деньги дошли.

Чего агент не делает никогда: не удаляет заказы, платежи и сообщения и сам не предлагает возврат.

Ловушки Prodamus.XL, о которых стоит знать заранее

Если ты подключаешь агента к XL, этот список сэкономит тебе пару вечеров. Всё это мы нашли на своей школе в октябре 2026 года.

• Письмо через форму может потерять тело, если вставлен полный HTML-документ. Через API сохраняется целиком.
• Рассылка без профиля отправителя создаётся без ошибки, но письма не уходят.
• Очередь рассылок иногда зависает в «Подготовке» или при сбое шлёт одному человеку несколько копий. Важное ставь заранее и держи запасной путь через сценарий.

Живой экран нашей админки: 20.10 две рассылки остались на 0 %, запасной заход «замер очереди» ушёл. Названия агент пишет так, чтобы по списку была видна история; счётчики получателей скрыты.

• «Отправлено» через минуту может стать ошибкой по таймауту. Перечитывай статус через 10–15 секунд и ещё раз через минуту. Готово — когда при второй проверке статус всё ещё «отправлено»; ошибка — повод разбираться, а рассылку, которая застряла в «Подготовке», ставь на паузу и иди запасным путём.
• Копия страницы сайта сразу опубликована, а копия рассылки сама подставляет отправку на ближайшее время (сохраняется она только по кнопке «Создать»).
• Внутренний канал кабинета не виден в API: входящие проверяй ещё и через интерфейс.
• Галки «Продление активно» в API нет: смотри состояние доступа и проверяй глазами перед денежным шагом.
• Большие выборки отвечают таймаутом: бери маленькими страницами.
• Ответ «200» не гарантия: у некоторых полей есть «правильный» двойник. Узнать можно только перечитав объект.
• Даты в API — в UTC. 19:00 по Москве — это 16:00 по Гринвичу. Агент показывает обе записи.

MCP или браузер

Агент может работать с кабинетом и через встроенный браузер, кликая по интерфейсу. Мы пробовали оба пути. Правило получилось такое: сначала API через MCP, браузер — для того, чего API не видит. Через API быстрее и точнее, без «сессия слетела» и без промахов мимо кнопки. Браузер нужен, чтобы увидеть то, чего нет в API (внутренний канал, галка продления), и для пары действий, которые в API ведут себя иначе, — например, сообщение о возврате. Входит в браузер всегда человек, агент пароли не вводит.

С чего начать

Что дальше

Рассылки — самая рискованная часть работы агента в кабинете, им посвящён отдельный гайд: «Рассылки школы через ИИ-агента». Как устроены файлы, из которых агент берёт знание о проекте, — в гайде про CLAUDE.md и файл о себе. А если в кабинете работают несколько агентов или сессий, пригодится нейроштаб: Claude, Codex и Grok в одной папке.

Вопросы и ответы