Dokumentácia

Kompletný sprievodca Loxone AI — ovládajte svoju inteligentnú domácnosť pomocou Claude a ďalších AI asistentov cez protokol MCP.

Rýchly štart

Začnite s Loxone AI v 3 krokoch:

Požiadavky

• Loxone Miniserver (Gen 1 alebo Gen 2) dostupný cez sieť
• Claude Desktop, Claude.ai, Cursor, Windsurf alebo akýkoľvek klient kompatibilný s MCP
• Sieťové pripojenie medzi Loxone Miniserverom a internetom, aby ho cloudový server mohol dosiahnuť

Cloud MCP

Cloud MCP server beží na našej infraštruktúre na adrese https://cloud.loxoneai.com/cloud/mcp. Vaše Loxone prihlasovacie údaje sú v našej databáze uložené zašifrované — na vašom počítači nie je potrebná žiadna inštalácia softvéru.

• Funguje odkiaľkoľvek — lokálna sieť nie je potrebná
• Dostupné pre všetkých registrovaných používateľov
• Podporuje Claude.ai (web), Claude Desktop, Cursor, Windsurf a ďalšie
• Všetka komunikácia je šifrovaná cez HTTPS / OAuth 2.0

Autentifikácia

Cloud MCP server používa OAuth 2.0. Autorizačný server je https://loxoneai.com.

• Authorization Code + PKCE — pre Claude.ai web a aplikácie, ktoré otvárajú okno prehliadača
• Client Credentials — pre headless klientov (Claude Desktop, Cursor, Windsurf) pomocou Bearer tokenu

Prístupový token alebo OAuth údaje získate v Dashboarde → záložka API Keys.

Konfigurácia aplikácie

Konfigurácie pre podporované aplikácie:

Claude.ai (web)

Používa OAuth Authorization Code flow — manuálna konfigurácia nie je potrebná. V Dashboarde kliknite na Connect to Claude.ai a autorizujte v prehliadači.

Claude Desktop

Alebo nakonfigurujte manuálne — pre ostatných klientov (Cursor, VS Code, Claude Code) je toto správny postup:

Konfiguračný súbor: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) alebo %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "loxone-cloud": {
      "command": "npx",
      "args": ["-y", "mcp-remote",
        "https://cloud.loxoneai.com/cloud/mcp",
        "--header", "Authorization: Bearer YOUR_ACCESS_TOKEN"]
    }
  }
}

Cursor

Konfiguračný súbor: ~/.cursor/mcp.json

{
  "mcpServers": {
    "loxone-cloud": {
      "url": "https://cloud.loxoneai.com/cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
      }
    }
  }
}

Windsurf

Konfiguračný súbor: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "loxone-cloud": {
      "serverUrl": "https://cloud.loxoneai.com/cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
      }
    }
  }
}

Continue

Konfiguračný súbor: ~/.continue/config.yaml

mcpServers:
  - name: loxone-cloud
    url: https://cloud.loxoneai.com/cloud/mcp
    requestOptions:
      headers:
        Authorization: "Bearer YOUR_ACCESS_TOKEN"

Cline

{
  "mcpServers": {
    "loxone-cloud": {
      "url": "https://cloud.loxoneai.com/cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
      }
    }
  }
}

Vlastná aplikácia / API

Získajte prístupový token cez OAuth 2.0 Client Credentials:

curl -X POST https://loxoneai.com/oauth/token \
  -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_SECRET"

Potom token odošlite ako Authorization: Bearer ACCESS_TOKEN na MCP endpoint.

Loxone Cloud

Zadávate len sériové číslo — pripojenie cez Loxone Cloud vytvoríme automaticky:

dns.loxonecloud.com/YOUR_SERIAL_NUMBER

Na Miniserveri musí byť povolený Remote Connect (Loxone Cloud). Sériové číslo nájdete v Loxone App: menu → ⓘ info.

Ako nájsť sériové číslo

Sériové číslo je MAC adresa Miniservera — vkladá sa do Cloud URL dns.loxonecloud.com/<serial>. Najjednoduchšie ho nájdeš v Loxone aplikácii:

1. Otvor Loxone aplikáciu a ťukni na menu (☰) vľavo hore.
2. Ťukni na ikonu info (ⓘ) vedľa názvu Miniservera.
3. Prečítaj riadok Sériové číslo — to je tvoja MAC (12 znakov, napr. 504F94XXXXXX).

Funkčné príklady

Tieto príklady demonštrujú základnú funkcionalitu Loxone AI MCP servera. Každý ukazuje príkaz v prirodzenom jazyku odoslaný AI, vykonané volanie MCP nástroja a očakávanú odpoveď.

"Zapni svetlá v obývačke"

{
  "tool": "loxone_light_on",
  "arguments": {
    "control": "Living Room"
  }
}

{
  "success": true,
  "message": "Light turned on: Living Room",
  "device": "Living Room",
  "action": "on"
}

"Aká je teplota v spálni?"

{
  "tool": "loxone_get_temperature",
  "arguments": {
    "room": "Bedroom"
  }
}

{
  "room": "Bedroom",
  "temperature_c": 21.4,
  "unit": "°C",
  "sensor": "Temperature Bedroom"
}

"Zatvor rolety v obývačke"

{
  "tool": "loxone_blind_down",
  "arguments": {
    "control": "Living Room"
  }
}

{
  "success": true,
  "message": "Blind moved down: Living Room",
  "device": "Living Room",
  "action": "down"
}

"Ukáž mi všetky zariadenia v mojej domácnosti"

{
  "tool": "loxone_list_devices",
  "arguments": {}
}

{
  "lights": [
    { "name": "Living Room", "room": "Living Room", "type": "LightControllerV2" },
    { "name": "Kitchen", "room": "Kitchen", "type": "Dimmer" }
  ],
  "blinds": [
    { "name": "Blind Living Room", "room": "Living Room", "type": "Jalousie" }
  ],
  "gates": [
    { "name": "Garage Door", "room": "Garage", "type": "Gate" }
  ],
  "thermostats": [
    { "name": "Temperature Bedroom", "room": "Bedroom", "type": "InfoOnlyAnalog" }
  ]
}

"Stlm svetlá v spálni na 30%"

{
  "tool": "loxone_dimmer",
  "arguments": {
    "control": "Bedroom",
    "value": 30
  }
}

{
  "success": true,
  "message": "Dimmer set to 30%: Bedroom",
  "device": "Bedroom",
  "value": 30
}

Príkazy v prirodzenom jazyku

Loxone AI rozumie prirodzenému jazyku. Tu sú príklady príkazov, ktoré môžete použiť:

Svetlá

"Zapni svetlá v obývačke"
"Vypni všetky svetlá"
"Stlm svetlá v spálni na 30%"
"Nastav svetlo v kuchyni na 80%"
"Ktoré svetlá sú momentálne zapnuté?"

Rolety a žalúzie

"Zatvor rolety v obývačke"
"Otvor všetky rolety"
"Nastav rolety na 50%"
"Zatvor žalúzie v spálni"

Teplota

"Aká je teplota v obývačke?"
"Ukáž teploty vo všetkých miestnostiach"
"Ktorá miestnosť je najteplejšia?"

Brány a garáž

"Otvor garážovú bránu"
"Zatvor vstupnú bránu"

Zariadenia

"Ukáž všetky zariadenia"
"Aké zariadenia sú v kuchyni?"
"Vypíš všetky svetlá"

Podporované zariadenia

Referencia MCP nástrojov

Loxone AI MCP server sprístupňuje 32 nástrojov. Kľúčové nástroje:

loxone_list_devices

Vráti všetky zariadenia zoskupené podľa kategórie (svetlá, rolety, brány, termostaty, prítomnosť, senzory).

loxone_light_on / loxone_light_off

Zapne alebo vypne svetlo či miestnosť. Parameter: control — názov zariadenia alebo miestnosti.

loxone_dimmer

Nastaví jas svetla. Parametre: control (zariadenie/miestnosť), value (0–100).

loxone_blind_up / loxone_blind_down

Úplne otvorí alebo zatvorí roletu. Parameter: control — názov zariadenia alebo miestnosti.

loxone_blind_position

Nastaví roletu do konkrétnej polohy. Parametre: control, position (0=otvorené, 100=zatvorené).

loxone_get_temperature

Prečíta aktuálnu teplotu zo senzora v miestnosti. Parameter: room.

loxone_get_room_climate

Zobrazí kompletný prehľad klímy v miestnosti: teplota, vlhkosť, cieľová teplota, režim termostatu.

loxone_get_room_summary

Kompletný prehľad miestnosti: všetky svetlá, rolety, teplota, vlhkosť, prítomnosť.

loxone_get_all_lights_status

Stav zapnutia/vypnutia/stmievania všetkých svetiel v celej domácnosti, zoskupený podľa miestností.

loxone_gate_open / loxone_gate_close

Otvorí alebo zatvorí bránu či garážové dvere. Parameter: control.

loxone_get_weather

Vonkajšie počasie: teplota, rýchlosť vetra, dážď, jas, varovania pred búrkou.

loxone_get_energy

Údaje o spotrebe a výrobe energie (sieť, fotovoltika, batéria).

Riešenie problémov

Claude nevidí nástroje Loxone

Nedá sa pripojiť k Loxone

Zariadenia sa nenašli

Cloud prístup nefunguje