Полное переименование в omnichannel-configserver-mcp (имя MCP-сервера, бинарник, файл конфига, доки)
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
# Совместимость с версиями API
|
||||
|
||||
`omnichannel-mcp` рассчитан на API **`config_server` 1.1.0** (он же `latest`).
|
||||
`omnichannel-configserver-mcp` рассчитан на API **`config_server` 1.1.0** (он же `latest`).
|
||||
Эта версия добавила JSON-эндпоинты, на которые опирается сервер.
|
||||
|
||||
## Что появилось в 1.1.0
|
||||
|
||||
@@ -4,7 +4,7 @@
|
||||
|
||||
```
|
||||
┌────────────────┐ MCP (stdio, JSON-RPC) ┌──────────────────┐
|
||||
│ MCP-клиент │ ◄──────────────────────► │ omnichannel-mcp │
|
||||
│ MCP-клиент │ ◄──────────────────────► │ omnichannel-configserver-mcp │
|
||||
│ (AI-ассистент)│ │ (этот сервер) │
|
||||
└────────────────┘ └────────┬─────────┘
|
||||
│ HTTP (session)
|
||||
@@ -21,7 +21,7 @@
|
||||
└───────────────────────────┘
|
||||
```
|
||||
|
||||
`omnichannel-mcp` — тонкий клиент. Он не выполняет команды сам: создаёт задачи
|
||||
`omnichannel-configserver-mcp` — тонкий клиент. Он не выполняет команды сам: создаёт задачи
|
||||
через API `config_server`, а те забирают агенты нод. Сервер без состояния — при
|
||||
перезапуске ничего не теряется.
|
||||
|
||||
|
||||
@@ -11,7 +11,7 @@
|
||||
1. аргумент инструмента `config_path` (для обёрток; обычно не нужен);
|
||||
2. флаг запуска `-config /path/config.json`;
|
||||
3. каталог из переменной окружения `OMNI_CONFIG_DIR` (в нём берётся
|
||||
`omnichannel-mcp.json`).
|
||||
`omnichannel-configserver-mcp.json`).
|
||||
|
||||
Обычный режим — флаг `-config`.
|
||||
|
||||
@@ -146,7 +146,7 @@
|
||||
## Проверка конфига
|
||||
|
||||
```bash
|
||||
./omnichannel-mcp --check-config -config config.json
|
||||
./omnichannel-configserver-mcp --check-config -config config.json
|
||||
```
|
||||
|
||||
Печатает итоговый (слитый) конфиг с замаскированными секретами, список серверов
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Быстрый старт
|
||||
|
||||
`omnichannel-mcp` — это **MCP-сервер**: программа, которую AI-ассистент
|
||||
`omnichannel-configserver-mcp` — это **MCP-сервер**: программа, которую AI-ассистент
|
||||
(Claude Desktop, Cursor, Continue и любой другой MCP-клиент) запускает как
|
||||
локальный процесс и через которую получает доступ к платформе Omnichannel.
|
||||
Сервер не хранит состояние и не имеет UI: он лишь транслирует запросы агента в
|
||||
@@ -18,10 +18,10 @@ HTTP API `config_server`.
|
||||
## 1. Сборка
|
||||
|
||||
```bash
|
||||
cd omnichannel-mcp
|
||||
cd omnichannel-configserver-mcp
|
||||
export GOPRIVATE=git.totmin.ru
|
||||
go build -o omnichannel-mcp .
|
||||
./omnichannel-mcp --health # -> ok
|
||||
go build -o omnichannel-configserver-mcp .
|
||||
./omnichannel-configserver-mcp --health # -> ok
|
||||
```
|
||||
|
||||
## 2. Конфигурация
|
||||
@@ -54,7 +54,7 @@ cp examples/config.single-server.json config.json
|
||||
|
||||
```bash
|
||||
export OMNI_USER=admin OMNI_PASSWORD='...'
|
||||
./omnichannel-mcp --check-config -config config.json
|
||||
./omnichannel-configserver-mcp --check-config -config config.json
|
||||
```
|
||||
|
||||
## 3. Подключение к MCP-клиенту
|
||||
@@ -64,9 +64,9 @@ export OMNI_USER=admin OMNI_PASSWORD='...'
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"omnichannel-mcp": {
|
||||
"command": "/opt/omnichannel-mcp/omnichannel-mcp",
|
||||
"args": ["-config", "/opt/omnichannel-mcp/config.json"],
|
||||
"omnichannel-configserver-mcp": {
|
||||
"command": "/opt/omnichannel-configserver-mcp/omnichannel-configserver-mcp",
|
||||
"args": ["-config", "/opt/omnichannel-configserver-mcp/config.json"],
|
||||
"env": {
|
||||
"OMNI_USER": "admin",
|
||||
"OMNI_PASSWORD": "СЕКРЕТ"
|
||||
@@ -104,6 +104,6 @@ export OMNI_USER=admin OMNI_PASSWORD='...'
|
||||
|
||||
```bash
|
||||
docker compose -f examples/demo/docker-compose.yml up -d
|
||||
go build -o omnichannel-mcp .
|
||||
go build -o omnichannel-configserver-mcp .
|
||||
python3 examples/demo/demo.py
|
||||
```
|
||||
|
||||
+11
-11
@@ -1,6 +1,6 @@
|
||||
# Подключение к MCP-клиентам
|
||||
|
||||
`omnichannel-mcp` — обычный stdio-сервер. Достаточно указать команду запуска,
|
||||
`omnichannel-configserver-mcp` — обычный stdio-сервер. Достаточно указать команду запуска,
|
||||
аргумент `-config` и (при необходимости) переменные окружения с секретами.
|
||||
|
||||
## Claude Desktop
|
||||
@@ -13,9 +13,9 @@
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"omnichannel-mcp": {
|
||||
"command": "/opt/omnichannel-mcp/omnichannel-mcp",
|
||||
"args": ["-config", "/opt/omnichannel-mcp/config.json"],
|
||||
"omnichannel-configserver-mcp": {
|
||||
"command": "/opt/omnichannel-configserver-mcp/omnichannel-configserver-mcp",
|
||||
"args": ["-config", "/opt/omnichannel-configserver-mcp/config.json"],
|
||||
"env": {
|
||||
"OMNI_USER": "admin",
|
||||
"OMNI_PASSWORD": "СЕКРЕТ"
|
||||
@@ -32,9 +32,9 @@
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"omnichannel-mcp": {
|
||||
"command": "/opt/omnichannel-mcp/omnichannel-mcp",
|
||||
"args": ["-config", "/opt/omnichannel-mcp/config.json"],
|
||||
"omnichannel-configserver-mcp": {
|
||||
"command": "/opt/omnichannel-configserver-mcp/omnichannel-configserver-mcp",
|
||||
"args": ["-config", "/opt/omnichannel-configserver-mcp/config.json"],
|
||||
"env": { "OMNI_USER": "admin", "OMNI_PASSWORD": "СЕКРЕТ" }
|
||||
}
|
||||
}
|
||||
@@ -46,16 +46,16 @@
|
||||
Форма одна: `command` + `args` + `env`. Минимально достаточно:
|
||||
|
||||
```json
|
||||
{ "command": "/opt/omnichannel-mcp/omnichannel-mcp",
|
||||
"args": ["-config", "/opt/omnichannel-mcp/config.json"] }
|
||||
{ "command": "/opt/omnichannel-configserver-mcp/omnichannel-configserver-mcp",
|
||||
"args": ["-config", "/opt/omnichannel-configserver-mcp/config.json"] }
|
||||
```
|
||||
|
||||
Если секреты лежат в `config.local.json`, переменные окружения не нужны.
|
||||
|
||||
## Проверка подключения
|
||||
|
||||
- Из терминала: `./omnichannel-mcp --check-config -config config.json` и
|
||||
`./omnichannel-mcp --health`.
|
||||
- Из терминала: `./omnichannel-configserver-mcp --check-config -config config.json` и
|
||||
`./omnichannel-configserver-mcp --health`.
|
||||
- В клиенте: попросите ассистента вызвать `server_info` — он покажет версию API
|
||||
и режим. Затем `overview` — сводку по стенду.
|
||||
|
||||
|
||||
+1
-1
@@ -1,6 +1,6 @@
|
||||
# Эксплуатация
|
||||
|
||||
`omnichannel-mcp` работает в **плоскости управления**: он видит статусы,
|
||||
`omnichannel-configserver-mcp` работает в **плоскости управления**: он видит статусы,
|
||||
конфигурацию, задачи и историю, но не заглядывает внутрь контейнеров. Это
|
||||
разделение осознанное — так сервер остаётся безопасным и предсказуемым.
|
||||
|
||||
|
||||
+1
-1
@@ -1,6 +1,6 @@
|
||||
# Безопасность
|
||||
|
||||
`omnichannel-mcp` даёт ассистенту право управлять платформой, поэтому
|
||||
`omnichannel-configserver-mcp` даёт ассистенту право управлять платформой, поэтому
|
||||
безопасность строится в несколько независимых слоёв: конфигурация модуля,
|
||||
подтверждения, и ограничения на стороне `config_server`.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user