Nabu Casa

Überblick

Zusammenfassung der Dokumentation und Konfiguration von homeassistant-ai/ha-mcp, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich

Unterstützt

• Aktiv gepflegt Das Projekt hat in den letzten sechs Monaten eine neue Version oder Änderung veröffentlicht.

Einrichtung

Füge ihr App-Repository unter Einstellungen > Apps hinzu, installiere sie dann und starte sie.

Texte, für die das Repository keine Übersetzung hat, wurden automatisch übersetzt.

Aus der Dokumentation

Berechtigungen

• Host-NetzwerkNutzt direkt das Netzwerk des Hosts statt eines eigenen.
• Home Assistant-APIKann Home Assistant auslesen und steuern.
• Supervisor-APIKann mit dem Supervisor sprechen, der Apps und das System verwaltet.

Konfiguration

• Externe URL (optional)Öffentliche Basis-URL für den Fernzugriff (zum Beispiel https://example.customurl.com). Sie muss direkt auf Home Assistant zeigen: Beim Öffnen im Browser sollte die Anmeldeseite deines HA erscheinen. Sie darf keinen Port wie ":8123" (oder einen anderen Port) enthalten, sonst können Remote-MCP-Clients sie nicht erreichen. Leer lassen, um Nabu Casa automatisch zu erkennen.
• MCP-Server-URL (optional)Vollständige URL des MCP-Servers, an den weitergeleitet wird (zum Beispiel http://192.168.1.100:9583/private_abc123). Leer lassen, um ein laufendes HA MCP Addon automatisch zu finden.
• MCP-Server-Port (optional)Port, auf dem das MCP Addon lauscht. Wird nur bei der automatischen Erkennung verwendet. Standard: 9583.
• OAuth aktivieren (Beta)
• OAuth-Modus (Beta)Welcher OAuth-Modus verwendet wird, wenn Enable OAuth eingeschaltet ist. Lass diese Option UNSET (nicht gesetzt), außer du willst wechseln. Das Addon wählt automatisch den passenden Standard. - ha_auth: Melde dich mit deinem Home Assistant Konto an. Lass die OAuth-Felder des Connectors leer; funktioniert mit jedem Hostnamen und jeder URL; kein Neustart von Home Assistant nötig. Das ist der Standard beim erstmaligen Aktivieren von OAuth. - legacy: der bisherige Ablauf mit Client ID und Secret (veraltet) für Setups, die ihn noch brauchen. Wenn nichts gesetzt ist, bleiben Upgrades sicher: Wenn du bereits legacy-OAuth genutzt hast (eine konfigurierte oder gespeicherte Client ID/ein Secret), bleibt das Addon bei legacy, damit nichts kaputtgeht; andernfalls gilt ha_auth. Wenn du das änderst und neu startest, wechselt der Modus. Danach musst du deinen MCP-Connector löschen und neu hinzufügen.
• OAuth Client ID (Legacy-Modus; automatisch erzeugt, wenn leer)Nur im Legacy-OAuth-Modus (wird im ha_auth-Modus ignoriert). Client ID, die der MCP-Client (zum Beispiel Claude.ai) am OAuth-Token-Endpunkt vorlegen muss. Leer lassen, damit das Addon beim ersten Start einen Wert erzeugt (empfohlen); der erzeugte Wert wird in /data/oauth_creds.json gespeichert und bleibt über Neustarts gleich. Wenn du hier einen Wert setzt, muss er mindestens 16 Zeichen lang sein.
• OAuth Client Secret (Legacy-Modus; automatisch erzeugt, wenn leer)Nur im Legacy-OAuth-Modus (wird im ha_auth-Modus ignoriert). Client Secret, das der MCP-Client (zum Beispiel Claude.ai) am OAuth-Token-Endpunkt vorlegen muss. Leer lassen, damit das Addon beim ersten Start einen starken Zufallswert erzeugt (empfohlen). Behandle den Wert wie ein Passwort: Jeder, der ihn hat, kann den OAuth-Ablauf gegen deinen MCP-Server abschließen.
• OAuth-Zugangsdaten beim nächsten Start neu erzeugen (Legacy-Modus)Nur im Legacy-OAuth-Modus (wird im ha_auth-Modus ignoriert). Einmalige Aktion: Wenn du dies einschaltest und das Addon neu startest, werden die gespeicherte OAuth Client ID und das Client Secret gelöscht und neue Zufallswerte erzeugt. Die neuen Werte werden im Addon-Log ausgegeben und über Neustarts hinweg gespeichert. Das Addon versucht, diesen Schalter nach dem Neuerzeugen automatisch wieder auszuschalten, damit spätere Neustarts nicht erneut erzeugen. Wenn das fehlschlägt (ältere Supervisor-Versionen), weist dich das Addon-Log an, ihn manuell auszuschalten. Nutze dies, wenn du vermutest, dass deine OAuth-Zugangsdaten offengelegt wurden, oder einfach neue willst. Denke daran, danach deinen MCP-Client (zum Beispiel Claude.ai) mit den neuen Werten zu aktualisieren.
• Eingehende Anfragen protokollieren (Beta)