# Подключение к MCP-клиентам

`omnichannel-mcp` — обычный stdio-сервер. Достаточно указать команду запуска,
аргумент `-config` и (при необходимости) переменные окружения с секретами.

## Claude Desktop

Файл конфигурации:

- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "omnichannel-mcp": {
      "command": "/opt/omnichannel-mcp/omnichannel-mcp",
      "args": ["-config", "/opt/omnichannel-mcp/config.json"],
      "env": {
        "OMNI_USER": "admin",
        "OMNI_PASSWORD": "СЕКРЕТ"
      }
    }
  }
}
```

## Cursor

Файл `~/.cursor/mcp.json` (или `.cursor/mcp.json` в проекте):

```json
{
  "mcpServers": {
    "omnichannel-mcp": {
      "command": "/opt/omnichannel-mcp/omnichannel-mcp",
      "args": ["-config", "/opt/omnichannel-mcp/config.json"],
      "env": { "OMNI_USER": "admin", "OMNI_PASSWORD": "СЕКРЕТ" }
    }
  }
}
```

## Любой другой stdio-клиент

Форма одна: `command` + `args` + `env`. Минимально достаточно:

```json
{ "command": "/opt/omnichannel-mcp/omnichannel-mcp",
  "args": ["-config", "/opt/omnichannel-mcp/config.json"] }
```

Если секреты лежат в `config.local.json`, переменные окружения не нужны.

## Проверка подключения

- Из терминала: `./omnichannel-mcp --check-config -config config.json` и
  `./omnichannel-mcp --health`.
- В клиенте: попросите ассистента вызвать `server_info` — он покажет версию API
  и режим. Затем `overview` — сводку по стенду.

## Несколько стендов

Один инстанс сервера может обслуживать несколько стендов (`servers` в конфиге).
Тогда в вызовах используется аргумент `server`. Если нужна полная изоляция
(разные пользователи/права) — запустите отдельные инстансы (разные `-config` и,
при желании, `read_only`), каждый со своим именем в `mcpServers`.