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С без выполнения.

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

Подключение интеграции 1C зависит от наличия у вас MCP-сервера:
  • Если у вас нет собственного MCP-сервера — добавьте предустановленную интеграцию.

    При таком подключении возможна работа только к одной базой 1C.
  • Если у вас есть собственный MCP-сервер — создайте собственные MCP-интеграции (подробнее), а включите их.

    При таком подключении необходимо создать по интеграции на каждую базу 1C.
Пример подключения и авторизации в MCP-интеграции 1C

Добавление предустановленной интеграции

В одной предустановленной интеграции возможна работа только с одной базой 1C.

1. Подготовка

1. Подключите расширение в базу

Для этого.
  1. Подключите расширение через «Управление расширениями конфигурации» в Предприятии или в Конфигураторе.

  2. Расширение — в файле mcp_dev.cfe (Чтобы скачать файл, откройте интеграцию 1C в разделе button settings Администрирование → Интеграции, нажмите button ellipsis vertical → Настроить, а затем Скачать файл расширения и инструкцию).

  3. Перезапустите сеанс, чтобы расширение применилось.

2. Опубликуйте HTTP-сервис

Требуется установленный веб-сервер. Если его ещё нет — смотри ниже главу установка веб-сервера Apache 2.4.

Запускайте Конфигуратор от имени администратора.
Для этого:
  1. Зайдите в Администрирование → Публикация на веб-сервере.

  2. Задайте имя публикации (оно станет именем базы в URL) и каталог публикации.

  3. На вкладке HTTP-сервисы включите флаг «Публиковать HTTP-сервисы расширений по умолчанию» (выбрать конкретный сервис расширения нельзя).

  4. Опубликовать.

3. Проверьте работоспособность

Откройте в браузере (подставьте сервер и имя базы):

http://[сервер]/[база]/hs/mcp/health

После ввода логина/пароля 1С должен вернуться {"status": "ok"}.

Дополнительно: установка веб-сервера Apache 2.4

Для этого:
  1. Скачайте дистрибутив: https://www.apachelounge.com/download/

  2. Распакуйте (например, в C:\Apache24).

  3. Зарегистрируйте службу — в папке Apache24\bin от имени администратора:

    httpd.exe -k install
  4. Запустите службу (в оснастке services.msc или httpd.exe -k start).

2. Добавление

Если вы сделали все подготовительные действия, можете приступать к подключению предустановленной интеграции 1C.

Для добавления интеграции:
  1. В разделе button settings Администрирование → Интеграции нажмите Добавить интеграцию, затем в витрине интеграций нажмите на интеграцию 1C — откроется мастер добавления интеграции, где пошагово потребуется указать ее данные.

  2. Шаг Основная информация — укажите Название и Описание. В описании коротко опишите возможности и инструменты интеграции, какие основные задачи она решает. По этим ключевым фразам ИИ-агент будет понимать, что необходимо подключить данную интеграцию. Например, Добавь событие в календарь — для интеграции календаря. Описание отображается в карточке интеграции.

  3. Шаг Настройки интеграции — укажите Адрес базы 1C(URL опубликованной базы 1C).

  4. Шаг Настройка авторизации — настройте авторизацию.

    • Тип аутентификации — способ авторизации.

      • Логин и пароль— пользователь указывает логин и пароль.

      • Токен доступа — пользователь указывает токен доступа.

    • Способ авторизации.

      • Индивидуальный — каждый пользователь авторизуется в интеграции с собственной учетной записью.

      • Общий — администратор авторизуется в интеграции, и она становится доступна всем пользователям под его учетной записью.

  5. Шаг Проверка данных — проверьте данные подключаемой интеграции.

3. Включение интеграции

После добавления интеграцию необходимо включить.

Для включения интеграции, в разделе button settings Администрирование → button blocks Интеграции:
  1. Выберите фильтр Доступные — отобразятся доступные для добавления интеграции.

  2. На карточке интеграции выберите:

    • button ellipsis vertical → button power Включить — чтобы включить интеграцию. Если выбран общий тип авторизации, то система предложит авторизоваться в интеграции.

Типовые проблемы при подключении 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 на /hs/mcp/health

Перепубликовать базу от имени администратора, проверить имя публикации

Доступ только по HTTP, нет HTTPS

Не настроен SSL-сертификат

URL начинается с http://

Получить и установить SSL-сертификат, настроить HTTPS в веб-сервере

Проблемы с доступом из интернета

Проблема Причина Как диагностировать Решение

URL недоступен извне

Сервер в локальной сети без проброса портов

curl http://[сервер]/[база]/hs/mcp/health работает только внутри сети

Настроить проброс портов на роутере или reverse proxy (nginx/Apache)

Нет статического IP

Динамический IP у сервера

IP меняется после перезагрузки

Заказать статический IP у провайдера или использовать DynDNS

Блокировка фаерволом

Порт 80/443 закрыт

telnet [сервер] 80 не подключается

Открыть порт в фаерволе Windows/iptables

1С:Фреш (SaaS)

Платформа не позволяет публиковать свои HTTP-сервисы на внешнем веб-сервере

—

Уточнить у провайдера 1С:Фреш наличие API для интеграции; рассмотреть переезд на self-hosted

1С:Линк

Доступ только через прокси 1С

База размещена на 1С:Линк

Использовать API 1С:Линк или запросить публикацию через поддержку

Проблемы с расширением MCP-сервера

Проблема Причина Как диагностировать Решение

Расширение не подключается

Файл .cfe повреждён или несовместим

Ошибка при подключении в Конфигураторе

Скачать актуальную версию расширения, проверить совместимость

HTTP-сервис не появляется после подключения

Расширение не активировано, нет прав

В списке HTTP-сервисов нет mcp

Перезапустить 1С, проверить права пользователя на расширение

Ошибка авторизации в HTTP-сервисе

Неверный логин/пароль, нет прав у пользователя

Браузер запрашивает пароль, затем возвращает 401/403

Создать отдельного пользователя 1С с правами на HTTP-сервис

{"status": "error"} вместо {"status": "ok"}

Ошибка внутри расширения

Логи 1С, журнал регистрации

Включить логирование в расширении, проверить логи

Часто задаваемые вопросы по интеграции 1С

Вопрос Ответ

С какими конкретно конфигурациями 1С работает интеграция?

Интеграция к 1С унифицированная, работает с различными конфигурациями. Рекомендуемые версии, с которыми работает интеграция — 8.3.6+ (в более ранних версиях нет вкладки «HTTP-сервисы» при публикации и нет пункта «Расширения конфигурации»).

Работает ли она с доработанными конфигурациями?

Интеграция к 1С унифицированная, работает с различными конфигурациями, включая доработки. Интеграция работает с базой 1С по запросу к ней через разработанные инструменты интеграции (файл расширения необходимо установить по предоставляемой инструкции).

Нужна ли публикация базы 1С наружу?

В виде поставки SaaS необходима публикация базы наружу — к базе должен быть выход в интернет, либо прописаны белые IP-адреса до Cowork.

Настройка в 1С (подробнее в предоставляемой инструкции):
  1. Подключите расширение mcp_dev.cfe и перезапустите 1С.

  2. Убедитесь, что установлен веб-сервер (при необходимости установите Apache 2.4).

  3. Запустите Конфигуратор 1С от имени администратора.

  4. Опубликуйте базу с опцией «Публиковать HTTP-сервисы расширений по умолчанию».

  5. Проверьте доступность по URL.

Настройка в Cowork:
  1. Введите полученный URL в поле «Публичный URL HTTP-сервиса 1С».

Через что идёт подключение: 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.