HA-MCP Custom Component

Nach der Einrichtung

• Zusätzliche DateipfadePfade relativ zum Konfigurationsverzeichnis, einschließlich exakter Dateinamen wie sensor.yaml, oder Pfade unter /share, /media und /ssl (schreibgeschützt unter HAOS und Supervised). Für jeden Eintrag werden Lese- und Schreibrechte für diesen Pfad und alles darunter gewährt; gib jeden Pfad als separates Listenelement ein. Einträge werden wörtlich abgeglichen; Platzhalter wie * werden nicht unterstützt. Traversierungen und andere unzulässige Pfade werden verworfen.
• Zusätzliche YAML-Schreib-KeysTop-Level-Keys, die ha_config_set_yaml zusätzlich zu den eingebauten schreiben darf, für YAML-first-Integrationen auf dieser Installation (z. B. alert2). Vertrauensgrenzen-Keys werden verworfen.
• MCP-Server Listening-PortDer Port, auf dem dieser Server lauscht. Die ha-mcp App (Add-on) verwendet 9583, daher ist standardmäßig 9584 voreingestellt, damit beide nebeneinander laufen können – wenn du die App (Add-on) nicht nutzt, funktioniert jeder freie Port.
• NetzwerkzugriffWer sich direkt mit dem MCP-Server-Port verbinden kann. Lokales Netzwerk macht ihn von deinem lokalen Netzwerk aus erreichbar, mit dem geheimen Pfad als Anmeldeinformation, genau wie die App (Add-on). Nur dieses Gerät erlaubt Verbindungen ausschließlich vom Home Assistant-Gerät selbst – die Webhook-URL und das Seitenleisten-Panel funktionieren in beiden Fällen.
• AuthentifizierungsmodusWie sich MCP-Clients an der Webhook-URL ausweisen. Bei der geheimen URL ist der Link selbst die einzige Anmeldeinformation – OAuth läuft weiterhin für Clients, die es verwenden, und eine Anmeldung, die zu einer erlaubten Callback-URL zurückkehrt (siehe unten), wird automatisch genehmigt: Kein Login und keine Client-ID oder kein Secret erforderlich. Bei der Home Assistant-Anmeldung melden sich Clients wie claude.ai mit einem Home Assistant-Administratorkonto an (OAuth). Bei Legacy OAuth betreibt diese Integration einen eigenen Anmeldedienst und gibt eine Client-ID und ein Secret aus, die in Clients eingefügt werden können, die dies erfordern – ein Neustart von Home Assistant ist möglicherweise erforderlich, um es vollständig zu aktivieren oder zu deaktivieren.
• Legacy OAuth: benutzerdefinierte Client ID (optional)Ersetzt die automatisch generierte Legacy OAuth Client ID. Leer lassen, um die aktuelle zu behalten. Wird nur verwendet, während der Authentifizierungsmodus auf Legacy OAuth gesetzt ist.
• Legacy OAuth: benutzerdefiniertes Client Secret (optional)Ersetzt das automatisch generierte Legacy OAuth Client Secret. Leer lassen, um das aktuelle zu behalten. Wird nur verwendet, während der Authentifizierungsmodus auf Legacy OAuth gesetzt ist.
• Legacy OAuth: Client ID/Secret jetzt neu generierenEinmalige Aktion: erstellt eine neue Client ID und Secret für den Legacy OAuth Modus. Sie wird erst nach dem Home Assistant Restart wirksam, zu dem die Repair-Meldung auffordert – bis zum Restart funktionieren die vorherigen Client ID und Secret weiter, die neuen noch nicht. Löscht auch die beiden Override-Felder oben.
• Entwickler: ha-mcp Package OverrideLeer lassen, um den ha-mcp Server auszuführen, den diese Komponentengestaltung installiert hat. Nur zum Testen eines spezifischen ha-mcp Builds (eine Versionsbindung, ein Pull-Request-Tarball oder eine Wheel-URL); wird durch Neuladen des Servers angewendet, ohne Home Assistant neu zu starten. Leeren, um zum gekoppelten Server zurückzukehren.
• Home Assistant URL (erweitert)Die URL, die der In-Process-Server nutzt, um deinen Home Assistant zu erreichen (normalerweise diese Instanz selbst). Leer lassen, um sie aus Port und SSL-Einstellungen dieser Instanz abzuleiten; setze nur einen Wert, wenn der Server eine andere Route benötigt.
• Externe URL (optional)Wird als primäre Verbindungs-URL angezeigt – nutze dies, wenn Home Assistant hinter deiner eigenen Domain oder einem Reverse Proxy liegt. Gib die vollständige Basisadresse inklusive Schema ein. Sie muss direkt auf Home Assistant zeigen – beim Öffnen im Browser sollte deine HA-Login-Seite erscheinen – und darf keinen Port wie :8123 (oder einen anderen Port) enthalten, sonst können remote MCP-Clients sie nicht erreichen. Leer lassen, um automatisch Nabu Casa / die lokale Adresse zu verwenden.
• Benutzerdefiniertes Webhook-Secret (optional)Ersetzt das zufällige Webhook-Secret in der Verbindungs-URL (/api/webhook/...). Die URL ist das Credential – nutze einen langen, schwer zu erratenden Wert. Leer lassen, um das aktuelle zu behalten.
• Benutzerdefinierter Direktzugriffs-Pfad (optional)Ersetzt den zufälligen Pfad für den Direktzugriff auf dem Server-Port. Gleiche Regel: Der Pfad ist das Credential. Leer lassen, um den aktuellen zu behalten.
• Verbindungs-Secrets jetzt neu generierenEinmalige Aktion: erstellt ein neues zufälliges Webhook-Secret und einen Direktzugriffs-Pfad, wodurch die alten Verbindungs-URLs sofort ungültig werden. Löscht auch die beiden Override-Felder oben.
• Remote-Zugriff über WebhookAusschalten für nur-lokal-Modus: Der Home Assistant Webhook wird gar nicht registriert, sodass nichts – einschließlich Nabu Casa – den Server über Home Assistant erreichen kann. Der direkte Server-Port und das Sidebar-Panel funktionieren weiter.
• Conversation-Agent LLM API
• Conversation-Agent Tool-Bereitstellung