1С
Доступные операции
-
1c-eventlog-filter-values — получение списка допустимых значений для фильтрации журнала регистрации (пользователи, события, метаданные, приложения, компьютеры).
-
1c-eventlog-query — получение записей журнала регистрации 1С с фильтрацией по периоду, уровню, пользователям, событиям и другим параметрам. Возвращает данные в формате JSON.
-
1c-execute-code — выполнение произвольного кода 1С:Предприятие на сервере. Код имеет доступ к переменной __Возврат, которую обязательно нужно установить — её значение вернётся как результат. Требует подтверждения пользователя, если код может изменять данные.
-
1c-execute-query — выполнение запроса 1С и получение результата в различных форматах.
-
1c-get-metadata-structure — получение структуры объекта метаданных: поля, табличные части, владельцы, предопределённые элементы, значения перечислений.
-
1c-list-metadata-objects — получение списка объектов метаданных конфигурации с возможностью фильтрации по типу и имени.
-
1c-validate-query — проверка синтаксиса запроса 1С без выполнения.
Два способа подключения
-
Если у вас нет собственного MCP-сервера — добавьте предустановленный коннектор.
При таком подключении возможна работа только к одной базой 1C. -
Если у вас есть собственный MCP-сервер — создайте собственные MCP-коннекторы (подробнее), а затем переходите к авторизации.
При таком подключении необходимо создать по коннектору на каждую базу 1C.
Добавление предустановленного коннектора
| При таком подключении возможна работа только к одной базой 1C. |
1. Подготовка
1. Подключите расширение в базу
-
Подключите расширение через «Управление расширениями конфигурации» в Предприятии или в Конфигураторе.
-
Расширение — в файле mcp_dev.cfe (Чтобы скачать файл, откройте коннектор 1C в разделе
Администрирование → Коннекторы, нажмите
→ Настроить, а затем Скачать файл расширения и инструкцию). -
Перезапустите сеанс, чтобы расширение применилось.
2. Опубликуйте HTTP-сервис
Требуется установленный веб-сервер. Если его ещё нет — смотри ниже главу установка веб-сервера Apache 2.4.
| Запускайте Конфигуратор от имени администратора. |
-
Зайдите в Администрирование → Публикация на веб-сервере.
-
Задайте имя публикации (оно станет именем базы в URL) и каталог публикации.
-
На вкладке HTTP-сервисы включите флаг «Публиковать HTTP-сервисы расширений по умолчанию» (выбрать конкретный сервис расширения нельзя).
-
Опубликовать.
3. Проверьте работоспособность
Откройте в браузере (подставьте сервер и имя базы):
http://[сервер]/[база]/hs/mcp/health
После ввода логина/пароля 1С должен вернуться {"status": "ok"}.
Дополнительно: установка веб-сервера Apache 2.4
-
Скачайте дистрибутив: https://www.apachelounge.com/download/
-
Распакуйте (например, в C:\Apache24).
-
Зарегистрируйте службу — в папке Apache24\bin от имени администратора:
httpd.exe -k install -
Запустите службу (в оснастке services.msc или
httpd.exe -k start).
2. Добавление
Если вы сделали все подготовительные действия, можете приступать к подключению предустановленного коннектора 1C.
-
В разделе
Администрирование → Коннекторы, откройте коннектор 1C и нажмите
→
Настроить. -
Укажите:
-
Название.
-
Описание — коротко опишите возможности и инструменты коннектора, какие основные задачи он решает. По этим ключевым фразам ИИ-агент будет понимать, что необходимо подключить данный коннектор. Например, Добавь событие в календарь — для коннектора календаря. Описание отображается в карточке коннектора.
-
Публичный URL HTTP сервис 1C — вставьте URL опубликованной базы 1C.
-
Тип аутентификации — выберите тип аутентификации, используемый в вашей 1C.
-
Инструкция авторизации — Укажите инструкцию-подсказку по авторизации в коннекторе. Инструкция будет видна пользователям при наведении на иконку информации
рядом с кнопкой авторизации в коннекторе.
-
-
Нажмите Добавить или Добавить и войти в аккаунт, чтобы добавить и одновременно авторизоваться в коннекторе.
3. Авторизация
Для авторизации под единой учетной записью для всех пользователей, авторизуйтесь в разделе
Администрирование →
Коннекторы.
Для авторизации под персональной учетной записью и только для себя, авторизуйтесь в разделе
Коннекторы основного меню.
Подробнее про два подхода к авторизации.
-
Откройте коннектор и нажмите Войти в аккаунт.
-
Укажите:
-
Данные для входа. Они зависят от вашего способа авторизации в 1C.
-
Типовые проблемы при подключении 1С через MCP-сервер
Ниже приведены типовые проблемы, с которыми можно столкнуться при подключении 1С через MCP-сервер, их причины и способы решения.
Проблемы с режимом работы базы 1С
| Проблема | Причина | Как диагностировать | Решение |
|---|---|---|---|
Невозможно опубликовать HTTP-сервис |
База работает в файловом режиме (.1CD) |
Предприятие → Администрирование → Параметры системы → Режим работы |
Конвертировать базу в клиент-серверный вариант (SQL Server, PostgreSQL, Oracle) |
Публикация завершается ошибкой |
Отсутствует сервер 1С:Предприятия |
При публикации требуется указание SQL-сервера |
Установить сервер 1С или перенести базу на существующий сервер |
Проблемы с версией платформы 1С
| Проблема | Причина | Как диагностировать | Решение |
|---|---|---|---|
Нет пункта «Расширения конфигурации» |
Версия платформы ниже 8.3.10 |
Предприятие → Сервис → О программе |
Обновить платформу 1С до актуальной стабильной версии |
Нет вкладки «HTTP-сервисы» при публикации |
Версия платформы ниже 8.3.6 |
Конфигуратор → Администрирование → Публикация на веб-сервере |
Обновить платформу 1С до версии 8.3.6 или выше |
Расширение не работает корректно |
Несовместимость версии расширения и платформы |
Логи 1С, ошибки при вызове HTTP-сервиса |
Обновить платформу и расширение до актуальных версий |
Проблемы с веб-сервером
| Проблема | Причина | Как диагностировать | Решение |
|---|---|---|---|
Ошибка публикации на веб-сервере |
Веб-сервер (Apache/IIS) не установлен |
В списке служб Windows нет Apache/IIS |
Установить веб-сервер (см. инструкцию по установке Apache 2.4) |
Веб-сервер не запускается |
Конфликт портов, ошибка в конфигурации |
Служба Apache/IIS не стартует, логи веб-сервера |
Проверить логи, освободить порт 80/443, исправить конфиг |
HTTP-сервис недоступен после публикации |
Веб-сервер работает, но публикация не прошла |
Браузер возвращает 404 на |
Перепубликовать базу от имени администратора, проверить имя публикации |
Доступ только по HTTP, нет HTTPS |
Не настроен SSL-сертификат |
URL начинается с |
Получить и установить SSL-сертификат, настроить HTTPS в веб-сервере |
Проблемы с доступом из интернета
| Проблема | Причина | Как диагностировать | Решение |
|---|---|---|---|
URL недоступен извне |
Сервер в локальной сети без проброса портов |
|
Настроить проброс портов на роутере или reverse proxy (nginx/Apache) |
Нет статического IP |
Динамический IP у сервера |
IP меняется после перезагрузки |
Заказать статический IP у провайдера или использовать DynDNS |
Блокировка фаерволом |
Порт 80/443 закрыт |
|
Открыть порт в фаерволе Windows/iptables |
1С:Фреш (SaaS) |
Платформа не позволяет публиковать свои HTTP-сервисы на внешнем веб-сервере |
— |
Уточнить у провайдера 1С:Фреш наличие API для интеграции; рассмотреть переезд на self-hosted |
1С:Линк |
Доступ только через прокси 1С |
База размещена на 1С:Линк |
Использовать API 1С:Линк или запросить публикацию через поддержку |
Проблемы с расширением MCP-сервера
| Проблема | Причина | Как диагностировать | Решение |
|---|---|---|---|
Расширение не подключается |
Файл .cfe повреждён или несовместим |
Ошибка при подключении в Конфигураторе |
Скачать актуальную версию расширения, проверить совместимость |
HTTP-сервис не появляется после подключения |
Расширение не активировано, нет прав |
В списке HTTP-сервисов нет |
Перезапустить 1С, проверить права пользователя на расширение |
Ошибка авторизации в HTTP-сервисе |
Неверный логин/пароль, нет прав у пользователя |
Браузер запрашивает пароль, затем возвращает 401/403 |
Создать отдельного пользователя 1С с правами на HTTP-сервис |
|
Ошибка внутри расширения |
Логи 1С, журнал регистрации |
Включить логирование в расширении, проверить логи |
Часто задаваемые вопросы по коннектору 1С
| Вопрос | Ответ |
|---|---|
С какими конкретно конфигурациями 1С работает коннектор? |
Коннектор к 1С унифицированный, работает с различными конфигурациями. Рекомендуемые версии, с которыми работает коннектор — 8.3.6+ (в более ранних версиях нет вкладки «HTTP-сервисы» при публикации и нет пункта «Расширения конфигурации»). |
Работает ли он с доработанными конфигурациями? |
Коннектор к 1С унифицированный, работает с различными конфигурациями, включая доработки. Коннектор работает с базой 1С по запросу к ней через разработанные инструменты коннектора (файл расширения необходимо установить по предоставляемой инструкции). |
Нужна ли публикация базы 1С наружу? |
В виде поставки SaaS необходима публикация базы наружу — к базе должен быть выход в интернет, либо прописаны белые IP-адреса до Cowork. Настройка в 1С (подробнее в предоставляемой инструкции):
Настройка в Cowork:
|
Через что идёт подключение: API, OData, расширение, обработка, веб-сервис? |
Коннектор соответствует принципам стандарта MCP (спецификация): https://modelcontextprotocol.io/specification/2025-11-25 По такому же стандарту можно подключить любой другой коннектор, имея свой MCP-сервер (прорабатываем возможность предоставлять MCP-сервер в момент создания коннектора, чтобы расширить воронку пользователей, которые могут подключить необходимый open source коннектор). |
Кто настраивает права доступа к данным 1С? |
Авторизация пользователя в коннектор происходит по кредам из 1С. Права доступа в коннектор 1С используются те, которые соответствуют 1С. |
Можно ли ограничить доступ только чтением? |
Пользователь может настроить доступ к конкретному инструменту коннектора (требовать подтверждение / не использовать / использовать). Т.е. можно ограничить запись, поставив к инструменту настройку «отключен» или «требует подтверждения» (будет запрашивать у пользователя действие по инструменту). |
Можно ли разрешить создание черновиков, но запретить проведение? |
Как таковых черновиков в 1С, насколько я знаю, нет. Если такой функционал существует в какой-то конфигурации, то можно задействовать через агента (не могу точно сказать). |
Как обрабатывается сопоставление номенклатуры? |
Информация используется из базы данных — фактически каждый текстовый запрос пользователя преобразуется в запрос к базе 1С через инструменты, написанные кодом 1С. Аналогия — это SQL-запросы. Если необходимо сопоставить номенклатуру, то можно использовать дополнительно и внешнюю таблицу (не из 1С) для сравнения — таким образом будет использована информация из 1С и пользовательские данные. |
Что происходит, если ИИ не уверен в совпадении позиции? |
Как и человек, попробует сформировать гипотезу ответа и предоставить обоснования, если пользователь в явном виде не задал действия / границы размышления модели. |
Можно ли подключить тестовую копию базы? |
Да, можно — механизм описан в п. 1–5. |