From 686f12fdd2da0578d621dfdc9acd935237857035 Mon Sep 17 00:00:00 2001
From: host <arumyantsev@rummail.ru>
Date: Fri, 28 Aug 2026 18:43:32 +0300
Subject: [PATCH] =?UTF-8?q?=D0=98=D1=81=D0=BF=D1=80=D0=B0=D0=B2=D0=B8?=
 =?UTF-8?q?=D1=82=D1=8C=20URL=20=D0=B4=D0=BB=D1=8F=20Open=20WebUI:=20?=
 =?UTF-8?q?=D0=B1=D0=B0=D0=B7=D0=BE=D0=B2=D1=8B=D0=B9=20=D0=BF=D1=83=D1=82?=
 =?UTF-8?q?=D1=8C=20/truenas=20=D0=B1=D0=B5=D0=B7=20/openapi.json?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index ef5b689..94d8c60 100644
--- a/README.md
+++ b/README.md
@@ -48,9 +48,17 @@ docker logs truenas-mcp --tail 15
 
 ### Подключение клиентов
 
-- OpenAPI-схема: http://truenas-ip:8814/openapi.json
-- Документация в браузере: http://truenas-ip:8814/docs
-- Open WebUI: Admin Panel -> Settings -> External Tools -> Type: OpenAPI -> URL выше.
+Важно: mcpo регистрирует сервер под именем "truenas" (из config.json) и монтирует
+его инструменты не в корне, а под этим префиксом. Корневой /openapi.json - это
+только служебный индекс mcpo со списком подключённых серверов (пустой "paths":{}),
+для подключения клиентов он не годится.
+
+- Open WebUI: Admin Panel -> Settings -> External Tools -> Type: OpenAPI -> URL:
+  http://truenas-ip:8814/truenas (без /openapi.json - Open WebUI сам добавляет
+  этот суффикс при обращении к серверу).
+- Прямая ссылка на саму схему (для curl / проверки в браузере):
+  http://truenas-ip:8814/truenas/openapi.json
+- Документация Swagger: http://truenas-ip:8814/truenas/docs
 - Claude Desktop: сервис отдаёт OpenAPI, а не MCP Streamable HTTP - Custom Connectors
   не примет его напрямую. Для Claude Desktop используется локальный запуск того же
   truenas-mcp-server через uvx в claude_desktop_config.json.