Справочник 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

Включает флаги Открытой версии, плюс следующие. Наличие флага --install не означает автоматическую установку текущего MCP_HTTPService: в поставке v2.43.1 эта команда отказывает до изменения базы; используйте --export-extension и обновление на месте. Исключений три: в Расширенной версии нет флагов --build-index, --quiet и --verbose. Остальные флаги из таблицы Открытой версии в ней есть.

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

Значение --request-timeout в Расширенной и Профессиональной версиях пишется двумя способами: длительностью с единицей измерения (5m, 300s) или целым числом секунд (300). Так же читается --polling-extension-timeout. В Открытой версии принимается только число секунд.

С версии 2.36.0 значение по умолчанию у --request-timeout равно 5 минутам вместо прежних 30 секунд и совпадает со значением Открытой версии. Прежнее значение задаётся явно: --request-timeout 30s.

Значение, которое разобрать не удалось, обрабатывается по-разному в зависимости от того, где оно написано. У флага разбор командной строки прекращается и процесс не запускается. У переменной окружения MCP_1C_REQUEST_TIMEOUT молча берётся значение по умолчанию. Значение, которое разобралось в ноль или меньше, молча заменяется значением по умолчанию и во флаге, и в переменной окружения.

Имена баз в 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

# Расширенная: мультибазовость с 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

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

# Расширенная: управление лицензией
mcp-1c-advanced --activate "MCP-XXXX-XXXX-XXXX-XXXX"
mcp-1c-advanced --license-status
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

Флаги review ставятся перед файлами: разбор флагов останавливается на первом имени файла. Код выхода: 0, если различий нет, и 1, если в отчёте есть добавленный, удалённый или изменённый объект. С версии 2.41.0 изменённым объект бывает и тогда, когда его содержимое на вид то же: те же байты иначе разложены по потокам, на одной стороне есть лишний пустой поток или несколько записей контейнера дают объекту один поток с разными байтами. Файлы, равные байт в байт, дают 0. Код 1 бывает и при ошибке во флаге, стоящем перед файлами, например при неизвестном флаге или не числе в --max-bytes. Прочие ошибки дают 2: например, передано не два файла, в том числе когда флаг стоит после файлов, или у --format неподдерживаемое значение. Запуск с --bug-report отчёт не строит, поэтому значение --format в нём не проверяется. Успешный запуск с --bug-report и вызов --help завершаются с кодом 0. Строка с echo в примере написана для bash.

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

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

# Без подписи оплаченной лицензии (подпись Trial флаг не убирает)
mcp-1c-pro review --no-watermark -o diff.md base.cfe head.cfe

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