Интеграция ИИ в 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С, где она размещена и какие вопросы хочется ей задавать.
- Мы разбираем задачу. Предлагаем, что нужно сделать, за какое время и сколько это будет стоить.
- Если вариант подходит, начинаем. Пробы на рабочей базе мы советуем начинать с её копии.
HomeIO, Рыбинск. Работаем удалённо по всей России. Код коннектора открыт: GitHub.