> For the complete documentation index, see [llms.txt](https://docs.onerpa.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onerpa.ru/mcp-servery-1c/prilozhenia/peremennye-okruzheniya.md). # Переменные окружения Сводная таблица переменных окружения для всех MCP-серверов. ## Общие переменные Эти переменные используются большинством серверов: | Переменная | Описание | Обязательная | По умолчанию | | ---------------- | -------------------------------------------------------------------------------------- | ------------ | -------------------------------------------- | | `LICENSE_KEY` | Лицензионный ключ | Да | — | | `RESET_DATABASE` | Переиндексировать данные | Нет | `true` / `false` (зависит от сервера) | | `RESET_CACHE` | Очистить кэш моделей при старте | Нет | `false` (в HelpSearchServer, SSL, Templates) | | `USESSE` | Включить SSE-транспорт для legacy-клиентов. При `false` используется `streamable-http` | Нет | `false` | ## Переменные дистрибутива Эти значения читаются установочным дистрибутивом из `config.env` и не передаются контейнеру под тем же именем: | Переменная | Описание | По умолчанию | | --------------------------- | -------------------------------------------------- | ------------ | | `RELEASE_CHANNEL` | Канал `stable` или `beta` | `stable` | | `IMAGE_VARIANT` | Базовый вариант: `latest`, `light` или `arm64` | `latest` | | `IMAGE_TAG` | Явный тег; если задан, перекрывает канал и вариант | *(пусто)* | | `LICENSE_KEY_<СЕРВЕР>` | Ключ stable-канала | — | | `LICENSE_KEY_<СЕРВЕР>_BETA` | Ключ beta-канала | — | Доступные комбинации различаются по серверам. См. [Каналы образов: stable и beta](/mcp-servery-1c/kanaly-obrazov.md). ## Embedding модели (LM Studio / Ollama / OpenRouter) | Переменная | Описание | Пример | | ---------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------- | | `EMBEDDING_API_BASE` | Полный OpenAI-совместимый base URL, **включая `/v1`**; суффикс автоматически не добавляется | `http://host.docker.internal:1234/v1` | | `EMBEDDING_API_KEY` | Ключ API | `lm-studio` | | `EMBEDDING_MODEL` | Модель embedding для API или локального режима | `Qwen3-Embedding-4B` | | `EMBEDDING_DIMENSIONS` | Явное указание размерности эмбеддингов (для моделей с переменной размерностью) | *(авто)* | ## Embedding модели (CPU) | Переменная | Описание | Пример | | ----------------- | --------------------- | ------------------------------- | | `EMBEDDING_MODEL` | Модель с Hugging Face | `intfloat/multilingual-e5-base` | {% hint style="info" %} Если задан `EMBEDDING_API_BASE` или используется light-образ, сервер обращается к внешнему API. Старые `OPENAI_API_BASE`, `OPENAI_API_KEY` и `OPENAI_MODEL` поддерживаются HelpSearchServer, CodeMetadataSearchServer, SSLSearchServer и TemplatesSearchServer как совместимые алиасы. CloudEmbeddingsServer по-прежнему использует provider-specific ключи (`OPENAI_API_KEY`, `OPENROUTER_API_KEY`, `COHERE_API_KEY`, `JINA_API_KEY`). {% endhint %} ## Настройки индексации Эти переменные управляют процессом индексации и доступны в серверах, где указано: | Переменная | Описание | По умолчанию | Серверы | | ------------------------ | --------------------------------------------------------------- | ------------- | ------------ | | `INDEX_BATCH_SIZE` | Размер пакета при добавлении в векторное хранилище | `512` | Graph | | `MAX_TOKENS_PER_BATCH` | Максимум токенов в одном пакете API | `28000` | Graph | | `EMBEDDING_MAX_TOKENS` | Максимум токенов на текст для эмбеддингов | *(авто)* | Graph | | `REINDEX_INTERVAL_SEC` | Интервал автоматической инкрементальной индексации (секунды) | `7200` | CodeMetadata | | `REINDEX_INTERVAL_HOURS` | Алиас интервала в часах; `REINDEX_INTERVAL_SEC` имеет приоритет | *(не задано)* | CodeMetadata | | `ENABLE_RERANKER` | Нейронный реранкер (cross-encoder) | `false` | CodeMetadata | | `RERANKER_MODEL` | Модель реранкера | *(авто)* | CodeMetadata | | `RERANKER_TOP_K` | Макс. кандидатов для реранкера | `20` | CodeMetadata | ## Переменные по серверам ### HelpSearchServer (порт 8003) | Переменная | Описание | По умолчанию | | -------------------------------------- | ------------------------------------------------------------------------------------------ | ------------------------------------- | | `LICENSE_KEY` | Лицензионный ключ | Обязательно | | `1C_BIN_PATH` | Смонтированный каталог с `shcntx_ru.hbk`; не задан — берётся архив из образа | *(не задано)* | | `EMBEDDING_API_BASE` | URL OpenAI-совместимого API, включая `/v1` | `http://host.docker.internal:1234/v1` | | `EMBEDDING_API_KEY` | Ключ API эмбеддингов | `lm-studio` | | `EMBEDDING_MODEL` | Модель API или локальная модель | `intfloat/multilingual-e5-small` | | `HF_HOME` | Каталог кэша модели | `/app/model_cache` | | `HF_HUB_OFFLINE` | Запрет загрузок при старте; `0` разрешает докачку | `1` | | `RESET_CACHE` | Очистить кэш моделей при старте | `false` | | `RESET_DATABASE` | Разрешить разрушающие операции и очистить индекс | `false` | | `INDEX_RETAIN_GENERATIONS` | Сколько прошлых поколений индекса хранить | `1` | | `INDEXING_WORKERS` | Потоки индексации | `5` | | `INDEXING_BATCH_SIZE` | Строк в одной записи при индексации | `100` | | `USESSE` | SSE-транспорт вместо streamable-http | `false` | | `MCP_SESSION_IDLE_TTL_SECONDS` | Простой сессии Streamable HTTP до уборки | `1800` | | `MCP_SESSION_MAX_LIFETIME_SECONDS` | Максимальное время жизни сессии | `86400` | | `MCP_SESSION_CAP` | Максимум одновременных stateful-сессий | `1000` | | `MCP_SESSION_CLEANUP_INTERVAL_SECONDS` | Интервал уборки сессий | `60` | | `PLUGIN_DIR` | Каталог Python-плагинов | `/app/plugins` | | `PLUGIN_STRICT_DERIVED_STATE` | Ронять сборку индекса при ошибке hook `on_document` | `false` | | `RELEVANCE_MAX_VECTOR_DISTANCE` | Максимальная cosine-distance векторной дорожки | `0.35` | | `RELEVANCE_MAX_LEXICAL_RANK` | Максимальный допустимый ранг лексического кандидата; отдельный score-порог не используется | `2` | | `LEXICAL_PROFILE` | Токенизация лексической дорожки; смена вызывает переиндексацию | `stemmed` | {% hint style="warning" %} В новых beta-сборках индекс HelpSearchServer лежит в `/app/index` (поколения zvec); stable продолжает использовать `/app/chroma_db`. Не подключайте один каталог к обоим каналам. Полный список параметров: [Конфигурация HelpSearchServer](/mcp-servery-1c/servery/help-search-server/konfiguraciya.md). {% endhint %} ### CodeMetadataSearchServer (порт 8000) | Переменная | Описание | По умолчанию | | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- | | `LICENSE_KEY` | Лицензионный ключ | Обязательно | | `LICENSE_KEY_FILE` | Путь к файлу с лицензионным ключом; предпочтительнее `LICENSE_KEY`, значение ключа не попадает в окружение процесса | *(не задано)* | | `LICENSE_KEY_FILE_CONSUME` | Удалить файл ключа сразу после чтения | `false` | | `METADATA_PATH` | Путь к метаданным | `/app/metadata` | | `CODE_PATH` | Путь к коду | `/app/code` | | `MCP_HOST` | Хост для привязки сервера | `0.0.0.0` | | `MCP_PORT` | Порт сервера | `8000` | | `MCP_PATH` | Путь MCP-эндпоинта | `/mcp` | | `FASTMCP_STATELESS_HTTP` | Stateless-режим HTTP | `true` | | `MCP_SESSION_IDLE_TTL_SEC` | Таймаут простоя MCP-сессии | `1800` | | `MCP_SESSION_MAX_LIFETIME_SEC` | Максимальное время жизни MCP-сессии | `86400` | | `MCP_SESSION_MAX_CONCURRENT` | Максимум одновременных MCP-сессий | `64` | | `MCP_SESSION_CLEANUP_INTERVAL_SEC` | Интервал очистки сессий | `60` | | `MCP_SESSION_BOUNDS_MODE` | Применять лимиты (`enforce`) или только сообщать (`report`) | `enforce` | | `MCP_IMAGE_REF` | Неизменяемая ссылка на образ с digest для release identity | *(не задано)* | | `VECTOR_DB_PATH` | Путь к директории векторного хранилища zvec | `/app/chroma_db` | | `CHROMA_DB_PATH` | Устаревший совместимый алиас `VECTOR_DB_PATH` | `/app/chroma_db` | | `EMBEDDING_API_BASE` | URL OpenAI-совместимого API эмбеддингов | — | | `EMBEDDING_API_KEY` | Ключ API эмбеддингов | — | | `EMBEDDING_MODEL` | Модель API или локальная модель | `sentence-transformers/paraphrase-multilingual-mpnet-base-v2` | | `RESET_DATABASE` | Переиндексировать | `false` | | `BACKGROUND_INDEXING` | Индексировать в фоне, не блокируя запуск MCP | `true` | | `INCREMENTAL_INDEXING` | Обновлять только изменившиеся файлы по SHA-256 | `true` | | `INDEX_NESTED_CONFIGURATIONS` | Индексировать вложенные конфигурации поставщика отдельными источниками | `false` | | `PROJECT_ID` | Явное закрепление идентификатора проекта индекса | *(выводится из путей)* | | `GENERATION_RETENTION_COUNT` | Сколько поколений индекса хранить | `2` | | `SUB_INDEX_INTEGRITY_GATE` | Режим проверки целостности вспомогательных индексов: `auto`, `blocking`, `report_only`, `off` | `auto` | | `LIVE_XML_FALLBACK` | Дочитывать XML-выгрузку, когда индекс не содержит факта | `true` | | `NESTED_CONFIGURATION_PATHS` | Каталоги-контейнеры вложенных конфигураций через запятую | `Ext/ParentConfigurations` | | `INDEX_EXTENSIONS` | Индексировать найденные расширения конфигурации; обнаружение не отключается | `true` | | `EXTENSION_PATHS` | Явные корни расширений через запятую (абсолютные или относительно `CODE_PATH`) | *(не задано)* | | `EXTENSION_DISCOVERY_DEPTH` | Сколько уровней выше `CODE_PATH` просматривать при поиске соседних расширений; `0` — не искать | `1` | | `EXTENSION_EXCLUDE` | Идентификаторы или имена расширений через запятую, которые не индексируются | *(не задано)* | | `RESPONSE_MAX_CHARS` | Предел размера ответа в символах по умолчанию (сервер ограничивает диапазоном 2048–262144) | `0` *(без предела)* | | `RESPONSE_MAX_ITEMS` | Максимум элементов на странице по умолчанию (потолок сервера — `500`) | `0` *(без предела)* | | `RESPONSE_DETAIL_LEVEL` | Уровень детализации по умолчанию: `outline` или `full` | `full` | | `REINDEX_INTERVAL_SEC` | Интервал автоматической индексации (секунды) | `7200` | | `REINDEX_INTERVAL_HOURS` | Алиас интервала в часах | *(не задано)* | | `BM25_ALPHA` | Вес семантического поиска (0–1) | `0.5` | | `OVERFETCH_MULTIPLIER` | Множитель выборки для запросов по пути/идентификатору | `4` | | `SEMANTIC_OVERFETCH_MULTIPLIER` | Множитель выборки для семантических запросов | `6` | | `MIN_SCORE_THRESHOLD` | Минимальный порог оценки результата (0–1) | `0.15` | | `EMBEDDING_CACHE_SIZE` | Размер LRU-кэша эмбеддингов запросов | `256` | | `EMBEDDING_DIMENSIONS` | Размерность эмбеддингов | *(авто)* | | `ENABLE_RERANKER` | Включить нейронный реранкер (cross-encoder) | `false` | | `RERANKER_MODEL` | Модель реранкера | *(авто)* | | `RERANKER_TOP_K` | Макс. кандидатов для реранкера | `20` | | `EMBEDDING_PROVIDER` | Явный выбор `remote` или `local` | *(авто)* | | `EMBEDDING_PROVIDER_AMBIGUITY` | Политика неоднозначной legacy-конфигурации | `error` | | `EMBEDDING_MEMORY_BUDGET_MB` | Бюджет памяти локальной embedding-модели | `4096` | | `EMBEDDING_MEMORY_BUDGET_MODE` | `refuse`, `warn` или `off` | `refuse` | | `VECTOR_PROFILE` | Профиль zvec: `fast_index`, `balanced`, `memory_saver`, `quality` | `fast_index` | | `VECTOR_OPTIMIZE_ENABLED` | Разрешить оптимизацию zvec | `true` | | `VECTOR_OPTIMIZE_DEADLINE_SEC` | Таймаут фоновой оптимизации | `1800` | | `VECTOR_OPTIMIZE_CANCEL_DEADLINE_SEC` | Таймаут оптимизации из запроса | `5` | | `VECTOR_WRITE_FAILURE_THRESHOLD` | Ошибки записи до терминального состояния | `5` | | `GREP_MAX_RESULTS` | Максимум результатов fallback-сканирования | `50` | | `GREP_FILE_CACHE_SIZE` | Размер LRU-кэша прочитанных файлов | `500` | | `GREP_BROAD_DIR_THRESHOLD` | Максимальная ширина дерева fallback-сканирования | `10000` | | `GREP_DEADLINE_SEC` | Общий бюджет одного fallback-сканирования, секунды; `0` отключает | `10` | | `GREP_MAX_CACHED_FILE_MB` | Файлы крупнее читаются, но не кэшируются | `8` | | `MCP_TOOL_WORKERS` | Потоки для тел MCP-инструментов, чтобы долгий поиск не блокировал event loop | `4` | | `PLUGIN_DIR` | Каталог Python-плагинов; читается при каждом старте, флага включения нет | `/app/plugins` | | `PLUGIN_STRICT_DERIVED_STATE` | Ронять сборку целиком при ошибке derived-state hook (`on_source_file`, `on_chunk`, `on_metadata_object`) вместо пропуска единицы | `false` | | `PLUGIN_HOOK_TIMEOUT_SECONDS` | Бюджет времени одного вызова hook; превысивший его hook считается упавшим | `5.0` | {% hint style="warning" %} `GREP_DEADLINE_SEC`, `GREP_MAX_CACHED_FILE_MB` и `MCP_TOOL_WORKERS` относятся к текущему beta-кандидату CodeMetadataSearchServer. В stable и ранее опубликованных beta-тегах их может ещё не быть. {% endhint %} ### CloudEmbeddingsServer (порт 8000 по умолчанию) | Переменная | Описание | По умолчанию | | ----------------------- | ------------------------------------------------------------------ | ---------------------------- | | `LICENSE_KEY` | Лицензионный ключ | Обязательно | | `USESSE` | Включить SSE-транспорт. При `false` используется `streamable-http` | `false` | | `EMBEDDING_PROVIDER` | Провайдер embedding | `openai` | | `OPENAI_API_KEY` | Ключ OpenAI-совместимого API | Обязательно для cloud-режима | | `OPENROUTER_API_KEY` | Ключ OpenRouter | — | | `COHERE_API_KEY` | Ключ Cohere | — | | `JINA_API_KEY` | Ключ Jina | — | | `OPENAI_API_BASE` | URL OpenAI-совместимого API | — | | `EMBEDDING_MODEL` | Явное имя модели провайдера | *(по умолчанию провайдера)* | | `SOURCE_PATH` | Каталог исходных данных для индексации | `/data/source` | | `CHROMA_PATH` | Каталог векторной БД | `/data/chroma_db` | | `HOST` | Адрес привязки приложения | `0.0.0.0` | | `PORT` | Внутренний порт приложения | `8000` | | `AUTO_INDEX` | Индексировать каталог при запуске | `true` | | `CHUNK_SIZE` | Размер чанка | `1000` | | `CHUNK_OVERLAP` | Перекрытие чанков | `100` | | `MAX_BATCH_SIZE` | Максимальный размер пакета индексации | `100` | | `DEFAULT_SEARCH_LIMIT` | Количество результатов поиска по умолчанию | `10` | | `EMBEDDING_CONCURRENCY` | Количество параллельных embedding-запросов | `1` | | `EMBEDDING_BATCH_SIZE` | Размер пакета embedding-запроса | `10` | ### SSLSearchServer (порт 8008) | Переменная | Описание | По умолчанию | | ------------------------------------- | ------------------------------------------------------------------------------------ | -------------------------------- | | `LICENSE_KEY` | Лицензионный ключ | Обязательно | | `SSL_VERSION` | Версия БСП | Обязательно | | `RESET_DATABASE` | Переиндексировать | `false` | | `EMBEDDING_API_BASE` | URL OpenAI-совместимого API эмбеддингов | — | | `EMBEDDING_API_KEY` | Ключ API эмбеддингов | — | | `EMBEDDING_MODEL` | Модель API или локальная модель | `intfloat/multilingual-e5-small` | | `INDEXING_THREADS` | Потоки индексации | `5` | | `MIGRATE_VECTOR_STORE` | Выполнить миграцию векторного хранилища на этом старте | `false` | | `DEMOTE_VECTOR_STORE` | Вернуть обслуживание предыдущему поколению | `false` | | `EMBEDDING_DIMENSIONS` | Размерность эмбеддингов | *(авто)* | | `EMBEDDING_INPUT_TYPE_ENABLED` | Различение query/document для эмбеддингов | `true` | | `FORCE_REINDEX_ON_DIMENSION_MISMATCH` | Автопересоздание при несовпадении размерности; иначе старт останавливается с ошибкой | `false` | | `MIN_SCORE` | Порог cosine similarity для результатов `ssl_search` | `0.3826` | | `EXACT_LOOKUP` | Точный поиск по имени символа перед семантическим (`lane=exact`) | `true` | | `HYBRID_SEARCH` | Гибридное извлечение: векторная + полнотекстовая (BM25) дорожки с RRF | `true` | | `MAX_RESPONSE_CHARS` | Бюджет длины ответа `ssl_search` в символах (минимум 1024) | `4000` | | `MAX_QUERY_CHARS` | Максимальная длина запроса до и после plugin/alias rewrite; минимум 256 | `2048` | | `MAX_GUARDED_SEARCHES` | Максимум поисков внутри deadline guard | `64` | | `SHUTDOWN_GRACE_SECONDS` | Бюджет корректного завершения контейнера, секунды | `10` | | `SHUTDOWN_FLUSH_SECONDS` | Часть бюджета на сброс векторного хранилища, секунды | `5` | | `LOG_QUERIES` | Записывать полный текст поисковых запросов вместо длины и хеша | `false` | | `LOG_DIR` | Каталог файла журнала; относительный путь от корня приложения | `/logs` | | `SESSION_IDLE_TTL` | Время простоя HTTP-сессии до освобождения, секунды | `900` | | `SESSION_MAX_LIFETIME` | Максимальное время жизни HTTP-сессии, секунды | `14400` | | `SESSION_MAX_CONCURRENT` | Максимум одновременных HTTP-сессий | `128` | | `SESSION_CLEANUP_INTERVAL` | Интервал очистки просроченных сессий, секунды | `30` | | `PLUGIN_DIR` | Каталог Python-плагинов | `/app/plugins` | | `PLUGIN_STRICT_DERIVED_STATE` | Останавливать индексацию при ошибке derived-state hook | `false` | ### Graph Metadata Search (порт 8006) | Переменная | Описание | По умолчанию | | --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | | `LICENSE_KEY` | Лицензионный ключ | Обязательно | | `NEO4J_URI` | URI Neo4j | `bolt://neo4j:7687` | | `NEO4J_USERNAME` | Пользователь | `neo4j` | | `NEO4J_PASSWORD` | Пароль | Обязательно | | `METADATA_DIRECTORY` | Путь к метаданным | `/app/metadata` | | `NEO4J_DATABASE` | Имя базы Neo4j | `neo4j` | | `PROJECT_NAME` | Название проекта | `1C Metadata Project` | | `RESET_DATABASE` | Переиндексировать при запуске | `false` | | `INDEX_BATCH_SIZE` | Размер пакета индексации | `512` | | `MAX_TOKENS_PER_BATCH` | Макс. токенов на пакет API | `28000` | | `EMBEDDING_REQUEST_CONCURRENCY` | Параллельные запросы к API эмбеддингов | `6` | | `OPENAI_EMBEDDING_DIMENSIONS` | Размерность эмбеддингов | *(авто)* | | `EMBEDDING_API_BASE` | URL API эмбеддингов | — | | `EMBEDDING_API_KEY` | Ключ API эмбеддингов | — | | `EMBEDDING_MODEL` | Модель API эмбеддингов | `text-embedding-ada-002` | | `LOCAL_EMBEDDING_MODEL` | Резервная локальная CPU-модель | `intfloat/multilingual-e5-small` | | `ENABLE_CODE_SEARCH` | Поиск по BSL-коду | `true` | | `ENABLE_BUSINESS_SEARCH` | Семантический поиск по бизнес-описаниям | `true` | | `CALCULATE_BUSINESS_INFO` | Генерировать AI бизнес-описания | `false` | | `ENABLE_METADATA_DESCRIPTION_EMBEDDING` | Эмбеддинги для описательных полей | `true` | | `MCP_HOST` | Хост MCP-сервера | `0.0.0.0` | | `MCP_PORT` | Порт MCP | `8006` | | `MCP_PATH` | URL-путь MCP эндпоинта | `/mcp` | | `MCP_TOOL_PROFILE` | Профиль публикуемых инструментов: `admin` или `read-only` | `admin` | | `MCP_NAMESPACE` | Namespace регистрации графовых проектов | `default` | | `GRAPH_SCOPE_ENFORCED` | Записан ли scope в графе: при `true` и закрытом миграционном окне `project_id` обязателен; при `false` отсутствующий id подставляется из единственного/legacy-проекта и ответ помечается `deprecated` | `false` | | `GRAPH_SCOPE_MIGRATION_WINDOW` | При scoped-графе разрешить временную подстановку единственного проекта. При `GRAPH_SCOPE_ENFORCED=false` legacy-вызовы обслуживаются независимо от окна и помечаются `deprecated` | `false` | | `GRAPH_MAX_ITEMS` | Жёсткий предел элементов в ответе | `200` | | `GRAPH_TOOL_TIMEOUT_SECONDS` | Таймаут выполнения инструмента | `300` | | `EMBEDDING_ALLOW_OFFLINE_FALLBACK` | Автопереход на локальную модель | `true` | | `TEMPLATE_MODE_ENABLED` | Шаблонный режим (JSON-запросы без LLM) | `true` | | `TEMPLATE_MODE_ONLY` | Только шаблоны, без LLM | `false` | | `CODE_SEARCH_MAX_FILE_SIZE` | Макс. размер BSL-файла (байт) | `50000` | | `CODE_EXPORT_PATH` | Путь к XML-выгрузке в файлы | — | | `LOAD_BSL_SIGNATURES` | Загружать BSL-граф (Module/Routine/CALLS) | `true` | | `ENABLE_ROUTINE_EMBEDDINGS` | Эмбеддинги для процедур/функций | `true` | | `LOAD_FORMS_FROM_XML` | Загружать структуру управляемых форм из XML | `false` | | `LOAD_ORDINARY_FORMS` | Загружать структуру обычных форм | `true` | | `LOAD_EVENT_SUBSCRIPTIONS` | Загружать подписки на события | `false` | | `LOAD_PREDEFINED_VALUES` | Загружать предопределённые элементы | `false` | | `LOAD_ROLE_RIGHTS` | Загружать права ролей | `false` | | `LOAD_HELP_FROM_HTML` | Загружать справку из HTML | `false` | | `LOAD_DCS_TEMPLATES` | Загружать схемы компоновки данных (СКД) | `false` | | `EXTENSION_NAME` | Имя расширения | — | | `EXTENSION_BASE_PROJECT` | Имя базового проекта для расширения | — | | `EXTENSION_APPLY_ORDER` | Порядок применения слоя расширения | `1` | | `EXTENSION_CATALOG_ENABLED` | Загружать все расширения из каталога массовой выгрузки за один прогон | `false` | | `EXTENSIONS_PATH` | Каталог с выгрузками расширений; пусто — подкаталоги каталога выгрузки | *(пусто)* | | `EXTENSION_ORDER_MANIFEST` | JSON с порядком применения расширений внутри одного назначения | *(пусто)* | | `EXTENSION_CATALOG_SYNC` | Синхронизировать слои с каталогом (удалять исчезнувшие расширения) | `true` | | `GRAPH_PLUGINS_ENABLED` | Загружать плагины Graph Metadata Search | `false` | | `GRAPH_PLUGINS_DIRECTORY` | Каталог плагинов | `plugins` | | `GRAPH_PLUGIN_STRICT_BUILD` | Останавливать построение поколения при ошибке derived-state hook | `false` | | `GRAPH_PLUGIN_HOOK_TIMEOUT_SECONDS` | Бюджет времени одного plugin hook; `0` отключает контроль | `5.0` | Полный список переменных Graph Metadata Search, включая лимиты графовых ответов, поколения и загрузку данных: [Конфигурация Graph Metadata Search](/mcp-servery-1c/servery/graph-metadata-search/konfiguraciya.md). ### 1CCodeChecker (порт 8007) | Переменная | Описание | По умолчанию | | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | | `LICENSE_KEY` | Лицензионный ключ | Обязательно | | `ONEC_AI_TOKEN` | Токен 1С:Напарник | Обязательно | | `MCP_TOOL_CALL_MODE` | Режим вызова upstream: `direct` (прямые вызовы) или `standard` (промпты) | `direct` | | `ONEC_AI_BASE_URL` | Базовый URL API 1С.ai | `https://code.1c.ai` | | `ONEC_AI_TIMEOUT` | Таймаут отдельного запроса к API (секунды): connect, write, получение соединения из пула и чтение любого непотокового запроса. SSE-поток им **не** обрывается — его границей чтения служит бюджет операции | `30` | | `ONEC_AI_OPERATION_TIMEOUT` | Бюджет времени на всю операцию, включая чтение SSE и повторные попытки (секунды). Должен помещаться в таймаут инструмента вашего MCP-клиента | `300` | | `ONEC_AI_TRANSPORT_RETRIES` | Сколько дополнительных попыток делать при транспортном сбое (сетевая ошибка, таймаут одного запроса, HTTP 5xx/429), каждая — на свежей дискуссии и в пределах бюджета операции. `0` — одна попытка | `2` | | `ONEC_AI_SKILL_NAME` | Режим сессии: `custom` (с инструментами) или `raw` | `custom` | | `ONEC_AI_INPUT_MAX_LENGTH` | Максимальная длина каждого входного поля | `100000` | | `ONEC_AI_WORKSPACE_ROOTS` | Абсолютные корни, внутри которых beta-сервер может читать пути из `files`; пустое значение запрещает чтение | `/workspace` в Docker | | `ONEC_AI_WORKSPACE_MAX_FILE_BYTES` | Максимальный размер одного файла для `files` | `2000000` | | `ONEC_AI_WORKSPACE_PATH_MAP` | Пары `префикс_на_машине_клиента=корень_в_контейнере`, разделённые `;` или переводами строк. Каждый корень обязан входить в `ONEC_AI_WORKSPACE_ROOTS` | *(пусто)* | | `ONEC_AI_DOC_VERSION` | Версия документации платформы по умолчанию (конкретная версия, не `latest`) | `v8.5.1` | | `ONEC_AI_UI_LANGUAGE` | Язык интерфейса | `russian` | | `ONEC_AI_PROGRAMMING_LANGUAGE` | Язык программирования | *(пусто)* | | `ONEC_AI_SCRIPT_LANGUAGE` | Скриптовый язык (`ru` / `en`) | `ru` | | `ONEC_CONFIG_NAME` | Конфигурация 1С по умолчанию для `config_help` | *(пусто)* | | `MAX_ACTIVE_SESSIONS` | Макс. активных upstream-дискуссий | `10` | | `SESSION_TTL` | Время жизни upstream-дискуссии (секунды) | `3600` | | `ONEC_AI_CONVERSATION_BUSY_TIMEOUT` | Ожидание освобождения занятой дискуссии (секунды) | `60` | | `MCP_TRANSPORT_SESSION_IDLE_TIMEOUT` | Простой транспортной сессии MCP до закрытия (секунды) | `900` | | `MCP_TRANSPORT_SESSION_MAX_LIFETIME` | Абсолютное время жизни транспортной сессии MCP (секунды) | `28800` | | `MCP_MAX_TRANSPORT_SESSIONS` | Максимум одновременных транспортных сессий MCP | `100` | | `MCP_TRANSPORT_SESSION_SWEEP_INTERVAL` | Период уборки истёкших сессий (секунды) | `30` | | `MCP_TRANSPORT_SESSION_SWEEP_BATCH` | Максимум сессий, закрываемых за один проход уборки | `100` | | `HTTP_PORT` | Порт HTTP-сервера | `8007` | | `PLUGIN_DIR` | Каталог Python-плагинов (beta) | `/app/plugins` | ### SyntaxCheckServer (порт 8002) | Переменная | Описание | По умолчанию | | ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | | `LICENSE_KEY` | Лицензионный ключ | Обязательно | | `USESSE` | SSE транспорт | `false` | | `FILES_DIR` | Каталог с файлами BSL внутри контейнера. Если каталог задан и существует, сервер регистрирует инструмент `syntaxcheck_file` | *(пусто)* | | `FULLINDEX` | `true`/`1`/`yes`/`on` включает режим полного индекса (beta): `FILES_DIR` индексируется при старте, и `UnresolvedMethodCall`, `UnresolvedField`, `QueryToMissingMetadata` отвечают из индекса | *(пусто)* | | `INDEX_DIR` | Каталог индекса конфигурации; образ объявляет его томом | `/index` | | `PLUGINS_DIR` | Каталог Python-плагинов; пустое значение использует `/app/plugins` | *(пусто)* | | `LOG_LEVEL` | Уровень журналирования | `INFO` | | `MCP_HTTP_PATH` | Endpoint `streamable-http` | `/mcp` | | `MCP_SSE_PATH` | Endpoint потока событий при `USESSE=true` | `/sse` | | `MCP_MESSAGE_PATH` | Endpoint сообщений при `USESSE=true` | `/messages/` | | `BSL_ANALYZER_TIMEOUT_SECONDS` | Таймаут анализатора | `30` | | `BSL_ANALYZER_STDOUT_LIMIT_BYTES` | Лимит JSONL-отчёта анализатора | `16777216` | | `BSL_ANALYZER_STDERR_LIMIT_BYTES` | Лимит диагностического вывода анализатора | `4194304` | | `BSL_ANALYZER_KILL_GRACE_SECONDS` | Ожидание перед принудительной остановкой | `2` | | `BSL_SOURCE_ENCODING` | Явная кодировка файлов; если не задана, пробуются UTF-8 с BOM и CP1251 | *(пусто)* | | `MCP_SESSION_IDLE_TTL_SECONDS` | Простой Streamable HTTP-сессии до уборки, секунды | `1800` | | `MCP_SESSION_MAX_LIFETIME_SECONDS` | Абсолютное время жизни сессии, секунды | `28800` | | `MCP_SESSION_MAX_CONCURRENT` | Максимум одновременных Streamable HTTP-сессий | `64` | | `MCP_SESSION_REAP_INTERVAL_SECONDS` | Интервал уборки просроченных сессий, секунды | `30` | ### TemplatesSearchServer (порт 8004) | Переменная | Описание | По умолчанию | | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------ | | `LICENSE_KEY` | Лицензионный ключ | Обязательно | | `RESET_DATABASE` | Построить новое поколение индекса шаблонов | `false` | | `RESET_CACHE` | Удалить кэш весов embedding-модели и скачать заново | `false` | | `HTTP_PORT` | Порт HTTP-сервера | `8004` | | `EMBEDDING_API_BASE` | URL OpenAI-совместимого API эмбеддингов | — | | `EMBEDDING_API_KEY` | Ключ API эмбеддингов | — | | `EMBEDDING_MODEL` | Модель API или локальная модель | `intfloat/multilingual-e5-small` | | `EMBEDDING_DIMENSIONS` | Размерность эмбеддингов | *(авто)* | | `TEMPLATES_DB_PATH` | Путь к SQLite-базе шаблонов и заметок | `/app/chroma_db/templates.db` | | `ZVEC_DB_PATH` | Каталог векторного индекса zvec | `/app/chroma_db/zvec_db` | | `RECALL_RELEVANCE_THRESHOLD` | Максимальная cosine-distance для `recall` | `1.0` | | `TEMPLATE_RELEVANCE_THRESHOLD` | Максимальная cosine-distance для `templatesearch` | `1.0` | | `FUSION_RANK_CONSTANT` | Константа reciprocal rank fusion | `60` | | `FTS_DEFAULT_OPERATOR` | Объединение соседних терминов в полнотекстовом маршруте: `OR` или `AND` | `OR` | | `GROUP_RESULT_CAP` | Максимум документов одного шаблона в ответе | `1` | | `GROUP_CANDIDATE_BUDGET` | Сколько различных шаблонов запрашивается в выборке кандидатов | `11` | | `INDEX_GENERATION_RETENTION` | Сколько поколений каждой коллекции хранится на диске | `2` | | `PLUGIN_DIR` | Каталог Python-плагинов | `/app/plugins` | | `PLUGIN_STRICT_DERIVED_STATE` | Останавливать индексацию при ошибке derived-state hook | `false` | | `MCP_ENABLE_WRITE_TOOLS` | Регистрировать изменяющие инструменты `add_template` и `plugin_reload`. `remember` регистрируется всегда и от этой переменной не зависит | *(не задано — инструменты не публикуются)* | | `MCP_OPERATOR_TOKEN` | Операторский токен для `add_template` / `plugin_reload`; передаётся в заголовке `Authorization`. Обязателен вместе с `MCP_ENABLE_WRITE_TOOLS`, иначе сервер не стартует. Для `remember` не нужен | *(не задано)* | | `ADMIN_USERNAME` / `ADMIN_PASSWORD` | Учётная запись для изменяющих web-операций | *(не заданы)* | | `ADMIN_USERS` | Несколько web-операторов: `имя:пароль:разрешения;...` | *(пусто)* | | `ADMIN_PERMISSIONS` | Разрешения единственного оператора: `create,edit,delete` | все три | | `ADMIN_SESSION_SECRET` | Подпись web-сессий; без значения сессии не переживают рестарт | генерируется при старте | | `ADMIN_ALLOW_UNAUTHENTICATED` | Небезопасно разрешить web-изменения без входа | `false` | | `MAX_DESCRIPTION_BYTES` | Максимум байт в описании шаблона | `20000` | | `MAX_CODE_BYTES` | Максимум байт в коде шаблона | `200000` | | `MAX_MEMORY_BYTES` | Максимум байт в заметке | `20000` | | `MAX_REQUEST_BODY_BYTES` | Максимум байт в теле web-запроса | `1000000` | | `MCP_MAX_CONCURRENT_MUTATIONS` | Одновременные MCP-мутации | `2` | | `MCP_MUTATION_RATE_PER_MINUTE` | Скорость мутаций в минуту | `30` | | `MCP_MUTATION_BURST` | Разрешённый всплеск мутаций | `10` | | `MCP_MUTATION_DAILY_QUOTA` | Суточная квота мутаций (UTC) | `500` | | `MCP_MAX_MUTATIONS_PER_REQUEST` | Изменяющих calls в одном JSON-RPC запросе | `8` | | `MCP_SESSION_IDLE_TIMEOUT` | Простой Streamable HTTP-сессии, секунды | `1800` | | `MCP_SESSION_MAX_LIFETIME` | Абсолютное время жизни сессии, секунды | `28800` | | `MCP_MAX_SESSIONS` | Максимум одновременных сессий | `200` | | `MCP_SESSION_CLEANUP_INTERVAL` | Интервал уборки сессий, секунды | `60` | | `MCP_SESSION_CLEANUP_BATCH` | Сессий за проход уборки | `50` | | `INDEX_RECOVERY_INTERVAL` | Период проверки outbox, секунды | `60` | | `INDEX_RECOVERY_BACKOFF` | Начальная пауза retry индексации, секунды | `5` | | `INDEX_RECOVERY_BACKOFF_CAP` | Максимальная пауза retry, секунды | `300` | | `INDEX_RECOVERY_MAX_ATTEMPTS` | Попыток до stuck state | `6` | | `INDEX_RECOVERY_BATCH` | Маркеров outbox за проход | `100` | | `EMBEDDING_QUERY_PREFIX` | Префикс запросов перед эмбеддингом | *(пусто)* | | `EMBEDDING_PASSAGE_PREFIX` | Префикс документов перед эмбеддингом | *(пусто)* | | `EMBEDDING_TRUST_REMOTE_CODE` | Opt-in для custom model code; требует allowlist и immutable revision | `false` | | `EMBEDDING_TRUST_REMOTE_CODE_MODELS` | Allowlist model ID для custom code | *(пусто)* | | `EMBEDDING_MODEL_REVISION` | Полный commit SHA или content digest модели | *(пусто)* | {% hint style="info" %} Переменные `PLUGIN_DIR`, `PLUGINS_DIR`, `PLUGIN_STRICT_DERIVED_STATE`, `PLUGIN_HOOK_TIMEOUT_SECONDS` и `GRAPH_PLUGIN*` относятся к системе плагинов — общему механизму доработки серверов. Что они включают и чем это оплачивается: [Доработка MCP: система плагинов](/mcp-servery-1c/sistema-pluginov.md). {% endhint %} ## Примеры ### Минимальный набор (CPU) ```powershell -e LICENSE_KEY=YOUR_LICENSE_KEY ``` ### С LM Studio ```powershell -e LICENSE_KEY=YOUR_LICENSE_KEY ` -e RESET_DATABASE=false ` -e EMBEDDING_API_BASE=http://host.docker.internal:1234/v1 ` -e EMBEDDING_API_KEY=lm-studio ` -e EMBEDDING_MODEL=Qwen3-Embedding-4B ``` ### С OpenRouter ```powershell -e LICENSE_KEY=YOUR_LICENSE_KEY ` -e RESET_DATABASE=false ` -e EMBEDDING_API_BASE=https://openrouter.ai/api ` -e EMBEDDING_API_KEY=YOUR_OPENROUTER_KEY ` -e EMBEDDING_MODEL=qwen/qwen3-embedding-8b ``` ### С Ollama ```powershell -e LICENSE_KEY=YOUR_LICENSE_KEY ` -e RESET_DATABASE=false ` -e EMBEDDING_API_BASE=http://host.docker.internal:11434/v1 ` -e EMBEDDING_API_KEY=ollama ` -e EMBEDDING_MODEL=qwen3:embedding-4b ```