Bot-as-Code — версионирование воронок в Git

Экспорт воронки можно хранить в Git как JSON, проверять через Pull Request и импортировать как черновик. Публикацию выполняйте отдельным шагом после проверки diff и preflight.

Порядок настройки

1. В настройках проекта создайте API-ключ с минимально необходимыми scope 2. Используйте документированные export/import endpoints или MCP-инструменты проекта 3. Сохраните полученный JSON без секретов в отдельной ветке Git 4. Перед импортом проверьте diff и создайте черновик 5. Публикуйте только проверенный черновик отдельной командой

Публичный npm-пакет CLI пока не заявляется: не используйте команду установки из сторонних источников. Доступный способ подключения AI-агента и точный endpoint показывает раздел MCP в настройках проекта.

Рабочий процесс

• Создать feature branch
• Редактировать JSON вручную или через AI-агента
• Проверить схему и diff без публикации
• Провести review изменений
• Импортировать как черновик и пройти тестовый сценарий
• Опубликовать только после ручного подтверждения

MCP server для AI

Совместимый MCP-клиент может читать и изменять доступные ресурсы проекта в пределах scope API-ключа. Используйте endpoint и пример конфигурации из настроек проекта, поскольку схема аутентификации может меняться.

Best practices

• API ключи через env (НЕ в Git)
• main защищён через PR review
• Tag версии для важных релизов
• Откат через revert JSON, повторный импорт в черновик и ручную проверку