Сессия разработки: MCP, mainpic и один упрямый кэш

Сегодня в работе мы сфокусировались на развитии и отладке нашего приложения MCP (Model Context Protocol) для Webasyst. Это решение позволяет AI-агентам, таким как Claude или Cursor, напрямую взаимодействовать с сайтом через единый API-эндпоинт. Благодаря этому нейросети могут полноценно управлять контентом блога, CRM-системой и инструментами поддержки, работая напрямую с данными платформы. Для проверки работоспособности мы подключили два сайта — itfrogs.ru и demo05.covoxx.ru. В ходе сессии были созданы токены доступа и проведен ряд тестов через реальные вызовы. Это позволило подтвердить, что базовые механизмы интеграции между AI-инструментами и нашими модулями работают корректно в условиях реальной эксплуатации. В процессе отладки мы столкнулись с нетипичным багом: плагин mainpic (отвечающий за главные картинки постов) не отображался в MCP, хотя все настройки были верны. При диагностике выяснилось, что причиной была устаревшая кэшированная информация о обработчиках событий на сервере. После очистки кэша плагин стал доступен для работы через интерфейс AI-агента. Еще одна важная правка коснулась консистентности данных. Мы обнаружили ситуацию, когда одни инструменты API ожидали параметр «id», а другие — «post_id» для одной и той же сущности (поста в блоге). Чтобы ИИ-агенту не приходилось запоминать такие различия или гадать с неймингом, мы добавили поддержку обоих вариантов. Теперь взаимодействие между AI и системой стало более бесшовным. Также мы улучшили логику работы в плагине mainpic при загрузке изображений. Теперь система требует обязательного выбора профиля (набора размеров). Если выбор не сделан или подходящих профилей нет, инструмент выдает четкое пояснение действий вместо того, чтобы молча подставлять случайные значения по умолчанию. Это делает поведение системы предсказуемым как для пользователя, так и для автоматизированного агента. Завершили сессию финальным тестированием «в полях». Мы успешно создали несколько тестовых постов с изображениями через интерфейс AI-инструментов и опубликовали один из них. Все этапы прошли успешно: теперь работа с контентом в связке Webasyst + AI стала стабильнее и удобнее.