Czym jest MCP?#

Model Context Protocol (MCP) to otwarty standard stworzony przez Anthropic, który definiuje jak aplikacje AI komunikują się z zewnętrznymi systemami. Można go porównać do USB - jeden uniwersalny interfejs zamiast osobnej wtyczki dla każdego urządzenia.

Jak to działa#

graph LR
    subgraph Klienci
        cc["Claude Code"]
        cx["Codex CLI"]
        gm["Gemini CLI"]
    end

    subgraph vCLU
        mcp["MCP Server"]
        lua["Lua engine"]
        dev["Urządzenia<br/>Sceny<br/>Czujniki"]
        mcp --> lua --> dev
    end

    cc <-->|"MCP (HTTP/SSE)<br/>Bearer token<br/>JSON-RPC 2.0"| mcp
    cx <-->|"MCP"| mcp
    gm <-->|"MCP"| mcp

Klient AI (np. Claude Code) łączy się z vCLU przez HTTP
vCLU udostępnia narzędzia (tools) i zasoby (resources) w formacie MCP
AI wywołuje narzędzia, żeby odczytywać stan i sterować urządzeniami
vCLU wykonuje operacje przez silnik Lua i zwraca wyniki

Dlaczego to zmienia zasady gry#

Tradycyjne sterowanie smart home#

Chcesz zgasić światło w kuchni?
→ Otwórz aplikację
→ Znajdź pokój "Kuchnia"
→ Znajdź urządzenie "LED"
→ Kliknij przełącznik

Chcesz stworzyć automatyzację "kino"?
→ Otwórz konfigurację
→ Utwórz nową scenę
→ Dodaj akcje: zgaś salon, przyciemnij LED, włącz TV
→ Zapisz i przetestuj

Ze sterowaniem przez AI#

Ty:   "Zgaś kuchnię"
AI:   ✓ Gotowe.

Ty:   "Przygotuj tryb kino - przyciemnij salon do 20%,
       zgaś kuchnię, włącz lampkę przy TV"
AI:   ✓ Zrobione. Miłego seansu.

AI rozumie kontekst, nazwy urządzeń i intencje. Nie musisz znać ścieżek, identyfikatorów ani API.

Co vCLU udostępnia przez MCP#

Layer 1 - sterowanie (6 narzędzi)#

Dostępne od razu, bez dodatkowej konfiguracji:

Narzędzie	Opis
`vclu_devices`	Lista wszystkich urządzeń z ich stanem
`vclu_device_get`	Szczegóły konkretnego urządzenia
`vclu_device_set`	Ustaw wartość (włącz/wyłącz, jasność, pozycja)
`vclu_device_execute`	Wywołaj metodę (toggle, on, off)
`vclu_scenes`	Lista dostępnych scen
`vclu_scene_execute`	Uruchom scenę

Szczegółowa dokumentacja: Narzędzia Layer 1

Layer 2 - dev pipeline (17 narzędzi)#

Wymaga włączenia Dev Mode. Pozwala AI czytać kod, pisać moduły i testować w sandboxie:

Kategoria	Narzędzia	Opis
Eksploracja	`vclu_read_file`, `vclu_list_files`, `vclu_grep`, `vclu_logs`, `vclu_config`, `vclu_registry`	Czytanie kodu, logów, rejestru
Sandbox	`vclu_draft_write/read/list/delete`, `vclu_draft_validate`, `vclu_draft_test`, `vclu_draft_promote`, `vclu_diff`, `vclu_audit_log`	Pipeline draft > test > promote
Pamięć	`vclu_context_save`, `vclu_context_read`	Trwały kontekst między sesjami

Szczegółowa dokumentacja: Layer 2 - Przegląd

Zasoby (Resources)#

Zasoby dostarczają kontekst - AI może je przeczytać, żeby lepiej zrozumieć Twój dom:

URI	Opis
`vclu://devices`	Snapshot JSON wszystkich widocznych urządzeń
`vclu://device/{path}`	Szczegóły konkretnego urządzenia

Wymagania#

vCLU w wersji z obsługą MCP
Klient AI z obsługą MCP (Claude Code, Codex CLI, Gemini CLI, lub inny)
Połączenie sieciowe między klientem a vCLU (najczęściej sieć lokalna)

Następny krok#

Konfiguracja klientów AI - jak podłączyć Claude Code, Codex lub Gemini do vCLU