MCP-плагин для сценариев BotHelp
bothelp-mcp
MCP-сервер и плагин Claude Code для чтения и правки графа сценариев BotHelp и рассылок через приватный WebSocket конструктора flow2
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Правит живой граф сценария бота: блоки, переходы, раскладку
- Создает, повторяет и отменяет рассылки подписчикам
- Использует перехваченную сессию оператора через приватный недокументированный протокол
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/bothelp-mcpОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Выполните по очереди в чате Claude Code
/plugin marketplace add skiddgoddamn/bothelp-mcp
/plugin install bothelp-mcp@bothelpУстанови плагином /plugin marketplace add skiddgoddamn/bothelp-mcp и /plugin install bothelp-mcp@bothelp, затем авторизуйся инструментом login_password с subdomain, email и паролем оператора BotHelp, либо задай BOTHELP_SUBDOMAIN, BOTHELP_EMAIL и BOTHELP_PASSWORD в env сервера.
Другие способы из описания автора
/plugin marketplace add skiddgoddamn/bothelp-mcp
/plugin install bothelp-mcp@bothelpВариант A из README, проверить можно командами /mcp и /plugin.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает 25 инструментов поверх двух возможностей BotHelp, недоступных публичному Open API: правку графа сценария (блоки, переходы, раскладка канваса) и управление рассылками (создание, повтор с новым текстом или кнопками, отмена, удаление, черновик или отправка сейчас). Публичный Open API BotHelp только читает и запускает сценарии, а редактировать граф умеет лишь веб-конструктор flow2 через приватный недокументированный WebSocket-RPC на библиотеке Primus, и этот сервер это тонкая обертка над теми же методами. Авторизация идет не токеном Open API, а сессией оператора: либо логином и паролем напрямую (пароль нигде не сохраняется, в конфиг попадает только полученный sessionId), либо готовым sessionId, перехваченным из DevTools. Escape-hatch call позволяет вызвать любой метод конструктора напрямую.
Для кого. Для тех, кто строит и правит сценарии ботов BotHelp и хочет делать это из Claude Code, а не только руками в веб-конструкторе.
Подходит, если
- Нужно менять граф сценария (блоки, переходы, раскладку) программно
- Нужно запланировать, повторить с правками или отменить рассылку
- Открыт тестовый бот, на котором можно безопасно проверять правки перед продакшеном
Не подходит, если
- Хочется работать по официальному стабильному API, а не приватному протоколу, который может измениться без предупреждения
- Нужен только просмотр статистики через Open API, для этого есть отдельный скилл этого же автора
- Не готовы обкатывать правки на тестовом боте перед применением к живому сценарию
Пример запроса к агенту
Повтори последнюю рассылку broadcastId 42 с новым текстом и замени utm в ссылках, сначала покажи dry-runОграничения
Протокол приватный, недокументированный и неофициальный: сам автор предупреждает, что он может измениться без предупреждения, и советует проверять правки на тестовом боте, потому что add_block, delete_block и save_layout меняют живой сценарий. README прямо называет проект неофициальным клиентом, не аффилированным с BotHelp, и советует использовать его в рамках условий сервиса. Для полностью официального подхода с API-токеном вместо перехваченной сессии автор указывает альтернативу retensy-mcp.
Как отключить. Выполни /plugin uninstall bothelp-mcp в Claude Code или удали сервер bothelp-mcp из конфигурации MCP-клиента.
Проверка безопасности
- Правит живой граф сценария бота: блоки, переходы, раскладку
- Создает, повторяет и отменяет рассылки подписчикам
- Использует перехваченную сессию оператора через приватный недокументированный протокол
Коротко о README
README подробно объясняет, почему сервер использует WebSocket, а не Open API: публичный REST только читает и запускает, а править граф умеет лишь конструктор flow2 через приватный протокол Primus. Перечислены 25 инструментов по сценариям и рассылкам, два способа авторизации сессией вместо токена, установка плагином или обычным MCP через npx, escape-hatch call на любой метод и явное предупреждение о неофициальном статусе с советом тестировать на тестовом боте и ссылкой на официальную альтернативу retensy-mcp.
Частые вопросы
Почему нельзя просто использовать официальный Open API?
Open API BotHelp только читает и запускает сценарии, редактировать граф и управлять рассылками умеет лишь приватный WebSocket-RPC веб-конструктора flow2, который и оборачивает этот сервер.
Пароль передается и хранится где-то?
Нет, при входе через login_password пароль используется один раз для получения sessionId и в конфиг не попадает, сохраняется только сама сессия.
Похожие
Скилл, который убирает из текста приметы ИИ-письма по списку Википедии и не добавляет выдуманных фактов
Marketing Skills: маркетинговые скиллы для агентов
Marketing Skills for AI Agents
Около пятидесяти скиллов по CRO, копирайтингу, SEO, аналитике, рекламе и запуску продукта для кодовых агентов
MCP-сервер SendPulse
SendPulse MCP
Официальный удаленный MCP-сервер SendPulse: статистика, рассылки и данные пользователей через чат с агентом
MCP Яндекс Директа из машиночитаемой схемы
yandex-direct-mcp
MCP-сервер и CLI на всех 113 методах API v5 Яндекс Директа, собранных из WSDL: по умолчанию только 9 читающих, запись включается явно