Konfiguracja klientów AI#

Aby klient AI mógł sterować urządzeniami, potrzebujesz dwóch rzeczy:

1. Włączony serwer MCP w vCLU (z wygenerowanym kluczem API)
2. Konfiguracja klienta wskazująca na adres vCLU

Krok 1 - Włączenie MCP w vCLU#

1. Otwórz panel webowy vCLU > MCP w menu bocznym
2. Zaznacz checkbox Enable MCP Server
3. Kliknij Generate API Key
4. Skopiuj klucz - wyświetla się tylko raz!

Klucz API jest wyświetlany jednorazowo po wygenerowaniu. Jeśli go zgubisz, wygeneruj nowy - stary zostanie unieważniony.

Zanotuj też adres vCLU - domyślnie: http://<ip-raspberry-pi>:9090/mcp

Krok 2 - Konfiguracja klienta AI#

Claude Code (Anthropic)#

Utwórz plik .mcp.json w katalogu projektu lub ~/.claude.json globalnie:

{
  "mcpServers": {
    "vclu": {
      "type": "http",
      "url": "http://192.168.1.100:9090/mcp",
      "headers": {
        "Authorization": "Bearer vclu_mcp_a1b2c3d4e5f6..."
      }
    }
  }
}

Po restarcie Claude Code powinien wykryć serwer automatycznie. Zweryfikuj komendą:

# W Claude Code wpisz:
"Pokaż listę urządzeń smart home"

OpenAI Codex CLI#

Edytuj ~/.codex/config.toml:

[mcp_servers.vclu]
url = "http://192.168.1.100:9090/mcp"
bearer_token_env_var = "VCLU_MCP_KEY"

Ustaw zmienną środowiskową z kluczem:

export VCLU_MCP_KEY="vclu_mcp_a1b2c3d4e5f6..."

Dodaj export VCLU_MCP_KEY=... do ~/.bashrc lub ~/.zshrc, żeby klucz był dostępny po restarcie terminala.

Google Gemini CLI#

Edytuj ~/.gemini/settings.json:

{
  "mcpServers": {
    "vclu": {
      "httpUrl": "http://192.168.1.100:9090/mcp",
      "headers": {
        "Authorization": "Bearer vclu_mcp_a1b2c3d4e5f6..."
      }
    }
  }
}

Inni klienci MCP#

vCLU używa standardowego transportu HTTP + SSE (Streamable HTTP). Każdy klient zgodny ze specyfikacją MCP powinien działać. Potrzebujesz:

• URL: http://<adres-vclu>:<port>/mcp
• Autoryzacja: nagłówek Authorization: Bearer <klucz-api>
• Transport: HTTP (nie stdio)

Weryfikacja połączenia#

Po skonfigurowaniu klienta przetestuj połączenie:

Ty:   "Jakie urządzenia są dostępne w moim domu?"

AI:   Masz dostępne następujące urządzenia:
      - Salon Kanapa (switch) - wyłączony
      - Salon Stół (switch) - wyłączony
      - Kuchnia LED (switch) - włączony
      - Biuro (switch) - włączony
      - Roleta Salon (cover) - pozycja 100%

Jeśli AI widzi urządzenia - wszystko działa.

Nie widzisz urządzeń? Sprawdź:

1. Czy MCP jest włączony w panelu vCLU (checkbox zaznaczony)
2. Czy klucz API jest poprawny (wygeneruj nowy w razie wątpliwości)
3. Czy klient ma dostęp sieciowy do vCLU (ping, firewall)
4. Czy urządzenia są wyeksponowane - MCP widzi tylko obiekty zarejestrowane przez expose() lub exposeRegistry() w Lua

Przykłady użycia#

Gdy połączenie działa, możesz sterować domem naturalnym językiem:

Podstawowe sterowanie#

"Włącz światło w kuchni"
"Zgaś wszystko w salonie"
"Jaki jest stan rolet?"
"Otwórz roletę w sypialni na 50%"

Sterowanie wieloma urządzeniami#

"Zgaś wszystkie światła oprócz biura"
"Włącz salon i kuchnię, zgaś resztę"
"Zamknij wszystkie rolety"

Sceny#

"Włącz tryb filmowy"
"Jakie sceny są dostępne?"
"Uruchom scenę dobranoc"

Zapytania o stan#

"Co jest włączone?"
"Ile urządzeń mam w salonie?"
"Czy coś jest włączone w kuchni?"

Złożone komendy#

"Przygotuj dom do snu - zgaś wszystkie światła,
 zamknij rolety i włącz lampkę nocną w sypialni"

"Rano o 7:00 zwykle włączam kuchnię i otwieram rolety
 w salonie - zrób to teraz"

AI samodzielnie rozpoznaje urządzenia po nazwach, filtruje po pokojach i wykonuje operacje w odpowiedniej kolejności.

Następny krok#

Narzędzia (Tools) - szczegółowy opis każdego narzędzia MCP