Документация Engee

Подключение

Доступно по запросу для корпоративных клиентов.

Для работы нужны учетная запись Engee, агентный клиент с поддержкой MCP и языковая модель (Large Language Model, LLM), способная вызывать инструменты. Облачному клиенту нужен доступ к серверу Engee из своей инфраструктуры; локальному — с компьютера, где работает клиент.

Интерфейс клиента. Клиенты LLM постоянно развиваются и изменяются, поэтому названия разделов, кнопок и полей в этой инструкции могут отличаться от текущего интерфейса. За уточнениями по интеграции обратитесь в техническую поддержку Engee; по настройкам самого клиента — в поддержку его разработчика.

Для доступа к рабочей среде передайте токен личного доступа (Personal Access Token, PAT) в чат с агентом. Порядок выпуска PAT описан в документации внешнего API Engee.

Параметры подключения

Поле Значение

Отображаемое имя

Engee MIND

URL MCP-сервера

Напишите на engee@engee.com, чтобы уточнить режим доступа для Вашей организации

Транспорт

Streamable HTTP

Авторизация при подключении MCP

Без авторизации / No Authentication

Доступ к рабочей среде пользователя

PAT Engee в параметре token вызова инструмента

Авторизация подключения MCP и доступ к пользовательской среде — разные этапы. Клиент может получить перечень инструментов без PAT. Для операций с рабочей средой агент передает PAT в аргументах инструментов. В приведенных конфигурациях не нужно добавлять PAT в URL или заголовок Authorization.

Создание PAT

  1. Сохраните рабочие файлы и остановите сессию Engee перед выпуском токена. PAT, созданный при работающей сессии, начнет действовать только после ее остановки и нового запуска.

  2. Откройте личный кабинет Engee и перейдите в Связь и безопасность → Токены личного доступа.

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

  4. Нажмите Добавить токен личного доступа и скопируйте значение полностью, включая специальные символы. Повторно посмотреть его не получится.

  5. Запустите Engee после создания токена либо поручите запуск агенту.

Для первой проверки отправьте PAT в чат с агентом. Не помещайте PAT в публичные файлы, общие конфигурации или публикуемые отчеты. Отозвать его можно в разделе токенов личного кабинета Engee.

Выбор клиента

Клиент Способ настройки

ChatGPT, Codex

Приложение в ChatGPT; MCP-настройки или TOML в Codex

Claude.ai, Claude Code

Пользовательский коннектор; CLI или .mcp.json

Grok

Пользовательский MCP-коннектор

Yandex AI Studio

Внешний MCP-сервер в MCP Hub

Giga Cowork

Параметры внешнего коннектора; особенности конкретной поставки

OpenCode

opencode.json

llama.cpp

MCP в llama-ui либо stdio-мост для llama-server

Ollama

Локальная модель и MCP в OpenCode

LM Studio (Bionic)

mcp.json в LM Studio; отдельные особенности Bionic

Первый сеанс

После настройки выберите Engee MIND в текущем чате и отправьте:

Используй Engee MIND. Вызови engee_status, покажи состояние среды и доступные навыки. Пока не изменяй модели и файлы.

Без PAT ожидается инструкция по авторизации, а не состояние вашей среды. После передачи PAT ожидается фактический статус. Для запуска остановленной среды отправьте:

Запусти мою рабочую среду Engee, если она остановлена, и загрузи навык engee_model. Сообщи, когда среда будет готова.

Обычно запуск занимает десятки секунд; холодный запуск с подготовкой библиотеки может занять больше времени. Проверка считается успешной, когда видны реальные вызовы инструментов, получен статус среды и загружен навык. Текстовый ответ агента без вызовов инструментов не является проверкой подключения.

Типовые проблемы

Проблема Что проверить

Failed to list tools, HTTP 405/412

URL и транспорт: нужен Streamable HTTP, а не устаревший HTTP with SSE

Инструменты есть, операции с Engee отклоняются

PAT, разрешение «Доступ к API Engee», полноту значения, наличие token в вызове и запуск сессии после выпуска PAT

Агент только описывает действия

Подключен ли сервер к текущему чату, разрешены ли инструменты, поддерживает ли LLM tool calling

Вызов прерывается при старте среды

Тайм-аут выполнения инструмента в клиенте; он отличается от тайм-аута обнаружения инструментов

После простоя модель не найдена

Среда могла остановиться; запустите ее и загрузите ранее сохраненный .engee

Файл создан, но не появился в чате

Агент должен вызвать file_download для файла в сессии

Формат конфигурации зависит от клиента: универсального JSON для всех приложений нет. При добавлении в существующую конфигурацию объединяйте соответствующие секции, сохраняя другие серверы и параметры.