Полное переименование в omnichannel-configserver-mcp (имя MCP-сервера, бинарник, файл конфига, доки)
ci / test (push) Successful in 2m20s
ci / lint (push) Successful in 5m43s

This commit is contained in:
Maksim Totmin
2026-10-07 20:16:10 +07:00
parent 1c7242d5c5
commit d2e7d3679b
23 changed files with 63 additions and 63 deletions
+1 -1
View File
@@ -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
+2 -2
View File
@@ -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`, а те забирают агенты нод. Сервер без состояния — при
перезапуске ничего не теряется.
+2 -2
View File
@@ -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
```
Печатает итоговый (слитый) конфиг с замаскированными секретами, список серверов
+9 -9
View File
@@ -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
View File
@@ -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
View File
@@ -1,6 +1,6 @@
# Эксплуатация
`omnichannel-mcp` работает в **плоскости управления**: он видит статусы,
`omnichannel-configserver-mcp` работает в **плоскости управления**: он видит статусы,
конфигурацию, задачи и историю, но не заглядывает внутрь контейнеров. Это
разделение осознанное — так сервер остаётся безопасным и предсказуемым.
+1 -1
View File
@@ -1,6 +1,6 @@
# Безопасность
`omnichannel-mcp` даёт ассистенту право управлять платформой, поэтому
`omnichannel-configserver-mcp` даёт ассистенту право управлять платформой, поэтому
безопасность строится в несколько независимых слоёв: конфигурация модуля,
подтверждения, и ограничения на стороне `config_server`.