# Сборка и проверка MCP 6.2.5

Этот выпуск содержит `Module.bsl` — текст модуля HTTP-сервиса. Это не готовое расширение и не конфигурация 1С. Версия исходника: **6.2.5**, 94 регистрации инструментов. Лицензия MIT сохранена.

## Подготовка

1. Возьмите код из тега `v6.2.5`. Сверьте `Module.bsl` с `SHA256SUMS` (`shasum -a 256 Module.bsl` на macOS, `sha256sum Module.bsl` на Linux).
2. Используйте тестовую копию вашей информационной базы, совместимую платформу 1С и учётную запись разработчика. До изменения сохраните исходное расширение и резервную копию базы.
3. Если расширение MCP уже существует, сохраните его HTTP-сервис, шаблоны URL и имена обработчиков. Обновляется целый модуль, а не одна строка из старой инструкции.

## Обновление существующего расширения

1. В Конфигураторе откройте расширение MCP и модуль его HTTP-сервиса.
2. Замените текст модуля содержимым `Module.bsl` из этого тега. Обработчик POST должен вызывать функцию `ОбработатьЗапрос(Запрос)`; проверьте привязку метода в метаданных сервиса.
3. Выполните проверку синтаксиса в серверном контексте. Исправления специфики конфигурации оформляйте отдельно; не меняйте молча исходник, называя его тем же артефактом.
4. Обновите расширение в тестовой базе. Если HTTP-сервис уже опубликован и его метаданные не менялись, сначала проверьте существующую публикацию; переустановка веб-сервера не является обязательным шагом обновления модуля.
5. Экспортируйте расширение средствами Конфигуратора в `.cfe`. Зафиксируйте версию платформы, конфигурацию, SHA-256 исходника и SHA-256 полученного файла.
6. Выгрузите собранное расширение в файлы и сравните модуль HTTP-сервиса с исходником этого выпуска. Допустимую нормализацию BOM/переносов строк запишите явно.

## Если расширения ещё нет

Создайте отдельное расширение в Конфигураторе. Добавьте HTTP-сервис с корневым URL `mcp`, шаблон для выбранного пути и метод POST, привязанный к `ОбработатьЗапрос`. Поместите `Module.bsl` в модуль сервиса. Опубликуйте тестовую базу с этим HTTP-сервисом по правилам вашей платформы и веб-сервера. Конкретный адрес зависит от публикации; пример: `https://your-server/base/hs/mcp/`.

Настройте аутентификацию и минимальные права пользователя. Не публикуйте административные инструменты анонимно в Интернет. Доступ к инструментам записи, выполнения кода, ролям и расширениям должен соответствовать вашей модели прав. `ONEC_ALLOWED_TOOLS` ограничивает Node-обёртку, а не прямые обращения к HTTP-сервису 1С.

## Приёмка именно установленной версии

Через настроенный MCP-клиент или HTTP-клиент с защищённым хранением учётных данных проверьте:

1. `initialize`: `serverInfo.version` равен `6.2.5`.
2. `tools/list`: 94 уникальных имени в полном каталоге HTTP-сервиса; есть `check_object_fill`. Через Node-обёртку при заданном `ONEC_ALLOWED_TOOLS` ожидается только разрешённое подмножество.
3. `get_server_info`: `mcp_server_version` равен `6.2.5`.
4. `get_object_attributes` для реально существующего объекта: для ссылочных реквизитов приходит `type_names` с техническими именами типов.
5. `check_object_fill` для согласованного справочника/документа: неполные реквизиты возвращают `is_complete:false`. Сверьте `missing`/`missing_fields` с проверкой в интерфейсе 1С. Конкретные сообщения зависят от модулей конфигурации.
6. Убедитесь, что проверка заполнения не записала объект. Сам инструмент не вызывает запись, но обработчики вашей конфигурации требуют отдельной проверки на побочные эффекты.
7. На тестовой базе проверьте разрешённый сценарий создания и отказ записи: доступные сообщения 1С должны попасть в ответ; нежелательных записей при отказе быть не должно. Эти проверки не выполнять на рабочих данных без согласованного сценария.

Сохраните результаты с версиями и хешами. Успешный `npm test` проверяет транспорт на локальном HTTP-стенде, а не компиляцию BSL, полные права или бизнес-сценарий в 1С. Выпуск исходников не означает автоматическое обновление установленных расширений.