Бизнес-процессы на коробке: история и активити через MCP
Штатный REST Bitrix24 видит только активные БП. На коробке с модулем расширения агент читает историю workflow и каталог активити через MCP.
Иногда приходится расследовать детективные истории по выполнению тех или иных заданий бизнес-процессов в Битрикс24. Например: «почему согласование по сделке 1840 зависло вчера вечером?». Мы сейчас можем попробовать решить данный вопрос через AI-агента. Агент открывает активные процессы - пусто. Процесс уже завершён по сценарию или был "прибит" пользователем. В штатном REST Bitrix24 живых экземпляров нет, истории тоже нет. Остаётся гадать по ленте или истории в журнале бизнес-процесса, если она велась.
На коробке мы можем закрыть данный вопрос с помощью модуля "расширения для бизнес-процессов" и отдельными инструментами в BestrankMCP. К сожалению, с облачной версией портала мы тут помочь на данный момент не сможем, так как там нельзя расширять возможности Rest Api.
Что умеет штатный MCP по бизнес-процессам
Без модуля агент уже может:
- найти шаблон
- посмотреть активные экземпляры на карточке
- открыть задание
- запустить или остановить процесс (если были выданы права на токене)
Этого хватает для «что сейчас висит» и «запусти согласование».
Но нельзя получить информацию о «что было после пятницы» и «какие активити вообще есть на портале».
Разбор вкладки возможностей и данных портала - Данные портала: словари, БЗ и бизнес-процессы.
Модуль расширения на Маркетплейсе
Нужна коробка Bitrix24 и модуль Расширение модуля Бизнес-процессы (bestrank.bizprocextention). Для нашего MCP-конструктора важны REST-методы модуля: карточка workflow с историей шагов, каталог активити, AI-схема настроек активити, отдельный список заданий.
В входящем вебхуке (или приложении) должен быть scope модуля br_bizproc_ext.
В BestrankMCP эти возможности лежат рядом с обычными инструментами бизнес-процессов, но включаются только если на токене есть и право на бизнес-процессы, и scope нашего модуля.
Что спрашивать агента
Типичные формулировки после настройки:
- «Покажи историю процесса с таким-то id - что делал на каждом шаге.»
- «Какие активити есть на портале, есть ли пауза / смена поля.»
- «Для активити "Уведомление пользователя" какие настройки видит AI.»
- «Список заданий модуля по этой компании».
Операторский справочник: документация Бизнес-процессы (группа БП, секция про расширение на коробке).
Как настроить модуль в Битрикс24
- Установить модуль с Маркетплейса на коробку.
- Входящий вебхук (или OAuth) со scopes на бизнес-процессы и на модуль расширения.
- В личном кабинете BestrankMCP - подключение Bitrix24, проверка подключение, токен с галочками на обычные бизнес-процессе и на инструменты расширения.
- В AI-агенте настроить MCP.
Подключение с нуля - Подключение MCP. Список возможностей - каталог с фильтром по бизнес-процессам.