# Совместимость с версиями API

`omnichannel-mcp` рассчитан на API **`config_server` 1.1.0** (он же `latest`).
Эта версия добавила JSON-эндпоинты, на которые опирается сервер.

## Что появилось в 1.1.0

| Эндпоинт | Назначение |
|---|---|
| `POST /api/login`, `POST /api/logout` | JSON-авторизация для сторонних клиентов |
| `GET /api/whoami` | Проверка сессии |
| `GET /api/application/<id>` | Детализация сервиса в JSON |
| `POST /api/compose/<id>` | Установка compose через JSON |
| `POST /api/env/<id>/<file>` | Установка env через JSON |
| `GET /api/tasks`, `GET /api/task/<id>` | Список/статус задач |

В более старых версиях (≤ 1.0.20) этих эндпоинтов нет: логин был только
HTML-формой, конфиг правился HTML-страницами, а список задач — только по хосту.
`update_front` появился раньше (1.0.19+).

## Capability-probe

Инструмент `server_info` определяет версию автоматически (по доступности
`GET /api/whoami`) и возвращает:

```json
{
  "server": "prod",
  "base_url": "http://10.20.30.40:5005",
  "read_only": false,
  "capabilities": {
    "version": "1.1.0",
    "features": { "api_login": true, "set_compose": true, "tasks_filter": true, … }
  }
}
```

На старом стенде `version` будет `legacy (<1.1.0)`, а `features` — пустым. В этом
случае инструменты, требующие новых эндпоинтов, вернут понятное сообщение вместо
«тихой» поломки. Наблюдение и часть операций на старых версиях недоступны —
обновите `config_server`.

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

Перед автоматизацией вызовите `server_info` и убедитесь, что `version` = `1.1.0`.
Если планируется смешанный парк — запускайте отдельный инстанс модуля на каждый
контур со своим `server`-конфигом.