Настройка модуля 1С и подключение к Contexis

Установка расширения, публикация HTTP-сервиса, регистрация базы в Contexis и проверка интеграции.

Скачать contexis.cfe К установкеРасширение конфигурации

Требования

Что нужно перед началом

Убедитесь, что платформа, конфигурация и инфраструктура соответствуют минимальным требованиям — это сократит время на устранение проблем при подключении.

Платформа

1С:Предприятие 8.3, релиз не ниже 8.3.20
Режим управляемого приложения
Поддержка расширений конфигурации в вашей редакции

Конфигурация

Любая типовая или доработанная конфигурация: УТ, ERP, Бухгалтерия, ЗУП, КА и др.
Права администратора для установки расширения
Возможность обновления конфигурации базы данных

Инфраструктура

Веб-сервер (IIS или Apache) для публикации HTTP-сервиса
Сетевой доступ между Contexis и опубликованной базой
TLS-сертификат при доступе через интернет (рекомендуется)

Установка

Установка расширения Contexis

Расширение добавляет HTTP-сервис и набор инструментов в базу 1С. Основная конфигурация остаётся без изменений.

Скачайте расширение

Загрузите файл contexis.cfe — это расширение конфигурации, которое добавляет HTTP-сервис и каталог инструментов для AI.

Скачать contexis.cfe

Откройте список расширений

Запустите 1С с правами администратора. Перейдите в «Администрирование → Печатные формы, отчёты и обработки → Расширения конфигурации».

Добавьте расширение из файла

Нажмите «Добавить → Из файла на диске…» и выберите contexis.cfe. Укажите имя расширения — например, Contexis.

Активируйте и обновите базу

Установите флажок «Активно», сохраните изменения и выполните «Конфигурация → Обновить конфигурацию базы данных». Основная конфигурация при этом не меняется.

Настройка

Первичная настройка в 1С

После установки расширения проверьте HTTP-сервис и создайте учётную запись для API-интеграции.

Проверьте регистрацию HTTP-сервиса

После установки расширения в конфигураторе откройте «Общие → HTTP-сервисы». Должен появиться сервис Contexis с корневым URL contexis.

Настройте учётную запись для API

Создайте отдельного пользователя 1С для интеграции — например, contexis_api. Назначьте роли с минимально необходимыми правами для выбранных инструментов.

Задайте параметры в расширении

В пользовательском режиме откройте «Администрирование → Contexis» (если доступно в вашей версии расширения). Укажите режим работы и список активных инструментов.

Публикация

Публикация HTTP-сервиса

Contexis подключается к опубликованному HTTP-сервису 1С. Без публикации интеграция работать не будет.

Откройте публикацию на веб-сервере

В конфигураторе: «Администрирование → Публикация на веб-сервере». Выберите существующую публикацию или создайте новую.

Включите HTTP-сервисы

На вкладке «HTTP-сервисы» отметьте сервис Contexis. Убедитесь, что корневой URL совпадает с настройками расширения (contexis).

Опубликуйте базу

Нажмите «Опубликовать». Запишите итоговый URL — он понадобится при добавлении базы в Contexis. Пример: https://1c.company.local/ut/contexis.

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

С машины, где будет работать Contexis, выполните запрос к health-эндпоинту сервиса. Ответ 200 означает, что публикация прошла успешно.

Пример URL health-эндпоинтаGET

https://1c.company.local/ut/hs/contexis/v1/health

Точный URL зависит от имени публикации и виртуального каталога на веб-сервере. Скопируйте его из окна публикации 1С.

Contexis

Подключение базы к Contexis

Зарегистрируйте опубликованную базу в личном кабинете — платформа создаст MCP-сервис и сформирует конфигурацию для AI-клиентов.

Создайте MCP-сервис

В личном кабинете Contexis нажмите «Добавить базу 1С». Укажите URL опубликованного HTTP-сервиса и учётные данные пользователя API.

Дождитесь синхронизации

Contexis автоматически обнаружит доступные инструменты из расширения и сформирует MCP-эндпоинт. Обычно это занимает менее минуты.

Скопируйте конфигурацию

На странице сервиса скопируйте готовый JSON для Claude Desktop, Cursor или другого MCP-клиента. API-ключ генерируется автоматически.

MCP-конфигурация для AI-клиентаJSON

{
  "mcpServers": {
    "contexis-1c-ut": {
      "url": "https://hub.contexis.io/mcp/your-service-id",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Актуальный конфиг и API-ключ доступны на странице MCP-сервиса в личном кабинете. Подробнее о подключении AI-клиентов — в общей документации.

Проверка

Проверка подключения

Пройдите чек-лист перед передачей интеграции команде — это поможет убедиться, что цепочка 1С → Contexis → AI работает корректно.

Чек-лист готовности

✓Статус сервиса в Contexis — «Активен», без ошибок синхронизации
✓Health-эндпоинт HTTP-сервиса отвечает кодом 200
✓MCP-клиент видит список инструментов после перезапуска
✓Тестовый вызов read-only инструмента возвращает данные из базы

Инструменты

Настройка доступных инструментов

Contexis обнаруживает инструменты из расширения автоматически. Включайте только те операции, которые нужны конкретному сценарию.

Read-only для аналитики

Включите только инструменты чтения: остатки, документы, отчёты. Подходит для первого запуска и сценариев анализа данных.

Write для операций

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

Разделение по сервисам

Создайте несколько MCP-сервисов на одну базу с разным набором инструментов — для бухгалтерии, склада, руководства.

Безопасность

Безопасность и права доступа

Рекомендации

Учётные данные 1С хранятся в Contexis и не передаются в LLM
Каждый вызов инструмента проходит через платформу с записью в аудит-лог
API-ключ MCP-сервиса можно отозвать без переустановки расширения
Лимиты запросов настраиваются на уровне сервиса и пользователя
Рекомендуется отдельный пользователь 1С с ограниченными правами

Начните с read-only инструментов и отдельного пользователя API с минимальными правами. Расширяйте набор операций после проверки сценариев.

Безопасность в общей документации

Диагностика

Устранение неполадок

Contexis не может подключиться к базе

Проверьте доступность URL из сети, где размещён Contexis
Убедитесь, что HTTP-сервис опубликован и активен
Проверьте логин и пароль пользователя API
При доступе через интернет — настройте reverse proxy с TLS

Расширение не устанавливается

Проверьте версию платформы — требуется 8.3.20 или выше
Убедитесь, что в конфигурации включена поддержка расширений
Обновите конфигурацию базы данных после активации расширения
Проверьте, что нет конфликта с другим расширением на том же HTTP-сервисе

MCP-клиент не видит инструменты

Перезапустите AI-клиент после изменения конфигурации
Проверьте, что MCP-сервис активен в личном кабинете
Убедитесь, что API-ключ не отозван и не истёк
Проверьте формат JSON-конфигурации — url и headers должны совпадать с кабинетом

Инструмент возвращает ошибку прав доступа

Проверьте роли пользователя contexis_api в 1С
Убедитесь, что инструмент включён в настройках расширения
Для write-операций — проверьте права на создание и проведение документов

FAQ

Частые вопросы по модулю 1С

Нужно ли снимать расширение с поддержки при обновлении конфигурации?

Нет. Расширение Contexis не изменяет основную конфигурацию. Типовые обновления проходят штатно — расширение остаётся активным.

Можно ли установить расширение в несколько баз?

Да. Скачайте contexis.cfe один раз и установите в каждую базу отдельно. В Contexis создайте отдельный MCP-сервис для каждой публикации.

Работает ли модуль в файловой базе?

Да, если база опубликована на веб-сервере с включёнными HTTP-сервисами. Для production рекомендуется серверный вариант 1С.

Как обновить расширение до новой версии?

Скачайте новый contexis.cfe, в списке расширений выберите Contexis → «Загрузить из файла» → обновите конфигурацию базы данных. MCP-сервис в Contexis обновит инструменты автоматически.

Что делать, если база за NAT или VPN?

Contexis должен иметь сетевой доступ к URL публикации. Используйте VPN-туннель, reverse proxy или разместите Contexis в той же сети, что и сервер 1С.

Нужна помощь с настройкой?

Напишите нам — поможем с установкой расширения, публикацией базы и первым MCP-сервисом.

Связаться