diff --git a/proxmox-mcp-open-webui-setup.md b/proxmox-mcp-open-webui-setup.md index 6b04b1a..4aa1c0d 100644 --- a/proxmox-mcp-open-webui-setup.md +++ b/proxmox-mcp-open-webui-setup.md @@ -51,6 +51,7 @@ mkdir -p /mnt/ssd/apps/mcp/{pve,kybinka,pve1} ```bash cat > /mnt/ssd/apps/mcp/pve/config.json << 'EOF' { + "dev_mode": true, "proxmox": { "host": "192.168.31.2", "port": 8006, @@ -75,6 +76,7 @@ EOF ```bash cat > /mnt/ssd/apps/mcp/kybinka/config.json << 'EOF' { + "dev_mode": true, "proxmox": { "host": "192.168.1.10", "port": 8006, @@ -99,6 +101,7 @@ EOF ```bash cat > /mnt/ssd/apps/mcp/pve1/config.json << 'EOF' { + "dev_mode": true, "proxmox": { "host": "192.168.31.4", "port": 8006, @@ -130,7 +133,7 @@ python3 -m json.tool /mnt/ssd/apps/mcp/pve1/config.json chmod 600 /mnt/ssd/apps/mcp/{pve,kybinka,pve1}/config.json ``` -> `verify_ssl: false` отключает проверку TLS-сертификата Proxmox. Это обычно требуется для самоподписанного сертификата в локальной сети. Для production лучше установить доверенный сертификат и включить проверку. +> `verify_ssl: false` отключает проверку TLS-сертификата Proxmox. Параметр `dev_mode: true` требуется текущей версией ProxmoxMCP-Plus, чтобы разрешить такое подключение с самоподписанным сертификатом. Для production лучше установить доверенный сертификат и использовать `verify_ssl: true` вместе с `dev_mode: false`. --- @@ -222,7 +225,18 @@ curl -H "Authorization: Bearer ключ-для-pve" http://192.168.31.100:8811/h | Симптом | Причина | | --- | --- | +| `logging Field required` | В контейнер попал старый `config.json` без блока `logging` или подключён неправильный файл через volume | +| `Insecure TLS configuration blocked` | В конфигурации отсутствует `dev_mode: true` при использовании `verify_ssl: false` | +| `McpError: Connection closed` | MCP-сервер завершился из-за ошибки конфигурации; исправь первичную ошибку выше по логу | | Контейнер падает при старте | Невалидный JSON или неверный путь к `config.json` | | `401 Unauthorized` | Bearer-ключ не совпадает с `PROXMOX_API_KEY` | | Инструмент не появляется в Open WebUI | Проверь URL `/openapi.json` и доступность соответствующего порта | | Модель не видит VM | Проверь права API-токена Proxmox и логи контейнера в Dockge | + +Если после изменения конфигурации остаётся ошибка `logging Field required`, останови Stack в Dockge, проверь файлы на TrueNAS и заново выполни **Deploy**. В compose должны использоваться именно эти volume-маунты: + +```yaml +- /mnt/ssd/apps/mcp/pve/config.json:/app/proxmox-config/config.json:ro +- /mnt/ssd/apps/mcp/kybinka/config.json:/app/proxmox-config/config.json:ro +- /mnt/ssd/apps/mcp/pve1/config.json:/app/proxmox-config/config.json:ro +```