Initial commit: omnichannel-mcp — MCP-сервер управления платформой Omnichannel

docs/mcp-clients.md

@@ -0,0 +1,67 @@
+# Подключение к 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`.