AI-клиенты

Contexis поддерживает стандарт Model Context Protocol (MCP). После создания MCP-сервиса подключите его к любому совместимому клиенту — один сервис, несколько интерфейсов параллельно.

Обзор «кому какой клиент» и примеры запросов — на странице AI-клиенты в разделе Решения.

Конфигурация из личного кабинета

Откройте карточку MCP-сервиса в app.contexis.ru. На странице сервиса — JSON для AI-клиента: URL эндпоинта и ключ авторизации. Скопируйте блок целиком или отдельные поля.

Страница MCP-сервиса: URL подключения и готовый JSON для вставки в AI-клиент

На списке подключений видно статус синхронизации и количество вызовов. Перед настройкой клиента убедитесь, что сервис «Включено» и инструменты подтянулись без ошибок.

Список подключений: статус «Включено», синхронизация и количество вызовов на карточке
Пример структуры конфигурацииJSON
{
  "mcpServers": {
    "contexis-1c": {
      "url": "https://hub.contexis.io/mcp/your-service-id",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Реальные значения URL и ключа — только в вашем кабинете. Подробнее о полях конфигурации — в разделе MCP-сервис.

Общий порядок подключения

  1. Завершите настройку 1С и создайте MCP-сервис в кабинете — см. быстрый старт и подключение к Contexis.
  2. Откройте карточку MCP-сервиса и скопируйте JSON или URL с ключом — см. блок выше.
  3. Добавьте сервер Contexis в раздел MCP выбранного AI-клиента.
  4. Перезапустите клиент, если этого требует его документация.
  5. Проверьте вызов инструмента типовым вопросом по вашим данным 1С.

Учётные данные API 1С остаются в Contexis и не передаются в LLM. Пароль MCP-сервиса храните как секрет — не коммитьте конфиг в репозиторий и не отправляйте в чаты.

По клиентам

Claude Desktop и Cursor

Аналитики, разработчики, power users

Где настраивать: Claude: Settings → Developer → MCP. Cursor: Settings → MCP или файл конфигурации проекта.

Вставьте JSON из карточки MCP-сервиса или укажите SSE URL и заголовок Authorization.

ChatGPT и agent-платформы

Команды в экосистеме OpenAI и совместимых agent-решений с MCP

Где настраивать: Раздел MCP / Connectors в настройках вашего клиента — по документации поставщика.

Contexis отдаёт стандартный MCP-сервис; формат добавления зависит от версии клиента.

Open WebUI

Сотрудники без IDE — корпоративный чат в браузере на своих серверах

Где настраивать: Admin → Settings → Connections → MCP: добавьте URL и ключ из кабинета Contexis.

Open WebUI подключается к Contexis по сети; прямой доступ к серверу 1С не нужен.

OpenCode

IT и автоматизация — терминальный агент рядом с кодом

Где настраивать: Конфигурация MCP в настройках OpenCode (см. документацию OpenCode для формата JSON).

Используйте отдельный MCP-сервис с минимальным toolset для prod-баз.

Manus и autonomous-агенты

Сценарии с цепочкой действий и внешними инструментами

Где настраивать: Добавьте MCP Contexis как external tools server по инструкции платформы агента.

Начните с read-only инструментов на копии базы; масштабируйте после audit.

Частые проблемы

Если инструменты из 1С не появляются в клиенте:

  • Перезапустите AI-клиент после добавления конфигурации.
  • Проверьте ключ авторизации и URL — скопируйте заново из кабинета.
  • Убедитесь, что MCP-сервис синхронизирован (нет ошибок в журнале Contexis).
  • Исключите блокировку исходящих запросов к Contexis (firewall, proxy, VPN).
  • Сверьте включённые инструменты в toolset — клиент видит только разрешённый набор.

Диагностика 1С и публикации — в разделе устранение неполадок.