1C Odata MCP

Коннектор общается с 1Столько через OData. Если он включён — всё работает одинаково,как бы ни была развёрнута ваша база:

Тип хранилища (файловая или SQL) сам по себе сложностьне меняет— важно лишь, поднята ли веб-публикация OData.Без включённого OData коннектор работать не может(он не использует COM и не лезет в SQL напрямую).

Сырой OData 1С — это сотни техническихEntitySetс кириллическими именами (Catalog_Контрагенты,Document_РеализацияТоваровУслуг,AccumulationRegister_ТоварыНаСкладах) и GUID-ключами. Работать с этим из чата невозможно, а писать свой код под каждый отчёт долго.

Сервер прячет всю технику за понятными инструментами. Вы спрашиваете обычным языком — ИИ сам выбирает нужный инструмент, ходит в OData вашей базы и возвращает готовый ответ. Для руководителя — быстрый срез по бизнесу, для бухгалтера — рутина создания документов под контролем.

- «Покажи дебиторку» → сальдо счёта 62 по контрагентам
- «История по контрагенту Ромашка» → все документы и взаиморасчёты
- «Остатки на складе» → количество и сумма по номенклатуре
- «Продажи за май», «движение денег за квартал» → обороты за период
- поиск контрагентов и документов, карточки объектов, карта базы

Действия (при включённой записи, всегда с предпросмотром и подтверждением):

- «Заведи контрагента ООО Ромашка, ИНН …, телефон, email, расчётный счёт, директора»
- «Выстави счёт покупателю на 3 шт по 1000» → документ-черновик
- «Создай поступление от поставщика и реализацию покупателю», «проведи документ» → проводки формирует сама 1С
- «Оформи возврат от покупателя», «перемещение между складами», «оприходование / списание / инвентаризацию»
- «Проведи оплату», «списание с расчётного счёта», «приходный / расходный кассовый ордер»
- «Выпиши счёт-фактуру на реализацию», «акт об оказании услуг»
- изменение реквизитов, строк документов; проведение и пометка на удаление

Читать можно документлюбоготипа (не только из списка выше) — «покажи возвраты за май», «найди перемещения» и т.п.

Ниже — Claude Desktop, но диалог выглядит так же в любом MCP-клиенте.

Вы: Кто из покупателей должен больше всего и на сколько? Claude: (вызывает read.analytics.get_debtors) Топ дебиторов на сегодня: 1. ООО «Ромашка» — 1 240 500 ₽ 2. ИП Иванов — 318 000 ₽ 3. ООО «Берёзка» — 94 050 ₽ Всего по счёту 62: 1 800 000 ₽. Вы: Заведи нового покупателя ООО «Восход», ИНН 7701234567, и выстави счёт на 10 шт по 2500. Claude: (dry-run) Будут созданы: • Контрагент «ООО Восход» (ИНН 7701234567) • Счёт покупателю на 25 000 ₽ (10 × 2500) Подтвердить создание? Вы: Да Claude: Готово: контрагент 00-000123, счёт № … (черновик, непроведён).

Впервые слышите про MCP?Это открытый протокол (Model Context Protocol), по которому ИИ-ассистент подключается к внешним инструментам. Здесь инструмент — ваша 1С: ассистент сам вызывает нужные функции и возвращает ответ. Ничего программировать не нужно — три шага ниже.
-

Пропишите серверв Claude Desktop (claude_desktop_config.json), подставив адрес и учётные данные:

55 инструментов (21 чтение/аналитика + 34 записи). У всех есть необязательный параметрdatabase(какая база 1С — см.read.system.list_databases); у аналитических — ещё иorganization(фильтр по юрлицу — см.read.system.list_organizations).

Запись (✍️ требует включения, работает через dry-run →confirm=true):

Все инструменты проверены на живой базе1С:Бухгалтерия предприятия 3.0.

По умолчанию сервер работает только на чтение.Запись включается осознанно, черездва независимых предохранителя:
- Глобальный рубильникREAD_ONLY=false.
- Пер-базовый флагODATA_DB_<ИМЯ>_WRITABLE=true— базы без него остаются read-only даже при снятом глобальном. Так можно открыть запись в одну базу (напр. ИП) и защитить другие (напр. ООО).

- dry-run по умолчанию— инструмент сначала показывает, что создаст, и пишет только приconfirm=true;
- мягкое удаление—write.entity.mark_for_deletionставит пометку (как в 1С); жёсткогоDELETEнет;
- на стороне 1С в «Состав OData» включаются только нужные объекты, а у пользователя 1С должны быть права на запись.

Приватность данных.Сервер — локальный процесс на вашей машине: он ходит только в вашу базу 1С (по Basic-аутентификации) и отдаёт данные вашему MCP-клиенту. Никаких сторонних серверов проекта в цепочке нет. Если использоватьлокальную модель(Ollama, LM Studio), данные 1С вообще не покидают вашу сеть. Секреты — только из.env(или блокаenvконфига); пароль и заголовок авторизации в логи не попадают.

- Нужен опубликованный OData.Сервер работает только через стандартный интерфейс OData 1С. Прямого доступа к SQL, COM-соединения или файлам сервера 1С он не использует и не требует.
- Объект должен быть в «Составе OData».Если объект не опубликован, инструмент вернёт вежливую подсказку с именем объекта и путём, куда его добавить. Публикуйте по мере необходимости.
- Целевая конфигурация — Бухгалтерия предприятия 3.0.Имена объектов автоопределяются из$metadata, но аналитика (дебиторка/остатки) и счета учёта документов рассчитаны на план счетов БП 3.0. На УТ/ERP и самописных конфигурациях чтение справочников/документов работает, а бухгалтерская аналитика может потребовать доработки.
- Документы создаются непроведёнными.Проводки формирует сама 1С при проведении (write.document.post_documentили вручную) — сервер не «рисует» проводки напрямую.
- Регламентные операции не создаются.Закрытие месяца, амортизацию, расчёт себестоимости/НДС генерирует обработка «Закрытие месяца» своими алгоритмами — через OData их не запустить. Читать (read.document.search_documents/read.document.get_document) можно.
- Оплата (write.money.create_payment).Документ создаётся и проводится, но бухгалтерские проводки Дт 51 Кт 62 формируются только если у банковского счёта организации настроен счёт учёта (51) — это настройка в 1С.
- ОГРН и прочие доп.реквизиты.Пишутся, только если в базе заведён соответствующий «дополнительный реквизит» (Администрирование → Дополнительные реквизиты). Иначе инструмент честно сообщает, что записать некуда.
- Адреспишется текстом-представлением (не структурированный ФИАС-адрес).
- Пагинация и лимиты.Чтобы не выгружать тысячи строк, действует размер страницы и защитный максимум (ODATA_PAGE_SIZE/ODATA_MAX_ROWS); большие выборки усекаются с пометкой.

Локальный процесс на Node.js, общается с клиентом по протоколу MCP черезstdio, а с 1С — по HTTP к OData (Basic-аутентификация). Стек:Node.js 20+,TypeScript(strict), официальный@modelcontextprotocol/sdk, нативныйfetch,zod(валидация),pino(логи в stderr),fast-xml-parser(разбор$metadata).

Карта объектов строится автоматически из$metadataбазы и кешируется; запросы собираются типобезопасным билдером. Несколько баз — у каждой свой клиент и свой кеш метаданных.

src/ index.ts точка входа context.ts реестр баз: Connection (клиент + кеш $metadata) + ServerContext mcp/server.ts инициализация MCP SDK, регистрация инструментов, stdio odata/ клиент, билдер запросов, пагинация, разбор $metadata, аналитика, справочные резолверы, обработка ошибок, проверка публикации tools/ инструменты: meta, counterparties, documents, registers, cashflow, sales, organization, write config/ конфигурация (.env, мультибаза) и маппинг имён/счетов types/ типы OData и доменные типы

- +vs%20в OData 1С.1С не декодирует+в пробел внутри$filter(отвечает 400), поэтому query-string собирается черезencodeURIComponent(пробел →%20), а неURLSearchParams.
- Счета учёта документовне подставляются автоматически через OData (это делает форма 1С при выборе номенклатуры) — сервер берёт их из регистра «Счета учёта номенклатуры», с откатом на стандартные коды плана счетов.
- Логи и stderr.stdoutзанят JSON-RPC, поэтому логи идут вstderr— но только в терминале. Под MCP-клиентом (когдаstdin— pipe) логи пишутся в файл<tmpdir>/1c-odata-mcp/server.log, чтобы не сломать клиентов, трактующих любой вывод вstderrкак фатальную ошибку. Вернуть логи вstderr:MCP_LOG_STDERR=1.
- Типизированные ответы.У всех 55 инструментов объявленoutputSchema— клиенты, поддерживающиеstructuredContent(не только текстовый JSON), могут типизировать ответ, не парсить текст.
- Имена инструментов.Трёхсегментныйdot-notation:<read|write>.<категория>.<имя>(напр.read.analytics.get_debtors,write.sales.create_shipment) — группирует инструменты по категории и сразу видно, чтение это или запись.

MCP-клиент «висит» / запрос отваливается по таймауту.Если зависают даже мелкие вызовы (read.system.health_check,read.system.list_databases) — это почти всегдазалипший процесс MCP(в Claude Desktop лечится полным перезапуском приложения, Cmd+Q и заново), а не база. Здоровыйread.system.health_checkотвечает за секунду.

Указываю другую базу, а она «недоступна» / отвечает только одна.Параметрdatabase— этоимяизread.system.list_databases(полеname, напр.ooo), а не «человеческое» название (label, напр. «ООО Ромашка»). Обращайтесь по имени.

Работает медленно.Это латентностьвашей 1С / хостинга, не Claude: годовые выборки на «шумных» базах бывают 10–30 секунд. Спрашивайте более узким периодом (квартал/месяц) — ответ приходит за секунды.

Нужен ли доступ к SQL базы или COM?Нет. Сервер использует толькоOData— ничего не ставится внутри 1С, в SQL напрямую он не лезет.

Connect SAP Business One (SQL Server) to Claude AI Desktop via MCP. Query financials, inventory, sales, and purchasing with natural language.

A read-only MCP server for querying live Oracle SCM data, powered by the CData JDBC Driver.

A read-only MCP server by CData that enables LLMs to query live data from Sage 300.

A read-only MCP server for SAP BusinessObjects BI, powered by the CData JDBC Driver.

A read-only MCP server by CData that enables LLMs to query live data from Epicor Kinetic.

A read-only MCP server by CData that enables LLMs to query live data from Exact Online.

A read-only MCP server for Intacct, enabling LLMs to query live data using the CData JDBC Driver.

1C:Enterprise integration — metadata, BSL code search, queries, event log, syntax reference. One Go binary, zero dependencies.

A read-only MCP server for querying live SAP Fieldglass data, powered by the CData JDBC Driver.