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 и нажмите button ellipsis vertical → button sliders vertical Настроить.

  2. Укажите:

    • Название.

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

    • Публичный URL HTTP сервис 1C — вставьте URL опубликованной базы 1C.

    • Тип аутентификации — выберите тип аутентификации, используемый в вашей 1C.

    • Инструкция авторизации — Укажите инструкцию-подсказку по авторизации в коннекторе. Инструкция будет видна пользователям при наведении на иконку информации button info рядом с кнопкой авторизации в коннекторе.

  3. Нажмите Добавить или Добавить и войти в аккаунт, чтобы добавить и одновременно авторизоваться в коннекторе.

3. Авторизация

Для авторизации под единой учетной записью для всех пользователей, авторизуйтесь в разделе button settings Администрирование → button blocks Коннекторы.
Для авторизации под персональной учетной записью и только для себя, авторизуйтесь в разделе button blocks Коннекторы основного меню.
Подробнее про два подхода к авторизации.

Для авторизации:
  1. Откройте коннектор и нажмите Войти в аккаунт.

  2. Укажите:

    • Данные для входа. Они зависят от вашего способа авторизации в 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 на /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.