> ⚠️ **Функция в бета-режиме** — возможны ошибки. > > 🎥 **Видео-версия инструкции:** **MCP-сервер Storm BPMN** — это интерфейс, через который ИИ-ассистенты (Claude Desktop, Claude Code, Cursor, Cline и другие) могут читать и редактировать ваши диаграммы, реестр процессов, оргструктуру и архитектуру прямо в Storm. **Простыми словами:** вы говорите Claude «нарисуй процесс согласования счёта по описанию» — и он создаёт диаграмму прямо в вашем рабочем пространстве: задачами и связями. ## Что умеет MCP-сервер Storm * Читать и создавать BPMN-диаграммы, редактировать их по описанию. * Работать с реестром процессов: создавать карточки, привязывать модели. * Работать с оргструктурой: должности, группы, владельцы процессов. * Работать с архитектурой: системы, документы, элементы, связи. * Читать кастомные поля и пользовательские справочники. > ℹ️ MCP-сервер облачного шторма (https://stormbpmn.com) работает на базовом тарифе Personal, но какие-то функции требуют тарифа **TEAM или BUSSINES**. \ > Условия использования MCP-сервера версии Enterprise определяются условиями договора. ## Как подключить Способ зависит от вашего клиента: * Claude Desktop / [**claude.ai**](http://claude.ai) — вход по логину Storm (Custom Connector). **MCP-ключ не нужен** → см. Вариант 1. * **Claude Code, Cursor, Cline и другие** — подключение по **MCP-ключу** → см. Вариант 2. --- ## Вариант 1. Claude Desktop / [claude.ai](http://claude.ai) (по логину) Storm подключается как **пользовательский коннектор (Custom Connector)** — после этого Claude работает с вашими процессами прямо в диалоге. **Что нужно заранее** * **Аккаунт StormBPMN** (логин и пароль, которыми вы заходите на [stormbpmn.com](http://stormbpmn.com)) с любым тарифом, в том числе и бесплатным. * **Аккаунт Claude** с платным тарифом (Claude Pro, Max, Team или Enterprise) **-** на бесплатном тарифе Claude пользователю недоступны коннекторы. **Шаги** 1. Откройте **Claude Desktop** (или [claude.ai](http://claude.ai)) → **Settings (Настройки)**. 2. Перейдите в раздел **Connectors (Коннекторы)** → нажмите **Add custom connector (Добавить пользовательский коннектор)**. 3. В поле **URL** вставьте адрес сервера Storm (имя можно любое, например «StormBPMN»): ``` https://stormbpmn.com/api/v1/mcp ``` 1. Нажмите **Add / Connect** — откроется страница входа Storm. Войдите своим **логином и паролем Storm BPMN**. 2. На экране согласия нажмите **Разрешить** — Claude получит доступ к инструментам Storm от вашего имени. 3. Готово. Коннектор появится в списке, инструменты Storm станут доступны в диалоге. **Если не подключается** * Убедитесь, что входите именно в аккаунт Storm BPMN (а не кнопкой Google/Яндекс, если такой учётки в Storm нет). * Часть инструментов требует соответствующего тарифа Storm — если инструмент недоступен, проверьте свой план. * Отключить коннектор можно там же: **Settings → Connectors → StormBPMN → Remove**. --- ## Вариант 2. Клиенты по MCP-ключу (Claude Code, Cursor, Cline…) **Что нужно заранее** * **Аккаунт StormBPMN** (логин и пароль, которыми вы заходите на [stormbpmn.com](http://stormbpmn.com)) с любым тарифом, в том числе и бесплатным. * **Аккаунт Claude Code, Cursor, Cline…** с платным тарифом **-** на бесплатном тарифе пользователю недоступны коннекторы. ### Шаг 1. Получить MCP-ключ 1. Войдите в Storm BPMN, откройте раздел **Профиль**. 2. Перейдите на вкладку **MCP-ключи**. 3. Нажмите **Создать ключ**. 4. Введите понятное имя (например, `Claude Code — рабочий ноут`) и выберите срок действия (рекомендуем **1 год**). 5. **Скопируйте ключ** — он показывается один раз, повторно посмотреть его будет нельзя. > **Примечание** > > * Ключ наследует ваши права в команде: что недоступно вам — недоступно и через MCP. Скоупы (ограничение ключа на часть функций) — в разработке. > > * При компрометации ключа отзовите его на той же вкладке — приложения с этим ключом перестанут работать сразу. > > * Лимит — **10 активных ключей** на пользователя. ### Шаг 2. Claude Code (CLI) Одной командой: ``` claude mcp add --transport http stormbpmn https://stormbpmn.com/api/v1/mcp \ --header "Authorization: Bearer sk_storm_ВАШ_КЛЮЧ_СЮДА" ``` Проверить подключение: ``` claude mcp list ``` ### Шаг 3. Cursor / Cline / другие клиенты Большинство MCP-клиентов используют те же параметры. Укажите: * **URL:** `https://stormbpmn.com/api/v1/mcp` * **Заголовок:** `Authorization: Bearer sk_storm_ВАШ_КЛЮЧ` --- ## Что дальше — примеры запросов В новом чате убедитесь, что коннектор **StormBPMN включён** (иконка коннекторов под полем ввода), и пишите задачи обычными словами: * «Покажи мои последние 5 диаграмм». * «Создай процесс согласования счёта от 100 тысяч с тремя уровнями». * «Добавь к процессу „Найм“ задачу проверки документов после собеседования». * «Выведи все процессы, у которых владелец — отдел продаж». * «Найди в диаграмме узлы без исполнителя». ## Какие элементы BPMN доступны MCP Перечень актуален на **15 июля 2026 года**. Функция развивается, список пополняется. MCP умеет создавать элементы перечисленных ниже типов, менять тип уже существующего элемента, переименовывать и удалять их, соединять потоками и распределять по дорожкам. В скобках — техническое название типа: его можно указать прямо в запросе, например «добавь serviceTask „Отправить уведомление“». ### Задачи * Задача без уточнения типа (`task`). * Пользовательская задача — действие человека (`userTask`). * Сервисная задача — действие системы (`serviceTask`). * Задача отправки (`sendTask`). * Задача получения (`receiveTask`). * Ручная задача — действие вне системы (`manualTask`). * Задача бизнес-правила (`businessRuleTask`). * Задача-скрипт (`scriptTask`). ### Подпроцессы * Подпроцесс (`subProcess`). * Вызов другого процесса (`callActivity`). ### События * Стартовое событие (`startEvent`). * Завершающее событие (`endEvent`). * Промежуточное принимающее событие (`intermediateCatchEvent`). * Промежуточное генерирующее событие (`intermediateThrowEvent`). ### Типы событий Любому событию можно задать тип — он добавляет иконку и смысл: таймер (`timer`), сообщение (`message`), сигнал (`signal`), условие (`conditional`), ошибка (`error`), эскалация (`escalation`), связь (`link`), компенсация (`compensation`), завершение процесса (`terminate`). Не каждый тип подходит к каждому событию. Допустимые сочетания: * Стартовое событие — таймер, сообщение, сигнал, условие. * Промежуточное принимающее — таймер, сообщение, сигнал, условие, связь. * Промежуточное генерирующее — сообщение, сигнал, эскалация, связь, компенсация. * Завершающее событие — сообщение, сигнал, ошибка, эскалация, компенсация, завершение процесса. Например: ожидание по таймеру — это промежуточное принимающее событие с типом «таймер», а жёсткий останов процесса — завершающее событие с типом «завершение процесса». Если сочетание недопустимо, MCP вернёт ошибку с подсказкой, и ассистент исправит запрос сам. ### Шлюзы * Исключающий, XOR (`exclusiveGateway`). * Параллельный, AND (`parallelGateway`). * Включающий, OR (`inclusiveGateway`). * Шлюз по событию (`eventBasedGateway`). * Комплексный шлюз (`complexGateway`). ### Дорожки MCP умеет добавлять, переименовывать и удалять дорожки, а также распределять по ним элементы. ### Чего пока нет По состоянию на 15 июля 2026 года через MCP нельзя создать: * Граничные события на задачах. * Пулы и несколько участников на одной диаграмме. * Объекты и хранилища данных. * Текстовые аннотации и группы. Такие элементы добавляются вручную в редакторе Storm. Ещё одно ограничение — содержимое подпроцесса. Сам подпроцесс MCP создаёт: ставит на диаграмму, называет, соединяет потоками. А вот нарисовать шаги внутри него не получится — их нужно добавить в редакторе. ## Безопасность * **MCP-ключ — это пароль.** Не храните его в публичных репозиториях и не отправляйте в чатах. * Если ключ утёк — сразу отзовите его в **Профиль → MCP-ключи**. * Ключ работает только из вашей учётной записи и наследует ваши права в команде. ## Частые вопросы **В: Есть ли у облачного Storm API, чтобы дать ИИ-агенту доступ к моим схемам?**\ О: Публичного REST API в облаке stormbpmn.com нет. Для подключения ИИ-ассистентов (Claude, Cursor и другие) к вашим процессам предназначен именно MCP-сервер — он описан выше в этой статье. Полноценный REST API доступен в версии Enterprise, устанавливаемой на сервер компании.