Интеграция ИИ в 1С: бот или приложение через MCP и OData
HomeIO 1С + ИИ

Интеграция ИИ в 1С: бот или своё приложение

Обновлено 20 ноября 2026

Постройте на 1С своего бота, отчёт по запросу или внутреннего ассистента. Коннектор отдаёт данные учёта вашему приложению в понятном виде, а защита остаётся на стороне сервера.

Два способа подключения

stdio: на компьютере пользователя

Приложение само запускает коннектор командой npx -y 1c-odata-mcp. Так работают Claude Desktop, Cursor и другие. Доступны все инструменты, а запись, если вы её включили.

HTTP: на сервере, только чтение

Коннектор работает как сервис рядом с вашим приложением. Адрес /mcp, доступ по токену Bearer. Все инструменты чтения доступны, инструментов записи клиент не видит.

Установка на сервере

Минимальные настройки режима HTTP:

MCP_TRANSPORT=http
MCP_HTTP_TOKEN=<не короче 32 символов>
MCP_HTTP_HOST=0.0.0.0
MCP_HTTP_PORT=8787
MCP_HTTP_ALLOWED_HOSTS=1c-odata
READ_ONLY=true
TOOLS_PROFILE=read
  • Без токена сервер не запустится, даже на локальном адресе.
  • Если адрес не из локальной сети, нужен список разрешённых хостов.
  • /healthz отвечает без токена и показывает лишь то, что процесс жив. Связь с базой проверяет read.system.health_check.
  • Шифрования (TLS) в самом сервере нет. За пределами внутренней сети поставьте перед ним прокси.

Режим HTTP не рассчитан на веб-чаты и выход в интернет: токен один, входа через OAuth и разделения пользователей нет. Держите сервер в закрытой сети.

Что удобно в коде

Ответы со схемой

У всех 81 инструмента описан формат ответа. Приложение получает структурированный результат, а не текст, который нужно разбирать.

Ошибки отдельным полем

Вид ошибки приходит явно, и не нужно угадывать причину по тексту.

Длинные списки по страницам

Один ответ не длиннее примерно 45 000 символов, остальное приходит следующими страницами. Конец списка не теряется.

Профили инструментов

TOOLS_PROFILE=read или точный список нужных инструментов. Чем их меньше, тем меньше места в контексте занимают описания.

Склады и организации с ключами

Отбор для отчёта собирается один раз и передаётся дальше вместе с Ref_Key.

Несколько баз и организаций

Для разных баз есть параметр database, для юридических лиц в одной базе фильтр organization.

Облачная модель и реквизиты

Если ваш бот работает на облачной модели, названия контрагентов и ИНН попадут в модель вместе с ответами инструментов. Защититься можно на своей стороне: заменять реквизиты метками до отправки в модель (и в вопросе пользователя, и в ответах инструментов), а перед показом человеку возвращать настоящие. Подводные камни этой схемы разобраны в README. А можно ли передавать такие данные по 152-ФЗ, лучше уточнить у юриста.

Всё о безопасности коннектора

1С и диспетчеризация зданий

Для управляющих компаний и ТСЖ мы связываем данные диспетчеризации многоквартирных домов с учётом в 1С, а коннектор даёт ассистенту доступ к самой 1С: для сверок, дебиторки и отчётов. О платформе диспетчеризации на scada.homeio.ru.

Вопросы разработчиков

Можно ли записывать документы в 1С из бота?

Через режим HTTP нельзя: он только для чтения, а при включённой записи сервер не запустится. Запись нужна человеку, который подтверждает предпросмотр, поэтому её делают в приложении с MCP-клиентом или в вашем собственном контуре подтверждения.

Сколько запросов выдержит 1С?

Сервер принимает запросы параллельно, но 1С обрабатывает запросы одной учётной записи по очереди. Ограничьте параллельность переменной ODATA_MAX_CONCURRENT_REQUESTS и задайте ODATA_TOOL_DEADLINE_MS меньше таймаута вашего клиента.

Как не перегружать модель описаниями инструментов?

Задайте TOOLS_PROFILE=read или перечислите только нужные инструменты: чем их меньше, тем меньше места в контексте уходит на описания.

Можно ли подключить несколько баз?

Можно. Один сервер обслуживает несколько баз (параметр database) и несколько организаций в одной базе (фильтр organization).

Подробно: подключение и настройка, исходный код на GitHub.

Сделаем бота или интеграцию с 1С под ваши задачи

Расскажите, что вы хотите получать от своей 1С. Мы предложим вариант и назовём стоимость: она всегда считается под вашу задачу.

  1. Вы звоните или пишете. Достаточно сказать, какая у вас 1С, где она размещена и какие вопросы хочется ей задавать.
  2. Мы разбираем задачу. Предлагаем, что нужно сделать, за какое время и сколько это будет стоить.
  3. Если вариант подходит, начинаем. Пробы на рабочей базе мы советуем начинать с её копии.

HomeIO, Рыбинск. Работаем удалённо по всей России. Код коннектора открыт: GitHub.