> 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/servery/ssl-search-server/konfiguraciya.md).

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

## Переменные окружения

### Обязательные

| Переменная    | Описание          | Пример             |
| ------------- | ----------------- | ------------------ |
| `LICENSE_KEY` | Лицензионный ключ | `YOUR_LICENSE_KEY` |
| `SSL_VERSION` | Версия БСП        | `3.1.11`           |

### Управление индексацией

| Переменная                            | Описание                                                                                                                           | По умолчанию |
| ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| `RESET_DATABASE`                      | Переиндексировать при запуске                                                                                                      | `false`      |
| `FORCE_REINDEX_ON_DIMENSION_MISMATCH` | Автоматически пересоздать коллекцию ChromaDB при несовпадении размерности эмбеддингов. Если `false` — сервер остановится с ошибкой | `true`       |

### Транспорт

| Переменная | Описание                            | По умолчанию |
| ---------- | ----------------------------------- | ------------ |
| `USESSE`   | SSE транспорт (для legacy клиентов) | `false`      |

### Embedding модели (LM Studio / Ollama / OpenRouter)

| Переменная                     | Описание                                                                                                                                              | Пример                                |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- |
| `OPENAI_API_BASE`              | URL API сервера. Суффикс `/v1` добавляется автоматически                                                                                              | `http://host.docker.internal:1234/v1` |
| `OPENAI_API_KEY`               | Ключ API                                                                                                                                              | `lm-studio`                           |
| `OPENAI_MODEL`                 | Название модели (переопределяет `EMBEDDING_MODEL` для API)                                                                                            | `Qwen3-Embedding-4B`                  |
| `EMBEDDING_MODEL`              | Модель для локальных эмбеддингов (CPU)                                                                                                                | `intfloat/multilingual-e5-small`      |
| `EMBEDDING_DIMENSIONS`         | Явное указание размерности эмбеддингов. Для моделей с переменной размерностью (Qwen3, text-embedding-3). Если не указано — определяется автоматически | *(авто)*                              |
| `EMBEDDING_INPUT_TYPE_ENABLED` | Включить параметр `input_type` для различения query/document при генерации эмбеддингов. Полезно для моделей Qwen3, BGE, E5                            | `true`                                |

## Монтируемые тома

| Хост               | Контейнер        | Назначение            |
| ------------------ | ---------------- | --------------------- |
| `E:/bases/mcp_ssl` | `/app/chroma_db` | Векторная база данных |

## Доступные версии БСП

Сервер поддерживает различные версии БСП. Укажите вашу версию в `SSL_VERSION`.

Примеры:

* `3.1.11`
* `3.1.9`
* `3.2.1`
* `2.4.6`

## Примеры конфигураций

### Минимальная (CPU)

```powershell
docker run -d -p 8008:8008 `
  --name mcp_ssl_server `
  -e LICENSE_KEY=YOUR_LICENSE_KEY `
  -e SSL_VERSION=3.1.11 `
  comol/mcp_ssl_server:latest
```

### Рекомендуемая (LM Studio)

```powershell
docker run -d -p 8008:8008 `
  --name mcp_ssl_server `
  -e LICENSE_KEY=YOUR_LICENSE_KEY `
  -e SSL_VERSION=3.1.11 `
  -e RESET_DATABASE=false `
  -e OPENAI_API_BASE=http://host.docker.internal:1234/v1 `
  -e OPENAI_API_KEY=lm-studio `
  -e OPENAI_MODEL=Qwen3-Embedding-4B `
  -v "E:/bases/mcp_ssl:/app/chroma_db" `
  comol/mcp_ssl_server:latest
```

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

```json
{
  "mcpServers": {
    "1c-ssl-mcp": {
      "url": "http://localhost:8008/mcp",
      "connection_id": "1c_ssl_service_001"
    }
  }
}
```