BestrankMCP: Бизнес-процессы на коробке: история и активити через MCP

Бизнес-процессы на коробке: история и активити через MCP

Штатный REST Bitrix24 видит только активные БП. На коробке с модулем расширения агент читает историю workflow и каталог активити через MCP.

РОП спрашивает: «почему согласование по сделке 1840 зависло вчера вечером?» Агент открывает активные процессы - пусто. Процесс уже завершён или убит. В штатном REST Bitrix24 живых экземпляров нет, истории тоже нет. Остаётся гадать по ленте или лезть в админку.

На коробке это закрывается модулем расширения БП и отдельными инструментами в Bestrank MCP.

Что умеет штатный MCP по БП

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

Не хватает для «что было после пятницы» и «какие активити вообще есть на портале». Облако без модуля здесь ни при чём - у штатного API просто нет истории завершённых процессов.

Разбор вкладки возможностей и данных портала - Данные портала: словари, БЗ и бизнес-процессы.

Модуль расширения на Маркетплейсе

Нужна коробка Bitrix24 и модуль Расширение модуля Бизнес-процессы (bestrank.bizprocextention). На портале он даёт аналитику и поиск по шаблонам; для MCP важны REST-методы модуля: карточка workflow с историей шагов, каталог активити, AI-схема настроек активити, отдельный список заданий.

Те же методы robot.list / robot.template.get модуль отдаёт для роботов на стадиях - но в MCP они не оформлены отдельными инструментами. Карта стадий и карточка шаблона БП сами вызывают их, если на токене в probe есть scope модуля. Без scope карта остаётся на штатном разборе шаблонов (удобно для облака).

В входящем вебхуке (или приложении) должен быть scope модуля. Актуальный код - br_bizproc_ext. Старый br_bizprocext больше не подходит - вебхук нужно перевыпустить.

В MCP явные tools расширения (история, активити, задания модуля) лежат рядом с обычными инструментами БП и включаются только при scope модуля. Без модуля в каталоге они будут «серыми» - так и задумано.

Что спрашивать агента

Типичные формулировки после настройки:

  • «Покажи историю процесса с таким-то id - что делал на каждом шаге.»
  • «Какие активити есть на портале, есть ли пауза / смена поля.»
  • «Для активити delayactivity какие настройки видит AI.»
  • «Список заданий модуля по этой компании» - это другой список, не путать со штатными заданиями БП в MCP.
  • «Покажи роботов на стадиях сделок» - карта стадий; на коробке с модулем она точнее, отдельный «robot-tool» не нужен.

Операторский справочник: документация Бизнес-процессы (группа БП, секция про расширение на коробке).

Как настроить админу

  1. Установить модуль с Маркетплейса на коробку.
  2. Входящий вебхук (или OAuth) со scopes на бизнес-процессы и на модуль расширения.
  3. В админке MCP - подключение Bitrix24, проверка (probe), токен с галочками на обычные БП и на инструменты расширения.
  4. Пользователю - только ключ токена и URL MCP, без прав администратора портала в чат.

Если probe без scope модуля - расширение в «Возможностях» недоступно. Сначала вебхук, потом галочки.

Чего не обещаем

Мутаций через REST модуля в MCP нет - запуск и завершение заданий по-прежнему через штатные инструменты Bitrix24. Облачный портал без модуля историю через эти tools не получит. Старый scope на вебхуке сам не «переедет» - нужен новый.

Подключение с нуля - Подключение MCP. Список возможностей - каталог с фильтром по бизнес-процессам.