operbots-mcp

MCP-сервер панели operbots. Даёт Claude Code и другим клиентам MCP работать с делами, телеграм-ботами, сценариями на полотне, перепиской, рассылками, базой знаний и подключениями к ИИ.

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

собери сценарий приёма заявок для бота поддержки и прогони его на «привет»
покажи диалоги, где ждут ответа дольше часа, и ответь им от имени бота
добавь в базу знаний прайс со страницы example.com/prices и проверь поиск
составь рассылку про новый прайс клиентам, кроме отписавшихся, и покажи, кому уйдёт
почему бот молчит со вчера — посмотри его журнал

Требуется Node 20 или новее.

Установка

npx operbots-mcp@latest setup

Одна команда спрашивает всё нужное и подключает плагин сама: адрес панели, токен, дело по умолчанию. Токен выпускается в панели — аккаунт → Интеграции → «Выпустить токен»; значение показывается один раз, скопируйте сразу. По итогу перезапустите Claude Code.

Проверить в любой момент: npx operbots-mcp status.

Плагин везёт сервер с собой и запускает его настоящим node по полному пути. При старте ничего не качается и не разрешается по имени — потому что именно там установка и разваливалась: npx на Windows оказывался .cmd, на холодном кэше уходил в реестр дольше рукопожатия, а про старый Node молчал вовсе.

Другие клиенты MCP

operbots-mcp setup в конце печатает готовую строку запуска с полным путём — её и вставляйте в свой клиент. Плагины Claude Code при этом не нужны.

Related MCP server: Telegram MCP Server

Доступ

Пароль сервер не видит и не хранит: на диск ложится только токен — ~/.operbots/credentials.json с правами 600. В самой панели значения тоже нет, там лежит лишь его отпечаток, поэтому даже из базы токен не восстановить.

Отозвать доступ — в панели, аккаунт → Интеграции. Отзыв действует сразу и только для этого токена: остальные машины продолжают работать. Команда operbots-mcp logout лишь стирает токен с этой машины, сам он остаётся живым.

Выпускать и отзывать токены можно только из панели — по токену нельзя, иначе утёкший ключ выписывал бы себе новые.

Настройки

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

Инструменты

72 штуки. Дела, ботов, сценарии, материалы, заготовки, рассылки и подключения можно называть по имени — идентификаторы не нужны: flows_publish bot="бот поддержки" flow="Приём заявок".

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

Режим OPERBOTS_READ_ONLY=1 оставляет 29 инструментов: всё чтение плюс operbots_login и operbots_logout — они правят не панель, а токен на этой машине, и без них человек с отозванным токеном остался бы с советом войти и без способа это сделать.

Рассылка

Составляют и отправляют в два шага. broadcasts_save заводит черновик — он никуда не уходит, даже если задан срок. Отправку начинает только broadcasts_start, и она необратима: разосланное не отзывается ни у одного получателя. Между ними — broadcasts_preview: он показывает, сколько разговоров подошло под условия, кто именно и что настораживает в самом сообщении. Отбор без единого условия означает всех собеседников бота, а забытое условие выглядит ровно так же — потому предпросмотр и стоит смотреть всегда.

Условий семь: кто ведёт разговор, метки, метки-исключения, назначенный участник, молчание дольше стольких дней, язык и «без получателей прошлой рассылки». Восьмого — «пришли не раньше такого-то дня» — здесь нет: панель его объявляет, но отвечает на него внутренней ошибкой, и вернуть его можно будет вместе с починкой панели.

Что не выведено

Наружу намеренно не выведены регистрация и смена пароля, выпуск и отзыв токенов, выход на всех устройствах, оформление панели, поиск людей по установке, служебные вебхуки Telegram и живая лента событий.

Файлы MCP не передаёт, поэтому вложения остаются делом панели: отправить картинку в разговор, приложить файл к рассылке и скачать присланное отсюда нельзя. Текстовая выгрузка переписки при этом есть — dialogs_export.

Уведомления не выведены сознательно: лента личная и сквозная по делам, а то, что в ней пишут, целиком повторяют журнал бота (bots_journal) и журнал дела (audit_list) — оба уже здесь. Ради самой ленты понадобилось бы четыре инструмента, из которых единственный по-настоящему действующий гасил бы человеку счётчик непрочитанного.

Расход на модели (/ai-usage в панели) пока не выведен — это отставание, а не решение.

Значения секретных переменных бота панель отдаёт открыто, а сервер скрывает — видно только имя.

Полотно

Граф отдаётся и принимается плоским, без внутренностей редактора:

узлы:
  - id: start
    kind: trigger.command
    config: { command: start }
  - id: hello
    kind: action.message
    config: { text: Здравствуйте! Чем помочь? }
связи:
  - from: start
    to: hello

Правка заменяет граф целиком: сначала flows_get, затем flows_save со всеми узлами. Размеры и положение карты переносятся из текущей редакции, поэтому правка одного узла не сбивает вид полотна. Состав config — в operbots_catalog what=node_kinds. Новая редакция создаётся, только если граф действительно изменился.

Команды

operbots-mcp setup    установка целиком: токен, настройки, плагин
operbots-mcp          запустить сервер MCP (так его вызывает клиент)
operbots-mcp login    только сохранить токен доступа к панели
operbots-mcp logout   удалить токен с этой машины
operbots-mcp status   проверить связь с панелью и показать права
operbots-mcp tools    перечислить доступные инструменты

MIT · правите код — загляните в CONTRIBUTING.md