diff --git a/README.md b/README.md
index e90ef7c..ca32af7 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,25 @@
 # proxmox-mcp-setup
 
-Настройка Proxmox MCP-сервера (ProxmoxMCP-Plus) и подключение к Open WebUI
\ No newline at end of file
+Настройка Proxmox MCP-серверов (ProxmoxMCP-Plus), TrueNAS MCP и подключение к Open WebUI.
+
+## Файлы
+
+- [`compose.yaml`](compose.yaml) — защищённый Docker Compose для трёх Proxmox MCP и TrueNAS MCP;
+- [`.env.example`](.env.example) — шаблон переменных окружения без реальных секретов;
+- [`DEPLOYMENT.md`](DEPLOYMENT.md) — подробная инструкция по внедрению, проверке, обновлению и диагностике;
+- [`proxmox-mcp-open-webui-setup.md`](proxmox-mcp-open-webui-setup.md) — исходная инструкция подключения Proxmox MCP к Open WebUI.
+
+Быстрый старт:
+
+```bash
+cd /mnt/ssd/apps/mcp
+cp .env.example .env
+chmod 600 .env
+# Заполнить .env и подготовить config.json
+
+docker compose --env-file .env config --quiet
+docker compose --env-file .env up -d --build
+docker compose ps
+```
+
+Реальные `.env`, `config.json` и API-ключи нельзя добавлять в Git. Для полной процедуры см. [`DEPLOYMENT.md`](DEPLOYMENT.md).