AI x 1C Guide

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

Воркфлоу

Низкий риск

Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.

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

  • Примеры по умолчанию только читают данные, команды записи в них не реализованы
  • Гайд прямо описывает риски записи через OData и требует отдельных прав и негативных тестов перед ее включением
Все причины и проверки
Российский стек

aleksandr-litvinenko/1c-ai-guide

Установка

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

python scripts/fresh_odata_example.py

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

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

Что делает

Репозиторий разбирает четыре реальных интеграции с пометкой, что подтверждено на практике, а что нет: чтение и тестовая запись в 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/, гайд не устанавливает ничего в проект автоматически.

Проверка безопасности

  • Примеры по умолчанию только читают данные, команды записи в них не реализованы
  • Гайд прямо описывает риски записи через OData и требует отдельных прав и негативных тестов перед ее включением

Коротко о README

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

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

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

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

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

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

Выбор редакции

Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода

ПлагинСредний рискБез VPN292,5 тыс.Звезды репозитория
Выбор редакции

Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура

СкиллНизкий риск271,4 тыс.Звезды репозитория
Выбор редакции

Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации

CLIСредний рискБез VPN139,3 тыс.Звезды репозитория

Референсные MCP-серверы

Model Context Protocol servers

Официальный

Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything

MCP-серверСредний риск90,6 тыс.Звезды репозитория
Foxx AIAI x 1C Guide

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.