1С через OData: MCP-сервер на чтение

onec-odata-mcp

MCP-сервер на npx, который дает Claude доступ на чтение к базе 1С через стандартный OData без выгрузки в Excel и ручных URL

  • 0 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

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

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

  • По умолчанию только читает данные 1С, но запись включается флагом ONEC_WRITABLE
  • Пароль пользователя 1С передается в переменных окружения MCP-клиента
Все причины и проверки
Российский стек

pyrfor/onec-odata-mcp

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/onec-odata-mcp

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

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

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

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

  • По умолчанию только читает данные 1С, но запись включается флагом ONEC_WRITABLE
  • Пароль пользователя 1С передается в переменных окружения MCP-клиента

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

Что делает

Сервер подключается к опубликованному в 1С стандартному интерфейсу OData и переводит вопросы на естественном языке в запросы к справочникам и документам. Работает с любой конфигурацией, где включен OData: Бухгалтерия, ERP, Управление торговлей или самописные решения. По умолчанию доступ только на чтение, запись включается явно переменной ONEC_WRITABLE. Есть кеш метаданных с настраиваемым TTL и переменная ONEC_DATABASE для подсказки имени базы, если их несколько.

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

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

  • В конфигурации уже опубликован стандартный OData-интерфейс
  • Нужен быстрый структурированный доступ к справочникам и документам вместо выгрузки в Excel
  • Достаточно готового npm-пакета без сборки из исходников

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

  • OData не опубликован в базе и публиковать его нельзя
  • Нужна запись в базу: по умолчанию сервер только читает, запись включается отдельно и не для всех сценариев тестировалась

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

Покажи все документы реализации за прошлую неделю с суммой больше 100000 рублей через OData 1С

MCP

Транспорт
stdio
Авторизация
не нужна

Переменные окружения

ONEC_BASE_URL обязательная
URL опубликованного OData-интерфейса базы 1С.
ONEC_USERNAME обязательная
Логин пользователя 1С для OData.
ONEC_PASSWORD обязательная, секрет
Пароль пользователя 1С для OData.
ONEC_DATABASE
Подсказка имени базы, если их несколько.
ONEC_METADATA_CACHE_TTL_MS
TTL кеша метаданных в миллисекундах, по умолчанию час.
ONEC_WRITABLE
Включает запись в базу, по умолчанию сервер только читает.

Ограничения

Нужен опубликованный стандартный OData-интерфейс 1С, логин и пароль пользователя. README отмечает, что скриншот или видео пятиминутной настройки еще не добавлены, часть примеров помечена как TODO. Запись включается флагом ONEC_WRITABLE и требует аккуратной проверки прав пользователя, от имени которого работает сервер.

Как отключить. Удалите сервер командой claude mcp remove onec-odata или уберите запись onec-odata из claude_desktop_config.json.

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

Нужно ли что-то ставить локально?

Нет, npx подтягивает пакет при первом запуске, сборка из исходников нужна только для разработки.

Можно ли писать в базу?

По умолчанию нет, сервер только читает. Запись включается переменной ONEC_WRITABLE.

Обсуждение

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

MCP-сервер OData 1С

1C OData MCP Server

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

Небольшой MCP-сервер на Python, который оборачивает стандартные операции чтения OData 1С:Управление предприятием в три инструмента

MCP-серверШирокий доступ

MCP-сервер OData 1С с JSON-кэшем

MCP сервер для работы с OData 1C

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

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

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

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

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

MCP-шлюз на Go между агентом и HTTP-сервисом 1С: справочники, продажи, остатки, деньги и расчеты по нескольким базам

MCP-серверРасширенный доступ5Звезды репозитория
Российский стек

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

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

Опубликованный на PyPI read-only MCP-сервер для стандартного OData 1С:Предприятие 8.3.5+: схема, запросы с фильтрами, поиск записи по Ref_Key

MCP-серверШирокий доступ

Из блога

Коротко о README

README сразу заявляет цель: подключить 1С к Claude за пять минут через стандартный OData вместо ручных URL и выгрузок в Excel. Даны два способа подключения: командой claude mcp add и вручную в claude_desktop_config.json, обязательные переменные ONEC_BASE_URL, ONEC_USERNAME, ONEC_PASSWORD и опциональные ONEC_DATABASE, ONEC_METADATA_CACHE_TTL_MS, ONEC_WRITABLE.

Бейдж для README

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