Если вы используете Private Cloud Edition (PCE) от MuleSoft в изолированной (air-gapped) или строго контролируемой среде, вы, вероятно, наблюдали за бумом ИИ-кодинга со стороны. Обычные инструменты предполагают, что ваш код, спецификации API и ваша платформа доступны из публичного облака. В вашем мире это не так. Ваши активы Exchange и политики API находятся в PCE, за границей вашей собственной сети. Ваш код Mule находится на вашем ноутбуке. Между ними — множество вкладок браузера, ручное копирование и вставка, а у ИИ-агента нет нормального способа преодолеть этот разрыв.

PCE 4.3.0, ставшая общедоступной 6 октября 2026 года, меняет это положение дел. Anypoint Code Builder (ACB), интегрированная среда разработки MuleSoft на базе VS Code, работающая на базе MuleSoft Vibes, теперь может подключаться напрямую к вашей собственной плоскости управления PCE. Ваш код, спецификации и Anypoint CLI работают в одном и том же рабочем пространстве против вашего собственного экземпляра. Именно это соединение делает ИИ полезным в данном случае. Навыки MuleSoft Vibes дают вашему агенту по кодированию знания MuleSoft, которых ему в противном случае не хватило бы. Каждый навык объединяет инструкции и сценарии для одной задачи, такой как создание потоков, запуск, защита или обновление приложения. Агент выбирает правильный навык для вашего запроса, работает через Anypoint CLI против PCE и возвращает сборку для проверки.

Это руководство предназначено для разработчиков MuleSoft на PCE. К концу работы вы получите:

ACB, вошедший в ваш экземпляр PCE
Anypoint CLI, направленный на PCE, с установленными плагинами PCE
Навыки MuleSoft Vibes, установленные для вашего агента кодирования
Поэтапный рабочий процесс с агентом, контролируемый сборками

Однократная настройка занимает около 10–15 минут. Время сборки зависит от масштаба приложения.

Что Anypoint Code Builder приносит в PCE

ACB — это среда разработки MuleSoft, созданная на базе VS Code. Подключившись к PCE, вы можете выполнять большую часть работы, не открывая браузер:

Проектируйте и проверяйте спецификации API локально, а затем имитируйте их с помощью API Console до появления бэкенда.
Реализуйте API на основе его спецификации через палитру команд и создавайте интеграции на холсте проектирования.
Пишите тесты DataWeave и MUnit и привлекайте компоненты из Exchange.
Пакуйте приложение для Runtime Manager с поддержкой Parent POM для ваших стандартов Maven.

Все это находится в одном окне. Расширение MuleSoft находится на панели активности. Ваши потоки отображаются в виде кода или на холсте. Строка состояния показывает, выполнен ли вход в систему, а также покрытие тестами MUnit. Панель вывода показывает ответы при запуске и тестировании. Палитра команд — это способ взаимодействия с PCE.

Вот где это окупится, когда агент пишет код. ACB отображает XML-код Mule в виде потоков и компонентов, так что вы проверяете то, что можете понять, а не сотни сгенерированных строк. Вы можете проверить бизнес-логику, увидеть, где находится обработка ошибок, и заметить недостающий шаг.

Рисунок 1. Поток, созданный агентом, показанный на холсте ACB

MuleSoft Vibes предоставляет навыки, которые использует агент. Они следуют лучшим практикам MuleSoft и работают с такими агентами кодирования, как Claude Code, Cursor, Cline и Codex. Поскольку навыки представляют собой файлы на вашем компьютере, вы можете добавлять свои собственные правила, такие как соглашения об именовании, стандартные заголовки или обязательное логирование. Вы также можете хранить частные навыки в собственных репозиториях, чтобы агент начинал работу с учетом ваших стандартов.

Настройка ACB, Anypoint CLI и навыков Vibes

Что вам нужно

PCE 4.3.0 и учетная запись, под которой можно войти
VS Code на вашем компьютере
Node.js 22.0.0 или новее и npm 7 или новее
Maven и JDK в переменной `PATH` вашего терминала, так как агент запускает `mvn clean package` на каждом этапе сборки. Запустите `mvn -v` для проверки.
Подключенное приложение в PCE для Anypoint CLI и навыков
Сетевой доступ к VS Code Marketplace и npm или автономные установочные пакеты для ACB, Anypoint CLI и MuleSoft Vibes, доступные у вашего менеджера по работе с клиентами (CSM)
Агент кодирования, одобренный вашей организацией. Направьте агента кодирования на внутреннюю конечную точку модели вашей организации, чтобы промпты и код оставались внутри вашей сети.

Установка Anypoint Code Builder

Вы можете установить Anypoint Code Builder (ACB) из VS Code Marketplace или из пакета частного распространения.

Установка из Marketplace

В VS Code откройте представление расширений (Extensions), найдите в Marketplace Anypoint Extension Pack и установите его. По завершении установки значок MuleSoft появится на панели активности слева.

Установка частного дистрибутива

Пакет частного распространения находится на странице Customer Portal на портале клиентов Salesforce Help. Он включает в себя скрипт установки, который устанавливает каждое расширение ACB за один шаг.

1. Распакуйте архив и запустите установщик.

macOS: Распакуйте архив private-dist. Откройте терминал в получившейся папке и запустите:
Windows: Распакуйте архив private-dist в корень диска C:\ (например, C:\win32-x64-dist). Если вы распакуете его в глубоко вложенную папку, установка завершится ошибкой, так как пути к файлам превышают ограничение длины пути в Windows. В извлеченной папке щелкните правой кнопкой мыши по файлу install-bundle-windows.ps1 и выберите Запустить с помощью PowerShell (Run with PowerShell).
Примечание. Если вы видите ошибку вроде install-bundle-windows.ps1 не может быть загружен. Файл … не подписан цифровой подписью, откройте PowerShell в извлеченной папке, выполните следующую команду, а затем снова запуск скрипта из того же окна:

2. Когда установщик спросит Хотите ли вы очистить текущие установленные расширения ACB? (Y/n), введите Y. Это удалит все уже установленные расширения ACB, чтобы вы начали с чистого листа.

3. По завершении установки перезагрузите окно VS Code (Developer: Reload Window в палитре команд). Значок MuleSoft появится на панели активности слева.

Подключение ACB к плоскости управления PCE

По умолчанию ACB взаимодействует с плоскостью управления, размещенной на хосте MuleSoft. Чтобы переключить его на ваш экземпляр, откройте Настройки → Расширения → Anypoint Code Builder (Платформа) (Settings → Extensions → Anypoint Code Builder (Platform)) и задайте два значения:

Mule: Control Plane = `Private Cloud Edition`
Mule: Control Plane PCE Url = ваш URL PCE, например `https://<ваш-хост-pce>/`

Рисунок 2. Обе настройки находятся в разделе Anypoint Code Builder (Platform). URL-адрес — это ваш хост PCE, а не anypoint.mulesoft.com.

Вы можете изменить плоскость управления только в настольной среде IDE, а не в Anypoint Code Builder на базе браузера. Затем откройте палитру команд и выполните MuleSoft: Войти в Anypoint Platform (MuleSoft: Login to Anypoint Platform). ACB откроет страницу входа в PCE в браузере, и после входа в систему в строке состояния появится сообщение о том, что вы вошли в систему.

Руководство Настройка ACB для PCE охватывает все настройки.

Установка Anypoint CLI и его привязка к PCE

ACB охватывает редактор. Anypoint CLI охватывает все остальное, что вы предпочли бы автоматизировать с помощью скриптов. В PCE его плагины позволяют управлять бизнес-группами, ролями и настройками федеративной аутентификации; работать с проектами Design Center; публиковать, искать и обнаруживать ресурсы Exchange и зависимости Maven; а также регистрировать API, обеспечивать соблюдение контрактов и соглашений об уровне обслуживания (SLA), а также применять политики в API Manager.

Поскольку он работает в терминале VS Code, он находится прямо рядом с вашим кодом. Он также работает везде, где работает оболочка. Вы можете управлять упаковкой и развертыванием с помощью инструментов непрерывной интеграции и доставки (CI/CD), применять одни и те же правила и конфигурацию к каждой среде с помощью скрипта и запускать структурированные пакетные скрипты с автодополнением оболочки для Zsh, Bash и PowerShell. Все это работает с вашим экземпляром PCE внутри вашей собственной сети.

Установите CLI глобально и убедитесь, что он работает:

Вторая команда выводит версию CLI. Если вы получили сообщение «command not found», добавьте глобальный каталог бинарных файлов npm в ваш `PATH`.

Затем добавьте четыре плагина, которые поддерживает PCE:

Если вы устанавливаете из офлайн-пакета, распакуйте установщик Anypoint CLI и запустите скрипт установки из этой папки. Он устанавливает CLI и плагины за один шаг:

Запустите `anypoint-cli-v4 plugins`, и вы должны увидеть все четыре в списке.

Затем настройте CLI так, чтобы он доверял TLS-сертификату вашего экземпляра PCE. Anypoint CLI работает на Node.js, который отклоняет незнакомые сертификаты, поэтому без этого шага каждый вызов CLI будет завершаться ошибкой.

В macOS или Linux сохраните сертификат и укажите на него Node.js:

Добавьте строку `export` в профиль своей оболочки, например в `~/.zshrc`, чтобы новые терминалы и ваш агент программирования подхватили ее.

В Windows откройте URL-адрес вашего PCE в Chrome или Edge, просмотрите сертификат сайта и экспортируйте его в формате Base64-encoded PEM. Затем укажите на него Node.js и перезапустите VS Code, чтобы изменения вступили в силу:

Если ваш PCE использует сертификат внутреннего центра сертификации (CA), вместо этого укажите `NODE_EXTRA_CA_CERTS` на файл корневого CA вашей организации.

Затем укажите CLI хост, организацию и среду вашего PCE, а также передайте учетные данные вашего подключенного приложения (connected app). Эти команды одинаковы в любой операционной системе:

Используйте только имя хоста без `https://`. CLI сохраняет значения `conf` в своей локальной конфигурации, и ваш агент действует в рамках возможностей приложения. Предоставляйте подключенному приложению только те области видимости (scopes), которые необходимы навыкам.

Чтобы подтвердить подключение, выведите список ваших бизнес-групп:

Если ваши бизнес-группы PCE возвращаются, значит, CLI взаимодействует с вашим экземпляром. В документации по аутентификации Anypoint CLI перечислены другие ключи `conf`.

Установка навыков MuleSoft Vibes

MuleSoft Vibes — это дополнительное расширение для PCE. Оно поставляется с 21 навыком по умолчанию, которые работают с такими агентами программирования, как Claude Code, Cursor, Cline и Codex.

Навыки обращаются к платформе через Anypoint CLI, который вы только что настроили. Настройка сводится к двум дополнительным действиям: добавьте плагин DX Mule в CLI, а затем добавьте навыки MuleSoft в ваш проект:

Если вы устанавливаете из офлайн-пакета, установите плагин DX Mule из его локального файла, а затем добавьте навыки из распакованной папки навыков:

Установщик задает три вопроса:

1. Агенты: оставьте универсальный каталог `.agents/skills` и добавьте любые другие утвержденные агенты, которые вы используете, например Claude Code `.claude/skills`.

2. Область видимости (Scope): выберите Project (Проект) или Global (Глобально).

3. Метод: выберите Symlink (Символическая ссылка), это рекомендуемый вариант.

В руководстве по установке навыков приведены полные инструкции.

Проверка установки

Проверяйте каждый элемент перед созданием чего-либо:

1. Строка состояния ACB показывает, что вы вошли в свой экземпляр PCE.

2. Команда `anypoint-cli-v4 account:business-group:list` возвращает ваши бизнес-группы PCE.

3. Выбранные вами навыки появляются в каталоге `.agents/skills` или `.claude/skills` в вашем проекте.

Если все три проверки пройдены, ваша среда разработки, ваш терминал и ваш агент работают с одним и тем же экземпляром PCE.

Создание и проверка с помощью агента

Применение навыков к реальным приложениям Mule

После завершения настройки дайте агенту реальную работу. Каждый навык ниже выполняет задачу, которую в противном случае вы делали бы вручную. Укажите навык в своем запросе, и агент выполнит его инструкции и вызовет Anypoint CLI, когда ему понадобится платформа.

generate-doc-description для приложений, которые никто не документировал. Возможно, вам досталось приложение Mule без документации. Укажите агенту на проект с этим навыком, и он прочитает потоки и напишет для них описания. Следующий человек, который откроет проект, получит объяснение, а не археологические раскопки.

build-mule-integration для новых потоков и недостающих тестов. Этот навык создает потоки и целые приложения на основе спецификации, используя для этого Anypoint CLI и плагин DX Mule. Он так же полезен для существующего кода. Попросите его написать тесты MUnit для уже созданных потоков, и вы получите покрытие для тех частей приложения, к которым никто не хочет прикасаться.

secure-mule-app перед отправкой в релиз. Этот навык сканирует вашу конфигурацию на наличие рисков безопасности, шифрует безопасные свойства и предлагает улучшения логирования.

До версии 4.3 рабочий процесс разработчика PCE был разделен на две части: написание кода локально, а затем переключение на веб-интерфейс PCE для поиска актива, проверки спецификации или применения политики. Теперь вы проходите путь от спецификации до потока, тестов и упакованного приложения в едином рабочем пространстве, работая с собственным экземпляром PCE, и проверяете каждый шаг на холсте ACB перед тем, как двигаться дальше. Локальная среда и платформа перестают быть двумя разными местами, между которыми приходится переключаться.

Создание по этапам с помощью build-mule-integration

Если попросить агента создать весь API в одном запросе, результат будет сложно проверить. Поэтапный план позволяет проверять сборку после каждого шага. Начните с предоставления агенту полного контекста: исходных и целевых систем, схем и бизнес-правил.

Затем разбейте сборку на небольшие этапы, такие как настройка проекта, один или два эндпоинта за этап и тесты. Каждый этап должен успешно проходить команду `mvn clean package` (со статусом BUILD SUCCESS) до начала следующего.

Ваши запросы будут состоять из четырех этапов:

1. Сгенерируйте поэтапный план на основе спецификации API, документации по данным и документа с требованиями к продукту (PRD).

2. Реализуйте этапы по очереди, останавливаясь на барьере сборки (build gate).

3. Напишите тесты MUnit для готовых потоков.

4. Задокументируйте приложение.

Вот пример запроса для второго этапа:

Запрос называет навык, ограничивает область видимости одним этапом и делает сборку барьером. Каждый этап дает вам небольшое успешное изменение для проверки в холсте ACB, прежде чем двигаться дальше. Если сборка завершается ошибкой или вы замечаете пробел в потоке, отправьте ошибку или свои заметки обратно агенту либо откатите этап и сузьте его область видимости.

PCE 4.3.0 также включает изменения платформы и обновлений для администраторов. Информацию о них, а также полный список ограничений см. в PCE 4.3.0 release notes и документации PCE.