Универсальный MCP-сервер 1С (только чтение)
Universal 1C MCP Server (Read-Only)
Строго read-only MCP-сервер поверх HTTP-сервиса 1С: 39 инструментов для метаданных, запросов, бухгалтерии и отчетов
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Отдает бухгалтерские остатки, проводки и персональные данные контрагентов и пользователей согласно правам
- Опциональный инструмент get_query_examples пишет обезличенные шаблоны запросов в журнал регистрации при включенном флаге
Установка
Ручная установка
Создай расширение MCP в Конфигураторе, загрузи в него 17 общих модулей и HTTP-сервис MCP_HTTPService из src/CommonModules и src/HTTPServices репозитория Vishez86/1c-mcp-server атомарно всем комплектом, опубликуй базу на веб-сервере, затем подключи MCP-клиент к https://<сервер>/<база>/hs/mcp/rpc по протоколу Streamable HTTP.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер реализует протокол MCP 2025-11-25 поверх расширения 1С и дает LLM-агенту 39 инструментов, не изменяющих постоянные данные: discovery метаданных и подписок на события, безопасные запросы с pre-flight проверкой полей и табличных частей до вызова движка, встроенную документацию языка запросов по версиям платформы, бухгалтерские инструменты (карта счетов и субконто, остатки, aging по субконто, сравнение двух наборов остатков, проводки), быстрые остатки товара, чтение регистров всех видов, движения документов, отчеты через СКД, историю объектов из журнала регистрации, паспорт базы без единого обращения к данным и реестр разрешенных правовых источников (только pravo.gov.ru, без общего веб-поиска). Каждый ответ несет контекст авторизации и признак некэшируемости, права текущего пользователя 1С и allowlist/denylist метаданных применяются на каждом вызове, а все вызовы аудируются с correlation_id. Сервер не привязан к конкретной типовой конфигурации: работает поверх УТ, ERP, БП и других на платформе 8.3.10+.
Для кого. Для 1С-команд, финансистов и аналитиков, которым нужен безопасный read-only доступ агента к метаданным, коду запросов, бухгалтерии и отчетам любой конфигурации 1С без риска изменить данные.
Подходит, если
- Нужен read-only доступ агента к произвольной конфигурации 1С без угадывания API конкретного продукта
- Нужны бухгалтерские остатки, обороты, aging по субконто и сравнение двух наборов остатков без ручного написания запроса
- Нужна политика доступа к правовым источникам, которая запрещает агенту общий веб-поиск норм права
Не подходит, если
- Нужна запись данных: сервер строго read-only, за единственным исключением накопления обезличенных шаблонов запросов, и это тоже опционально выключено по умолчанию
- Платформа 1С ниже 8.3.10: инструмент get_query_examples использует ХешированиеДанных и СхемаЗапроса, доступные только с этой версии
Пример запроса к агенту
Покажи дебиторскую задолженность по контрагентам старше 90 дней на конец мая по счету 62Ограничения
Устанавливается вручную: расширение и 17 общих модулей нужно создать и загрузить в Конфигураторе по подробной инструкции, готового установщика или .cfe нет, и публиковать модули нужно атомарно целым комплектом, иначе часть инструментов падает с internal_error. Для доступа из облачных клиентов вроде Claude web базу нужно опубликовать по HTTPS в публичном интернете. В репозитории не указана лицензия использования кода.
Как отключить. Отключите или удалите расширение MCP в базе через список расширений в Конфигураторе и уберите сервер из конфигурации MCP клиента.
MCP
- Транспорт
- http
- Авторизация
- API-ключ
Проверка безопасности
- Отдает бухгалтерские остатки, проводки и персональные данные контрагентов и пользователей согласно правам
- Опциональный инструмент get_query_examples пишет обезличенные шаблоны запросов в журнал регистрации при включенном флаге
Коротко о README
README дает таблицу всех 39 инструментов с назначением, подробно описывает каждый: параметры, пример вызова, выходную схему и ограничения, включая pre-flight отказ запроса до вызова движка 1С с подсказками did_you_mean. Отдельно разобрана политика правовых источников (только pravo.gov.ru, запрет общего веб-поиска), режимы ответа text_only/structured_only/both, встроенная база знаний по языку запросов с версионированием документации и генератор BSL-индекса из markdown-источников. Указана минимальная версия платформы 8.3.10 и дана структура проекта с общими модулями расширения.
Частые вопросы
Может ли сервер изменить данные базы?
Нет, все инструменты read-only, единственное исключение это опциональное накопление обезличенных шаблонов успешных запросов в журнале регистрации, включаемое отдельным флагом и выключенное по умолчанию.
Работает ли сервер с любой конфигурацией 1С?
Да, он универсальный и не зависит от конкретной конфигурации вроде УТ, ERP или БП, но требует платформу 8.3.10 и выше.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything