AI & MCP#
Model Context Protocol - to wyróżnia vCLU od każdego innego kontrolera smart home.
vCLU implementuje serwer MCP, który pozwala asystentom AI (Claude Code, OpenAI Codex, Gemini CLI i innym) sterować inteligentnym domem naturalnym językiem. Zamiast pisać skrypty, automatyzacje czy konfigurować scenariusze - rozmawiasz z AI, a ono obsługuje urządzenia za Ciebie.
Co to daje w praktyce?#
Ty: "Zgaś wszystko w salonie i włącz tryb filmowy"
AI: → vclu_devices(type: "switch") - lista urządzeń
→ vclu_device_set(salon_kanapa, 0) - zgaś kanapę
→ vclu_device_set(salon_stol, 0) - zgaś stół
→ vclu_scene_execute(tryb_filmowy) - włącz scenę
✓ Gotowe - salon przygotowany do filmu.Żaden inny kontroler smart home nie oferuje takiej integracji out-of-the-box.
Dwie warstwy MCP#
Layer 1 - sterowanie urządzeniami#
Bezpieczny dostęp do urządzeń i scen, gotowy do użycia od razu:
- 6 narzędzi - listowanie, odczyt, sterowanie urządzeniami i scenami
- 2 zasoby - snapshot urządzeń jako kontekst dla modelu AI
- Bearer token - uwierzytelnianie kluczem API (SHA-256)
- Access Control - per-urządzenie: full / readonly / hidden
- Dashboard - panel z aktywnością, metrykami i konfiguracją
Layer 2 - Dev Pipeline#
Tryb deweloperski dla agentów AI, pozwalający czytać kod, pisać moduły Lua i testować je w sandboxie przed wdrożeniem:
- 6 narzędzi eksploracji - czytanie plików, grep, logi, konfiguracja, pełny rejestr urządzeń
- 9 narzędzi sandbox - pipeline draft > validate > test > promote z automatycznym backupem i rollbackiem
- Pamięć agenta - trwały kontekst między sesjami (notatki, obserwacje, TODOs)
- Dev Mode - wymagane włączenie per-bot w dashboardzie
Alternatywa: zdalny system plików#
Oprócz MCP, możesz pracować z vCLU bezpośrednio przez SSH/SFTP - dowolny agent (Claude Code, Cursor, VS Code) może edytować pliki w katalogu danych vCLU. Szczegóły w sekcji Praca z systemem plików.
Struktura sekcji#
Podstawy
Bezpieczeństwo i zarządzanie
Layer 2 - Dev Pipeline
Praca bez MCP