AI x 1C Guide — воркфлоу

Гайд с рабочими скриптами по безопасному подключению агента к 1С и Bitrix24: OData, вебхуки и каталог из 14 проверенных инструментов

  • 13 ★ репозитория
  • Последний коммит
  • MIT
Воркфлоу

Расширенный доступ

Почему такой уровень

  • Python-скрипты из scripts/ обращаются к 1С:УНФ по OData и к Bitrix24 по вебхуку
  • В примерах реализовано только чтение, запись гайд выносит в отдельный шаг с правами
Все причины и проверки
Российский стек

aleksandr-litvinenko/1c-ai-guide

Установка

Работает в

Ручная установка

python scripts/fresh_odata_example.py

Пример клиента для 1С:Фреш OData, запускается после клонирования репозитория и настройки своих параметров подключения.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Python-скрипты из scripts/ обращаются к 1С:УНФ по OData и к Bitrix24 по вебхуку
  • В примерах реализовано только чтение, запись гайд выносит в отдельный шаг с правами

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Репозиторий разбирает четыре реальных интеграции с пометкой, что подтверждено на практике, а что нет: чтение и тестовая запись в 1С:УНФ через стандартный OData, чтение задач Bitrix24 через входящий вебхук, создание лидов из формы сайта через серверный вебхук, и сверка заявок между 1С-Коннект, Jira и Bitrix24. Каждая интеграция снабжена рабочим Python-скриптом в scripts/ с тестами и инструкцией в guides/. Отдельный каталог из 14 проектов (MCP-серверы, Agent Skills, hosted-сервисы) в catalog/tools.json помечен уровнем проверки: Docs, Artifact, CLI smoke или Live smoke, с указанием лицензии и ключевого риска. Гайд формулирует security baseline из десяти пунктов и четырехступенчатый порядок внедрения от исходников без базы до записи данных с подтверждением человека.

Для кого. Для 1С-разработчиков, интеграторов и руководителей, которые решают, как безопасно дать агенту доступ к 1С или Bitrix24, не рискуя рабочими данными.

Подходит, если

  • Нужен пошаговый разбор подключения агента к OData 1С:Фреш или УНФ
  • Нужно выбрать MCP-сервер или Agent Skills под конкретную задачу с честной оценкой рисков
  • Нужен чеклист security baseline перед тем, как давать агенту доступ к рабочей базе

Не подходит, если

  • Нужен готовый MCP-сервер, а не гайд с примерами и каталогом ссылок на другие проекты
  • Работаете не с 1С и не с Bitrix24

Пример запроса к агенту

Разберись, как безопасно подключить агента только на чтение к 1С:Фреш через OData, и покажи пример на моем HTTP-клиенте

Ограничения

Сам репозиторий не MCP-сервер и не устанавливаемый агентский инструмент, а гайд со скриптами-примерами и сравнительным каталогом. Часть сценариев (запись в 1С:УНФ, часть Bitrix24) подтверждена в рабочем коде автора, но не воспроизводилась публично, это честно указано в тексте. Оценки инструментов в каталоге основаны на документации и локальных проверках автора, не на независимом аудите каждого проекта.

Как отключить. Просто не используйте примеры скриптов из scripts/, гайд не устанавливает ничего в проект автоматически.

Частые вопросы

Гайд гарантирует безопасность перечисленных MCP-серверов?

Нет, README прямо пишет, что не объявляет инструменты безопасными или готовыми к продакшену, а только фиксирует уровень проверки.

Чем отличается MCP-сервер от Agent Skills в этом гайде?

MCP-сервер дает агенту инструменты и доступ к внешней системе по протоколу, а Agent Skills это правила и workflow внутри самого клиента, часто без обращения к базе вовсе.

Обсуждение

Вопросов и отзывов пока нет.

Российский стек

Набор скиллов и рецептов, чтобы агент писал корректный и безопасный код для сайтов на «1С-Битрикс: Управление сайтом»

СкиллРасширенный доступ9Звезды репозитория
Российский стек

Среда разработки 1С с MCP-сервером на 10 инструментов: 11 анализаторов BSL, JSON DSL в XML, граф зависимостей и сборка EPF без 1С

MCP-серверШирокий доступ18Звезды репозитория
Российский стек

Devcontainer и Hyper-V VM с сервером 1С, изолирующие ИИ-агента от хостовой машины, чтобы ошибочная команда не задела реальные файлы и диски

ВоркфлоуРасширенный доступ44Звезды репозитория
Российский стек

Маленькое расширение 1С с HTTP-сервисом и скилл, чтобы агент сам писал запросы на языке 1С и получал данные базы в TSV

СкиллРасширенный доступ56Звезды репозитория
Российский стек

MCP-сервер для баз 1С:Предприятия через стандартный OData: справочники, документы, регистры и бухгалтерия без расширений в конфигурации

MCP-серверШирокий доступ13Звезды репозитория

ИИкона

ИИкона (1c-ai-connector)

Российский стек

Расширение 1С с коннектором к LLM, агентским циклом, RAG, мониторингом ошибок и MCP-сервером, который открывает базу внешним агентам

MCP-серверШирокий доступ108Звезды репозитория

Коротко о README

README дает таблицу быстрого старта по сценариям, разбирает четыре подключения с указанием, что проверено вживую, объясняет, что OData 1С не read-only по умолчанию и как ограничить его на чтение, приводит таблицу выбора инструмента и таблицу каталога из 14 проектов с уровнями проверки и рисками, диаграмму архитектуры, четыре ступени внедрения, security baseline и частые вопросы.

Бейдж для README

Сообщить о проблеме