Справочник CLI

Поведение командной строки (v2.18.0)

• Справка --help платных бинарников (mcp-1c-advanced, mcp-1c-pro) при выводе в терминал открывается постранично (через $PAGER, по умолчанию less -R); в пайпах и CI выводится обычным сплошным текстом, детерминированно для скриптов.
• При опечатке в команде или неизвестном флаге печатается короткая подсказка вместо полного списка флагов: «Введена неправильная команда. Запустите mcp-1c-advanced --help для получения списка команд». Вместо mcp-1c-advanced подставляется имя запущенного файла, поэтому в Профессиональной редакции подсказка назовёт mcp-1c-pro, а если файл переименовали, то его новое имя.

Флаги Открытой версии mcp-1c

Совет: Флаги-переключатели со значением выключено включаются добавлением самого флага (например, --enable-semantic), без значения. Указывать true или false не нужно: например, --enable-semantic true вызовет ошибку.

Флаги Расширенной версии mcp-1c-advanced

Включает флаги Открытой версии, плюс следующие. Исключений три: в Расширенной версии 2.33.0 нет флагов --build-index, --quiet и --verbose. Остальные флаги из таблицы Открытой версии в ней есть, но у --request-timeout в Расширенной и Профессиональной версиях 2.33.0 другой формат значения и другое значение по умолчанию: не число секунд, а длительность с единицей измерения, по умолчанию 30s. Голое число там не принимается, и запуск с ним завершается ошибкой разбора: пишите --request-timeout 300s.

Любой из этих трёх флагов Расширенная версия не игнорирует, а отвергает: разбор командной строки прекращается, на stderr печатается короткая подсказка из врезки выше, и процесс завершается с кодом 1. То есть команда с таким флагом не запустится вовсе.

Имена баз в v2.30.0

Имя базы в --dump ИМЯ=ПУТЬ, --auth ИМЯ=ЛОГИН:ПАРОЛЬ и --reindex ИМЯ должно совпадать с именем, заданным в --base. Раньше несовпадающее имя молча игнорировалось, и это тихо меняло поведение: выгрузка не подключалась, индекс не перестраивался, а учётные данные терялись, из-за чего база опрашивалась вообще без них. Теперь сервер не запускается, печатает в stderr Configuration error: dump называет базу "имя", которая не настроена. Добавьте --base имя=<адрес> или уберите лишнее имя и завершается с кодом 1. В сообщении подставляется имя флага без ведущих дефисов, а за один запуск называется одно лишнее имя.

Отдельно проверьте сочетание явного --base ИМЯ=АДРЕС с короткой формой --dump ПУТЬ без имени: короткая форма относится к базе default, которой при явно заданном --base не существует, поэтому такой запуск тоже остановится. Прежде он просто оставался без выгрузки. Флаг --skip с именем, которого нет среди настроенных баз, по-прежнему только предупреждает и работу не прерывает. Но если --skip исключит все настроенные базы, загружать станет нечего, и сервер напечатает в stderr Все настроенные базы исключены флагом --skip, загружать нечего. Уберите часть --skip или укажите базу для работы., а затем завершится с кодом 1.

Флаги Профессиональной версии mcp-1c-pro

Включает все флаги Расширенной версии, плюс следующие:

Каталоги обмена (v2.30.0)

Оба флага принимают ровно один каталог, списка через разделитель они не поддерживают. Относительное значение приводится к абсолютному от текущего рабочего каталога, а если флаг не задан, подхватывается одноимённая переменная окружения. Существование каталога при запуске не проверяется: для --exchange-drop-root инструмент всё равно регистрируется и сообщает об отсутствии каталога уже в ответе на вызов.

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

Примеры команд

# Минимальный запуск (все по умолчанию)
mcp-1c

# С аутентификацией и выгрузкой
mcp-1c --base http://server:8080/erp/hs/mcp-1c \
  --user Admin --password secret \
  --dump /dumps/erp

# Установка в клиент-серверную базу с нестандартной платформой
mcp-1c --install "srv-1c\buh_prod" --server \
  --platform "C:\Program Files\1cv8\8.3.25.1000\bin\1cv8.exe" \
  --db-user Admin --db-password pass

# Advanced: мультибазовость с polling
mcp-1c-advanced \
  --base dev=http://localhost:8080/hs/mcp-1c \
  --base staging=poll:// \
  --auth dev=Admin:dev123 \
  --dump dev=/dumps/dev \
  --listen :9090 \
  --poll-user agent --poll-password secret123456 \
  --default-base dev

# Advanced: обновить данные синтакс-помощника
mcp-1c-advanced --update-syntax

# Advanced: управление лицензией
mcp-1c-advanced --activate "MCP-XXXX-XXXX-XXXX-XXXX"    # или mcp-1c-pro
mcp-1c-advanced --license-status                     # или mcp-1c-pro
mcp-1c-advanced --deactivate                         # или mcp-1c-pro

Профессиональная: построение кэша

# Построить граф зависимостей
mcp-1c-pro --dump /path/to/dump --build-depgraph

# Построить полный анализ (антипаттерны + безопасность + метрики)
mcp-1c-pro --dump /path/to/dump --build-bulkanalysis

# Анализ только доработанных модулей (без типовых)
mcp-1c-pro --dump /path/to/dump --build-bulkanalysis --vendor-baseline /path/to/vendor

# CI/CD: quality gates
mcp-1c-pro --dump /path/to/dump --build-bulkanalysis --ci --fail-on-errors 10 --fail-on-debt-score 70

# HTML отчет
mcp-1c-pro --dump /path/to/dump --build-bulkanalysis --report report.html --format html

# Сравнение конфигураций (3-way diff)
mcp-1c-pro --update-helper --dump /path/to/custom --vendor-old /path/to/old-vendor --vendor-new /path/to/new-vendor

# Запуск MCP сервера с семантическим поиском и графом
mcp-1c-pro --dump /path/to/dump --enable-semantic --enable-depgraph

Профессиональная: визуализация, документация, тесты

# Архитектурные диаграммы (subsystems / doc-reg / bp / all)
mcp-1c-pro --dump /path/to/dump --build-archviz --arch-viz all --output-dir ./diagrams

# Markdown-документация по объектам через YandexGPT
mcp-1c-pro --dump /path/to/dump --build-autodoc \
  --autodoc-out ./docs/auto --autodoc-provider yandexgpt

# Генерация unit-тестов (YAxUnit + Vanessa)
mcp-1c-pro --dump /path/to/dump --build-testgen \
  --testgen-framework auto --testgen-output ./tests \
  --testgen-taint-regressions

# Designer-compatible .epf бандлы с упаковкой
mcp-1c-pro --build-epfgen --epfgen-spec ./bundles.yaml --epfgen-pack

# Индексация типовой конфигурации (БП, ЗУП, УТ, Розница, КА, ERP)
mcp-1c-pro --build-typicalconfigs \
  --typicalconfigs-dump-path ./dump \
  --typicalconfigs-output ./typicalconfigs-output \
  --typicalconfigs-llm-disable

# MCP-сервер с включёнными новыми инструментами
mcp-1c-pro --dump /path/to/dump \
  --enable-testgen --enable-epfgen --enable-typicalconfigs

Профессиональная: CFEDiff

# Сравнить две версии расширения, вывод в файл
mcp-1c-pro review base.cfe head.cfe --format markdown -o diff.md
echo "exit code: $?"  # 0 = no diff, 1 = diff found, 2 = error

# JSON-вывод для парсинга в CI
mcp-1c-pro review base.cfe head.cfe --format json -o diff.json

# Без watermark Trial (для verified-paid лицензий)
mcp-1c-pro review base.cfe head.cfe --no-watermark -o diff.md

# Диагностический пакет для тикета поддержки
mcp-1c-pro review base.cfe head.cfe --diagnostic -o diff.md