OneC77 — MCP и HTTP API для 1С 7.7
OneC77 объединяет 149 инструментов сопровождения и работы с 1С 7.7, веб-пульт и прямой HTTP API. Ассистент использует MCP, а внешняя программа вызывает инструменты и подготовленный код без языковой модели. Задания, контекст, результаты, права и модельный расход доступны через соответствующие интерфейсы пульта и шлюзов.
Для кого
Разработчикам 1С 7.7, специалистам сопровождения, интеграторам и ИТ-службам, которые автоматизируют работу с конфигурацией, обработками, отчётами и данными согласованных баз.
Какие задачи решает
- Находить и точно изменять исходники, модули и формы 1С 7.7
- Разрабатывать и собирать внешние ERT/ERF с проверкой артефакта
- Читать и изменять MXL-макеты, включая пакетные операции
- Получать метаданные, данные и бухгалтерские выборки предметными инструментами
- Вызывать каталог и подготовленный код из внешних программ без модели
- Управлять заданиями, контекстом, доступом и модельными подключениями
Что делаем
OneC77 — предметный исполнитель для 1С 7.7. MCP-клиент получает каталог инструментов с описаниями и схемами аргументов; HTTP-клиент обращается к тому же исполнителю. Сохраняются выбранная база, пользователь, права и режим подключения. Инструмент возвращает фактический результат и диагностику, а не только текст помощника.
В каталоге 149 инструментов: навигация и поиск по исходникам, точные изменения CP1251/CRLF, контекстная проверка языка, TurboMD*/MD, формы и модули, рабочие задания ERT/ERF, MXL и пакетные изменения макетов. Есть маршруты метаданных, справочников, документов, бухгалтерии, прав, диагностики и исполнения подготовленного кода 1С. Внешняя обработка проходит через сборку и контрольную распаковку; техническая проверка файла отделена от проверки его прикладного поведения.
Прямой HTTP API /api/v1 предоставляет каталог и OpenAPI-схему, отправку инструмента, отдельный вход для database_execute, чтение операции, отмену и ответ на запрос контекста. Семь маршрутов обслуживают все разрешённые инструменты каталога. Этот путь не вызывает модель и не использует её профиль или квоту.
Программный клиент подключается к локальному пульту с X-Console-Token и cookie авторизованного сеанса базы. Операция содержит UUID request_id и привязку к базе и пользователю; context_id продолжает многошаговый сценарий. Принятие HTTP 202 не означает завершение: клиент читает state, result, failure и необходимость сверки. Повтор той же отправки возвращает принятую операцию; неизвестный результат после отмены или перезапуска не переисполняется автоматически.
Веб-пульт объединяет выбор базы и пользователя, задачи, диалоги, историю, выбранный рабочий контекст, файлы и изображения, ход длительных операций и форму уточнения. Его служебный API описывает сеанс, настройки, права базы, задания, вложения, профили моделей и discovery. Из трея можно открыть пульт и управление своими серверами; установку на сервер заказчика можно выполнять с помощью ассистента через внутреннюю VPN-сеть.
Модельные шлюзы поддерживают родительские и собственные источники моделей, Codex, совместимые API и Ollama, опубликованные дочерним установкам профили и каскадную передачу. Протокол модельного хода возвращает ответ или вызовы инструментов; исполняющая установка отправляет результаты обратно. Трассировка сохраняет связь между узлами, проверка цепочки предотвращает циклы.
Управление моделями разделяет заказчиков, установки, пользователей и задачи: роли, право запуска, изменения данных и выбора моделей, токенные и параллельные лимиты, резервирование и фактический расход. Операторская очередь доставляет инструмент на зарегистрированную установку, принимает состояние, результат, ввод и отмену. Пароль базы остаётся на узле исполнения; неизвестные результаты и расходы требуют сверки.
Полный справочник на mcp.ster.by содержит все схемы инструментов, примеры подключения, HTTP API, служебный API пульта, модельные запросы, доступ и квоты, операторские команды и восстановление. Отдельный TransportOfRequests описан как самостоятельный API-шлюз; собственный runtime API SterBase относится к другому продукту.
- 149 инструментов с опубликованными схемами аргументов
- CP1251/CRLF, поиск, точные изменения и контекстная проверка кода
- TurboMD/MD, формы, ERT/ERF и MXL с проверкой артефакта
- Метаданные, справочники, документы, учёт, права и диагностика
- Прямой HTTP API без модели: каталог, выполнение, состояние, ввод и отмена
- request_id, многошаговый context_id и восстановление без слепого повтора
- Веб-пульт, история, рабочий контекст, вложения и управление из трея
- Модельные шлюзы, квоты, расход, трассировка и операторская очередь
Как проходит работа
Определяем проект или базу, пользователя, необходимые операции и критерий результата. Настраиваем штатное подключение и проверяем каталог установленной версии.
Для разработки используем предметный цикл изменений и проверки артефакта. Для программной интеграции выбираем инструмент и его схему, сохраняем идентификатор операции и проверяем итоговое состояние.
Проверяем нужный прикладной сценарий в согласованной среде и передаём параметры подключения, документацию и порядок обновления.
Что получает заказчик
- Единый исполнитель для MCP-ассистента и программного HTTP-клиента
- Проверяемые исходники, формы, обработки и макеты
- Состояние и результат операций с сохранением контекста
- Управление доступом и модельным расходом
- Полная документация инструментов и API-слоёв
Примеры работ
Частые вопросы
Нужна ли языковая модель для HTTP API?
Нет. /api/v1 вызывает разрешённый инструмент либо database_execute без inference и модельной квоты. Модельный шлюз нужен для запросов к модели, а не для прямого исполнения API.
Можно ли открыть этот API как обычный публичный веб-сервис?
Прямой API работает в локальном пульте через loopback, с токеном и авторизованным сеансом базы; браузерный Origin запрещён. Для операторских команд на удалённую установку предусмотрен отдельный зарегистрированный транспорт.
Что означает успешный ответ?
HTTP 202 означает принятие. Нужно прочитать конечное состояние и результат инструмента, затем проверить нужный объект, файл или показатель. Отмена не означает откат изменений.
Как обеспечивается повторная доставка?
Клиент сохраняет request_id. Тот же UUID с теми же параметрами возвращает принятую операцию; изменение задания под тем же UUID вызывает конфликт. Это не обещание exactly-once для произвольного кода 1С.