Kobernik MCP
Что менялось в Kobernik MCP от версии к версии. Если обновляетесь через несколько версий, прочтите записи всех промежуточных: пункты, после которых нужно что-то сделать у себя, начинаются со слов «Требует действия».
Поиск объектов и чтение данных дают более точные подсказки и продолжения ответа.
find_documents, запрашивайте view="full" для прежней подробной формы. Для полного обхода выполняйте команды продолжения из ответа, сохраняя переданный ими курсор целиком.doctor сообщает «не прокси коробки», выполните предложенную им команду перевода. Свой прокси оставляйте по согласованию с поддержкой, когда вход уже обслуживает ваш веб-сервер.Конфигурацию можно читать и на старых платформах 8.3, а то, что на платформе базы недоступно, называется сразу.
dump_full_config и dump_config_object там, где нет ibcmd сборки платформы базы: выгрузку делает штатный Конфигуратор той же сборки.MCP_1C_DB_REGISTRY; kobernik-mcp doctor называет базы, где это нужно проверить.ibcmd сборки платформы базы отказывает до начала работы, база не меняется; kobernik-mcp doctor перечисляет инструменты, недоступные на этой платформе.operation_status после закрытия операции, совпадает с обычным ответом: продолжение описания объекта не повторяет уже прочитанное, а выбранный вид ответа и схема запроса сохраняются.Карточки и результаты запросов стали короче, а неполное чтение точнее подсказывает, как получить остальное.
run_query, query_register и read_batch стали текстовыми таблицами. Обвязки, которым нужен типизированный JSON и точные адреса ссылок, переведите на view=full; это касается и получения этих результатов через operation_status.dump_object стала текстовой, скрывает незаполненные реквизиты и колонки табличных частей без значимых значений, а одинаковые значения показывает один раз. Для машинного разбора, полного состава прочитанных полей и точных адресов ссылок задавайте view=full.describe_object и get_document_movements изменилась. Обвязки, рассчитанные на прежнюю подробную форму, переведите на view=full; для движений добавьте также include_schema=true.ИИ-помощник точнее передаёт данные между инструментами и получает готовый путь подготовки расширения.
dump_object, нужно обновить под структурированные ответы и типизированные значения. ИИ-помощник получает типы и точные ссылки вместе с данными.Когда связь с 1С обрывается, операция упирается в предел времени или ответ неполон, ИИ-помощник видит, что известно наверняка, и получает готовую команду проверки или продолжения.
doctor
и bridge_health показывают такие сеансы и итог уборки. Проверка идёт и во время простоя, без новых запросов ИИ.bridge_health показывает версию программы и состояние реестра баз.update_tc_rows не повторяет запись проведённого документа после отказа 1С. Распознанный запрет
изменения данных за период останавливает правку строк и у непроведённого документа.create_object и clone_object в режиме загрузки проверяют запрет изменения данных до записи.
Если проверить запрет нельзя, состоявшаяся запись сопровождается предупреждением об этом.run_query и query_register, обрезанная лимитом,
приходит с готовой командой добора, а triage_recent_errors и read_event_log ведут дальше готовыми командами.execute_code, закрытый по пределу времени, пока скрипт ещё идёт, отвечает номером операции,
а operation_status после его конца отдаёт итог скрипта отдельным полем.dump_full_config и dump_extension принимают относительный out_path от каталога выгрузок и отказывают
до начала работы, если выгрузка стёрла бы исходники внешних обработок или каталог базы.clone_object не выдаёт непрочитанные табличные части за пустые и называет проверки, которые не выполнил.load_extension,
apply_extension_dynamic, apply_config_object, migration_toolkit, отказ при ошибке в реестре баз.После каждой записи ИИ-помощник видит, что стало с базой, и получает готовую команду проверки или отката; при сбое связи запись не повторяется вслепую.
triage_recent_errors листает группы ошибок страницами — длинный список больше не обрывается.bridge_health показывает, включён ли режим «только чтение», и пользователя 1С по умолчанию.bridge_health блок recent_errors стал объектом, записи лежат в поле
items; обвязку, которая читала блок как список, поправьте.migration_toolkit недоступен в режиме «только чтение», потому что пишет снимки
и восстанавливает каталоги выгрузок; для работы с ним нужно подключение без этого режима.execute_code при ошибке говорит, запускался ли код, а при неизвестном исходе даёт команду сверки;
ошибку платформы он точнее отличает от результата скрипта.delete_object и post_document ищут введённый текст как есть: знаки % и _ больше не расширяют поиск
до чужих объектов; при нескольких совпадениях delete_object перечисляет кандидатов с готовой командой.create-1c-user, остановка канала, поиск по выгрузке, чтение
модулей, проверка подписок, подготовка обновления типовой.Программа сама бережёт место на диске: проверяет запас перед тяжёлыми операциями и убирает свои рабочие файлы.
kobernik-mcp --version показывает версию программы, даже если настройка не завершена.setup кладёт рабочие файлы новой установки на просторный несистемный диск и говорит куда, у канала
по интернету — своя папка там же; своё место задаёт ключ --data-dir у setup и setup-channel.doctor показывает, сколько места занимают рабочие файлы программы, и советует перенести их с системного
диска на просторный.MCP_1C_DUMP_KEEP_DAYS).doctor — он назовёт устаревшие настройки и замену.setup-channel) — ненужное можно удалить вручную.doctor при ошибке в реестре баз показывает место ошибки и как её исправить, а не называет реестр пустым.doctor предупреждает о том же.Канал по интернету научился штатно останавливаться и сам следит за своим состоянием.
stop-channel штатно останавливает канал по интернету: сначала закрывает сеансы 1С и освобождает
лицензию, затем снимает задачу.doctor и bridge_health показывают,
сколько памяти занимает программа.setup-channel запускает остановленный канал и его точку входа, а не только проверяет настройку.doctor и журнала канала.setup-channel, закрывает от записи посторонними пользователями сервера
всё, что запускает от имени системы.find_object возвращает идентификатор каждой найденной записи: следующий вызов обращается именно к ней,
даже среди одноимённых.doctor точнее проверяет канал по интернету и к каждой находке даёт готовую команду исправления.clone_object — что повтор
создаст ещё одну копию, настройка канала в ожидании сертификата — что уточнить у сетевого администратора.Канал по интернету поднимается одной командой — вместе с точкой входа и сертификатом.
setup-channel сам поднимает точку входа канала: получает сертификат на ваше имя, открывает порт 443
и ставит автозапуск.Служебный выпуск: поведение программы не изменилось.
ИИ-помощник сам делает новые обработки, отчёты и печатные формы — от просьбы в чате до команды в меню 1С.
epf_scaffold, epf_build, epf_publish.epf_dump разбирает существующую внешнюю обработку в исходники для правки и обратной сборки.doctor пробной сборкой заранее показывает, доступна ли сборка обработок на сервере.epf_scaffold → epf_build → epf_publish.setup-channel, setup и doctor.setup-channel заводит постоянную работу канала по интернету: автозапуск вместе с сервером и перезапуск
после сбоя.doctor проверяет задачу канала и называет каждую недостающую настройку с готовой командой исправления.load_extension, apply_config_object
и restore_config_object требуют назвать цель прямо в вызове (параметр confirm) — дополните им свои сценарии.connect с пустым именем базы отвечает понятным отказом и называет базу по умолчанию.setup-channel сам создаёт файл настроек канала по интернету, не перезаписывает существующий
и предупреждает, если основной файл настроек уже переведён на канал.doctor.doctor считает ошибкой файл, который могут читать посторонние, и даёт команду исправления прав.Установка — четыре команды, и каждая называет следующий шаг.
create-1c-user одной командой заводит пользователя 1С для программы и записывает его пароль
в настройки; существующего пользователя дочинивает, ничего не удаляя.doctor → setup → create-1c-user → doctor --database <имя>: doctor работает до всяких
настроек, а setup заполняет настройки сведениями с самого сервера.fix-com чинит регистрацию COM-коннектора 1С; починку можно отменить.doctor и команд программы.create-1c-user; если ваши инструкции ссылались на прежнюю команду, замените её.doctor.setup, доступен только учётной записи программы; тексты ошибок очищаются
от паролей и других секретов до показа ИИ-помощнику.Печатные формы и лицензия по величине предприятия.
list_print_forms — команды печати и макеты, get_printed_form — форма картинкой
или файлом, manage_print_template — прочитать, подменить, откатить макет.operation_status.doctor называют настоящую причину и команду, которую можно сразу выполнить.clone_object заполняет дату у копии документа.dump_config_object по объекту расширения называет верный маршрут.Удалённая работа с базами: канал поднимается одной командой, вход — через привычную учётную запись.
setup-channel: она готовит настройки
и памятку для подключающегося.kobernik-mcp.exe — при обновлении поправьте имя
и в настройках MCP-клиента.doctor называет все причины отказа за один прогон.Первый стабильный выпуск.
clone_object — копия существующего документа с нужными правками за один вызов.doctor свою версию; проверка сервера верно определяет вход в MS SQL.describe_object показывает значения перечислений; run_query при пустой выборке по датам называет
фактические границы данных.edit_module не может повредить текст модуля, время событий журнала регистрации не смещается, проверка
выгрузки перед загрузкой не пропускает найденные проблемы.grep_dump — поиск по выгрузке конфигурации; работа с конфигурацией баз на PostgreSQL; команды установки
и починки окружения.operation_status; ответы тяжёлых
инструментов ограничены по объёму и сообщают, сколько показано.repost_chain перепроводит всю цепочку, ошибки записи приходят с причиной и следующим шагом,
постраничная выборка не теряет строк на границе страниц.doctor и setup; экспериментальная
сборка внешних обработок из шаблонов.