# kyvirok for 1C

**1С в Codex: спросите о документах, предложите изменение и проверьте его до записи.** Локальный MCP-сервер подключается к 1С:Предприятию 8 через стандартный интерфейс OData. Менеджер продолжает работать в своём окне 1С, пока помощник готовит ответ.

**English.** An open-source 1C:Enterprise (1С) OData MCP server for Codex. Read business records, preview a field-by-field change, and let a human approve before writing. Supports creation and updates of permitted catalog items and draft documents. Each company supplies its own connection and access rules.

[Скачать проект ZIP](https://github.com/figura-studio/kyvirok-1c/archive/refs/heads/main.zip) · [Настройка и подключение](INSTALL.md) · [Лицензия MIT](LICENSE)

## Что попробовать

| Просьба менеджера | Что произойдёт |
| --- | --- |
| «Найди сегодняшние заказы этого покупателя» | Помощник запросит доступные документы в базе и покажет выборку. |
| «В черновике заказа № 125 поменяй комментарий на “Самовывоз в пятницу”» | Вы увидите конкретный заказ, прежнее и новое значение. Запись потребует отдельного подтверждения. |
| «Подготовь карточку новой номенклатуры» | Сервис покажет поля будущей карточки. После подтверждения 1С примет запись или сообщит, каких данных требует ваша конфигурация. |

Для похожих просьб разработка отдельной команды не требуется. Администратор выбирает справочники, виды документов и поля, которые разрешено создавать или менять. Права пользователя в самой 1С также обязательны. Проведение документов, формирование штатной печатной формы УПД, электронная подпись и отправка по ЭДО выходят за рамки версии 0.1.0.

## Как проходит подтверждение

Сначала коннектор получает объект и показывает поля «было» и «станет». Для нового объекта показывает передаваемые поля. Менеджер проверяет имя базы, объект, номер или ключ, затем подтверждает запись в форме MCP-клиента. Предпросмотр одноразовый и действует пять минут. Если человек отказался или его программа не поддерживает подтверждение, запись пропускается. Изменённый за время просмотра документ нужно проверить ещё раз. Разрешение на запись табличной части даёт возможность заменить **всю таблицу**, включая удаление строк. В примере правил такая возможность выключена.

## Для сотрудника

> Открой [kyvirok for 1C](https://github.com/figura-studio/kyvirok-1c). Вместе с администратором подключи **тестовую копию** 1С по [инструкции](INSTALL.md). Найди черновик заказа и попроси изменить его комментарий. Сначала отмени предложение и проверь в 1С, что текст прежний. Затем повтори запрос, подтверди изменение и сверь результат в самой 1С.

## Состояние версии

Тест запускает настоящий процесс MCP и локальный имитатор OData с вымышленными данными. Он проверяет чтение исходных значений, создание, изменение табличной части, отмену, защиту от повторного применения и смену версии объекта. Совместимость с вашей конфигурацией, правами, обязательными реквизитами, обработчиками записи и формой подтверждения установленного клиента проверяется на тестовой копии. Для работы нескольких менеджеров проверьте, что ваша публикация 1С отклоняет устаревший заголовок `If-Match`.

Проект использует исходный код [hacker-cb/1c-odata](https://github.com/hacker-cb/1c-odata/tree/cf5f0d1cfb28cc24d0c9d374ad4a17d83dfe24c5). Подключение, чтение метаданных и работа с OData взяты из этого проекта. Здесь добавлены предпросмотр, подтверждение, правила записи и упаковка для Codex. См. [лицензию исходного проекта](vendor/LICENSE) и [уведомления о сторонних компонентах](plugins/kyvirok-1c/THIRD-PARTY-NOTICES.txt).