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.