Claude mit MCP und Home Assistant verbinden
Verbinden Sie Claude über den integrierten MCP-Server mit Home Assistant. Nutzen Sie einen sicheren öffentlichen HTTPS-Zugang und ein eigenes Konto mit Leserechten.
So verbinden Sie Claude über MCP mit Home Assistant
Um Claude über MCP mit Home Assistant zu verbinden, aktivieren Sie die integrierte Model Context Protocol-Integration von Home Assistant und fügen deren Adresse in Claude als benutzerdefinierten Connector hinzu. Claude meldet Sie anschließend über den eigenen OAuth-Anmeldedialog von Home Assistant an. OAuth ist ein offener Standard, der einer Anwendung Zugriff gewährt, ohne dass Sie Ihr Passwort weitergeben müssen. Zuerst benötigt Home Assistant eine öffentliche HTTPS-Adresse. Diese Adresse verursacht den größten Teil des Aufwands, weil Claude über die Cloud von Anthropic auf Ihr Heimnetz zugreift, auch wenn Sie Claude Desktop verwenden.
MCP (Model Context Protocol) ist ein offener Standard, über den ein KI-Client Tools auf einem anderen Server aufrufen kann. Home Assistant liefert die MCP Server-Integration seit Release 2025.2 aus. Mit diesen Tools können Sie den Status Ihres Zuhauses lesen und es mit den passenden Optionen steuern. Die eigentliche Entscheidung betrifft daher die Sicherheit. Wer kann die von Ihnen veröffentlichte Adresse erreichen, und was darf das dahinterliegende Konto tun? Wenn Sie noch entscheiden, welchen Platz MCP unter den anderen Möglichkeiten zur Erweiterung von Claude einnimmt, beginnen Sie mit dem Vergleich von MCP mit Agent Skills und Rules-Dateien.
Dieser Leitfaden wurde am 15 November 2026 anhand der Dokumentation von Home Assistant, Anthropic, Tailscale, Caddy und Nabu Casa geprüft. Das aktuelle Home Assistant Release an diesem Tag war 2026.11.1. Einige der folgenden Optionen sind erst wenige Monate alt. Aktualisieren Sie Home Assistant daher, bevor Sie beginnen.
Warum Claude Home Assistant im öffentlichen Internet benötigt
Im Hilfeartikel von Anthropic zu benutzerdefinierten Konnektoren steht es direkt: „Claude verbindet sich von der Cloud-Infrastruktur von Anthropic aus mit Ihrem entfernten MCP-Server und nicht von Ihrem lokalen Gerät.“ In der Dokumentation von Home Assistant steht für die Desktop-App dasselbe: „Claude verbindet sich mit Ihrem MCP-Server aus der Cloud, auch wenn Sie Claude Desktop verwenden.“
Daraus folgen zwei Anforderungen. Ihr Server muss aus den IP-Adressbereichen von Anthropic über das öffentliche Internet erreichbar sein. Außerdem muss er am standardmäßigen HTTPS-Port 443 antworten. Daher kann http://homeassistant.local:8123 niemals als Konnektor-URL funktionieren. Die Server von Anthropic können keinen Namen auflösen, der nur in Ihrem Heimnetz vorhanden ist. Port 8123 ist außerdem nicht Port 443.
Claude Desktop verfügt über einen zweiten Mechanismus. Lokale MCP-Server in claude_desktop_config.json verwenden Ihr lokales Netzwerk. Sie sind von Konnektoren getrennt und nicht auf claude.ai oder in Cowork-Sitzungen verfügbar, die in der Cloud ausgeführt werden. Die Dokumentation von Home Assistant beschreibt für Claude Desktop nur den Konnektorpfad. Daher verwendet diese Anleitung diesen Pfad.
Claude Code funktioniert anders. Es wird auf Ihrem eigenen Computer oder Server ausgeführt und stellt die MCP-Verbindung selbst her. Daher muss die URL nur von diesem Rechner aus erreichbar sein. Home Assistant weist darauf hin: „Claude Code verbindet sich ausschließlich über HTTPS mit MCP-Servern.“ Eine private HTTPS-Adresse innerhalb Ihres eigenen Netzwerks funktioniert daher ebenfalls. Der Unterschied zwischen Tailscale Serve und Tailscale Funnel besteht genau in dieser Auswahl: Serve stellt eine private HTTPS-Adresse in Ihrem Tailnet bereit. Funnel stellt eine öffentliche Adresse bereit.
Benutzerdefinierte Konnektoren sind in den Tarifen Free, Pro, Max, Ultra, Team und Enterprise verfügbar. Nutzer des Tarifs Free sind auf einen benutzerdefinierten Konnektor beschränkt. Diese Einschränkung wird in den Inhalten des Claude-Tarifs Free behandelt.
MCP-Server-Integration aktivieren
- Öffnen Sie in Home Assistant Settings > Devices & services und wählen Sie Add Integration.
- Wählen Sie in der Liste Model Context Protocol aus und folgen Sie den Anweisungen auf dem Bildschirm.
- Öffnen Sie Settings > System > AI. Wenn die Karte Model Context Protocol die Schaltfläche Enable anzeigt, wählen Sie sie aus.
- Kopieren Sie die Main URL. Ihr Pfad lautet
/api/mcp.
Die vollständige Connector-URL besteht aus Ihrem öffentlichen Hostnamen und diesem Pfad, zum Beispiel https://ha.example.com/api/mcp. Der Hostname hängt vom weiter unten gewählten Zugriffsweg ab.
Was die Haupt-URL standardmäßig offenlegt
Für die Haupt-URL gibt es drei Optionen. Sie gelten nur für /api/mcp. Lesen Sie sie, bevor Sie etwas verbinden.
- Alle KI-Tools offenlegen ist standardmäßig aktiviert. Die Haupt-URL legt dann jede Tool-Gruppe offen, einschließlich Gruppen, die Integrationen später hinzufügen. Eine dieser Gruppen heißt Home Assistant. In der Dokumentation heißt es, dass sie „alle Entitäten, Logs und den Verlauf lesen und jede Aktion ausführen kann“.
- Administratorkonto erforderlich ist standardmäßig aktiviert. Wenn die Haupt-URL die Home-Assistant-Gruppe offenlegt, ist unabhängig von dieser Einstellung immer ein Administratorkonto erforderlich.
- Nur-Lesezugriff ist standardmäßig deaktiviert. Wenn Sie die Option aktivieren, legt die Haupt-URL nur Tools offen, die als nicht verändernd gekennzeichnet sind, beispielsweise zum Abrufen des aktuellen Zustands Ihrer Wohnung.
- Bei älteren Setups sind zwei dieser Optionen deaktiviert. Für „Alle KI-Tools offenlegen“ heißt es in der Dokumentation, dass die Option „deaktiviert bleibt, damit Ihre Clients die von Ihnen ausgewählten Tools behalten“. Die Administratoreinstellung „bleibt deaktiviert, damit Ihre Clients weiter funktionieren“. Wenn Ihr MCP-Server-Eintrag älter als diese Optionen ist, öffnen Sie seine Optionen und prüfen Sie die Einstellungen.
Deaktivieren Sie „Alle KI-Tools offenlegen“, um Tool-Gruppen einzeln auszuwählen. Die Gruppe Device control stellt der KI dieselben Tools wie Ihr Sprachassistent bereit. Sie „greift nur auf die Entitäten zu, die Sie für Sprachassistenten offenlegen“. Für die Home-Assistant-Gruppe gilt diese Einschränkung nicht.
Für einzelne Tool-Gruppen gibt es außerdem separate URLs. /api/mcp/assist legt nur Device control offen. Diese URLs ignorieren die drei oben genannten Optionen. Sie sind niemals schreibgeschützt. Für alle URLs außer der Device-control-URL ist ein Administratorkonto erforderlich.
Prüfen Sie, worauf Device control zugreifen kann, bevor Sie der Funktion vertrauen. Assist legt neue Entitäten standardmäßig offen. Dazu gehören auch Covers. Die Home-Assistant-Dokumentation ist eindeutig: „Covers umfassen Garagentore und Tore. Deshalb legt Home Assistant sie ebenfalls automatisch offen.“ Schlösser, Alarmanlagen und Scripts werden nicht automatisch offengelegt. Öffnen Sie die Einstellungen für die Assist-Freigabe. Entfernen Sie alle Entitäten, die ein Chatfenster nicht öffnen können soll.
Ein dediziertes Konto statt des Eigentümers verwenden
Wenn Sie in Claude Connect auswählen, melden Sie sich im Browser bei Home Assistant an. Die Zugriffsrechte, die Claude erhält, gehören zu dem Konto, mit dem Sie sich anmelden. Wenn Sie sich als Eigentümer anmelden, agiert Claude als Eigentümer und verfügt über alle Rechte dieses Kontos.
Erstellen Sie in Home Assistant eine separate Person mit eigener Anmeldung und verwenden Sie dieses Konto ausschließlich für Claude. Um Claudes Zugriff später zu widerrufen, löschen Sie dieses eine Konto. Ihre eigene Anmeldung bleibt davon unberührt. Wählen Sie anschließend eine von zwei Konfigurationen.
Eingeschränkt: Claude steuert einige Geräte. Lassen Sie das Konto als normalen Benutzer und nicht als Administrator bestehen. Deaktivieren Sie in den Optionen der Haupt-URL Expose all AI tools, wählen Sie nur Device control aus und deaktivieren Sie Require an administrator account. Claude kann dann nur auf die für die Sprachsteuerung freigegebenen Entitäten zugreifen. Aktivieren Sie zusätzlich Read-only, wenn Claude den Status nur melden soll. Alternativ können Sie /api/mcp/assist verwenden. Dafür sind keine Administratorrechte erforderlich. Diese URL ignoriert die Einstellung Read-only jedoch.
Umfassend: Claude liest Protokolle und Verlauf. Das Home-Assistant-Toolset benötigt immer ein Administratorkonto. Machen Sie das dedizierte Konto zum Administrator, halten Sie es aber vom Eigentümerkonto getrennt und aktivieren Sie Read-only. Claude kann dann Entitäten, Protokolle und den Verlauf lesen. Werkzeuge, die Änderungen vornehmen, werden nicht freigegeben.
Prüfen Sie während des Connect-Schritts, mit welchem Konto Sie sich anmelden. Wenn Sie diesen Schritt in einem privaten Browserfenster ausführen, können Sie Ihre Eigentümersitzung nicht versehentlich wiederverwenden.
Verlassen Sie sich nicht auf Bestätigungsabfragen im Client als Schutzmaßnahme. Im Connector-Ablauf wird laut der Home-Assistant-Dokumentation vor jedem Aufruf eines Werkzeugs eine Berechtigung von Claude angefordert. Claude Code verhält sich anders. Ab v2.1.283 ist auto mode der anfängliche Berechtigungsmodus für interaktive Sitzungen im Terminal und in VS Code. auto mode fragt nicht vor jeder Aktion nach. Home Assistant selbst setzt die Rechte des Kontos und die Einstellung Read-only durch, unabhängig von der Entscheidung des Clients.
Wie sollte Claudes Cloud Home Assistant erreichen?
Der Rest dieses Abschnitts beschreibt das eigene Bedrohungsmodell dieses Leitfadens. Es wurde aus der Dokumentation der einzelnen Dienste abgeleitet. Keiner dieser Anbieter erklärt in seiner Dokumentation, wovor sein Übertragungsweg nicht schützt. Betrachten Sie diesen Abschnitt daher als Überlegung und nicht als Aussage der Anbieter.
Jeder unten beschriebene Weg hat eines gemeinsam: Jeder, der die URL erreichen kann, kann auch die Anmeldeseite von Home Assistant erreichen. Richten Sie daher zuerst den Anmeldeschutz ein. Aktivieren Sie unter Settings > System > Network im Abschnitt HTTP server die Option Enable IP banning. Legen Sie anschließend Login attempts before ban fest. Diese Option akzeptiert Werte von 1 bis 1000 und wird nur angezeigt, wenn Unlimited login attempts deaktiviert ist. Aktivieren Sie hinter jedem Proxy oder Tunnel außerdem Trust X-Forwarded-For und fügen Sie die Adresse des Proxys zu Trusted proxies hinzu. Die Dokumentation von Home Assistant warnt: "Requests from reverse proxies are blocked if these options are not set." Vor Home Assistant 2026.8 befanden sich diese Einstellungen im Block http: von configuration.yaml.
Nabu Casa Remote-UI (Home Assistant Link)
Der Dienst von Nabu Casa heißt jetzt Home Assistant Link (zuvor Home Assistant Cloud). Am 15. November 2026 nannte die Preisseite einen Preis von $6.50 USD pro Monat oder $65.00 USD pro Jahr, jeweils ohne Steuern. Außerdem wurde eine kostenlose 31-Tage-Testphase ohne erforderliche Kreditkarte aufgeführt. Der Fernzugriff gehört zu den aufgeführten Vorteilen.
Was freigegeben wird: Ihre gesamte Weboberfläche von Home Assistant einschließlich der Anmeldeseite über eine öffentliche HTTPS-Adresse. Was dadurch nicht abgedeckt ist: ein schwaches Kennwort für das von Claude verwendete Konto oder ein Token, das an anderer Stelle offengelegt wird. Die Support-Website von Nabu Casa konnte beim Erstellen dieses Leitfadens nicht geladen werden. Lesen Sie die eigene Dokumentation, um zu erfahren, was das Relay sehen kann und was nicht.
Tailscale Funnel
Funnel leitet Netzwerkverkehr aus dem öffentlichen Internet an einen lokalen Dienst weiter. Laut Tailscale ist der Dienst in allen Tarifen verfügbar. Er benötigt Tailscale v1.38.3 oder höher, MagicDNS, gültige HTTPS-Zertifikate für Ihr Tailnet und ein Funnel-Knotenattribut in der Richtliniendatei Ihres Tailnets. Er kann nur auf den Ports 443, 8443 und 10000 lauschen. Port 443 ist der Port, den Claude benötigt. Wenn diese Anforderungen für Sie neu sind, erklärt was Tailscale ist und wie ein Tailnet funktioniert die Grundlagen. Führen Sie auf dem Rechner, auf dem Home Assistant läuft, folgenden Befehl aus:
sudo tailscale funnel 8123Tailscale gibt eine öffentliche https://<machine>.<tailnet>.ts.net-Adresse aus, die als Proxy an http://127.0.0.1:8123 weiterleitet. Verwenden Sie diesen Hostnamen in der Connector-URL. Fügen Sie 127.0.0.1 in Home Assistant zu Trusted proxies hinzu, weil jede Anfrage jetzt vom lokalen Tailscale-Proxy kommt. Der Befehl läuft im Vordergrund, bis Sie Ctrl+C drücken.
Was freigegeben wird: der gesamte Home-Assistant-Port für jeden im Internet. Besucher von Funnel benötigen Tailscale nicht. Ihr privates Tailnet stellt für sie daher keine zusätzliche Barriere dar. Für Funnel-Netzwerkverkehr gelten außerdem Bandbreitenlimits, die Sie nicht konfigurieren können.
Cloudflare Tunnel
Cloudflare Tunnel verwendet eine ausschließlich ausgehende Verbindung. Der cloudflared-Daemon in Ihrem Netzwerk verbindet sich nach außen mit Cloudflare. Dadurch müssen Sie keinen eingehenden Port öffnen und benötigen zu Hause keine öffentliche IP-Adresse.
Was freigegeben wird: der von Ihnen veröffentlichte Hostname für das gesamte Internet, sofern Sie keine vorgeschalteten Regeln hinzufügen. Eine Regel, nach der sich eine Person zuerst bei Cloudflare anmelden muss, muss die von Anthropic veröffentlichten IP-Adressbereiche durchlassen. Claudes Cloud kann keine Anmeldeseite ausfüllen. Die MCP-Anfragen würden daher bei Cloudflare beendet. Fügen Sie die von cloudflared für den Zugriff auf Home Assistant verwendete Adresse zu Trusted proxies hinzu.
Ein Reverse Proxy auf einem VPS
Bei diesem Weg kontrollieren Sie den Server, der dem Internet zugewandt ist. Ein kleiner VPS (virtual private server) mit einer öffentlichen IP-Adresse führt den Reverse Proxy aus. Er erreicht Home Assistant zu Hause über eine private Verbindung, beispielsweise ein Tailnet. Zu Hause wird nichts für das Internet geöffnet. Sie können außerdem den Zugriff auf den Proxy selbst beschränken.
Anthropic veröffentlicht die IP-Adressen, die für ausgehende Anfragen verwendet werden, "for example, when making MCP tool calls to external servers." Am 15. November 2026 führte die Seite zwei ausgehende IPv4-Bereiche in CIDR-Notation und keinen ausgehenden IPv6-Bereich auf. Übernehmen Sie am Tag der Einrichtung die aktuellen Bereiche von Anthropic's IP address page. Die Seite führt außerdem alte, nicht mehr verwendete Adressen auf. Verwenden Sie daher nur die aktuellen ausgehenden Bereiche.
Wenn Caddy auf dem VPS installiert ist, kann /etc/caddy/Caddyfile jede Verbindung verwerfen, die nicht aus diesen Bereichen kommt:
ha.example.com {
@blocked not remote_ip <anthropic-range-1> <anthropic-range-2> 203.0.113.25
abort @blocked
reverse_proxy 100.101.102.103:8123
}Ersetzen Sie <anthropic-range-1> und <anthropic-range-2> durch die ausgehenden IPv4-Bereiche von der Anthropic-Seite, 203.0.113.25 durch Ihre eigene öffentliche IP-Adresse und 100.101.102.103 durch die Adresse von Home Assistant in Ihrem Tailnet. Ihre eigene IP-Adresse steht in der Liste, weil der Connect-Schritt die Anmeldeseite von Home Assistant in Ihrem Browser öffnet. Diese Anfrage kommt von Ihnen und nicht von Anthropic. Wenn Connect bei einer Seite hängen bleibt, die nie geladen wird, fehlt Ihre Adresse in der Liste. Caddy setzt die Header X-Forwarded-For, X-Forwarded-Proto und X-Forwarded-Host standardmäßig und leitet WebSocket-Verbindungen weiter. Außerdem bezieht Caddy ein TLS-Zertifikat (transport layer security) für den Hostnamen selbst, sofern der DNS-Eintrag des Hostnamens auf den VPS zeigt.
caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddycaddy validate sollte ohne Fehler beendet werden. Von einer Adresse außerhalb der Liste sollte curl -I https://ha.example.com/ überhaupt keine HTTP-Antwort erhalten, weil abort die Verbindung schließt. Fügen Sie zuletzt die Tailnet-Adresse des VPS in Home Assistant zu Trusted proxies hinzu.
Wovor der Weg nicht schützt: Alle Claude-Benutzer verwenden gemeinsam die IP-Bereiche von Anthropic. Die Allowlist hält zufällige Scanner fern. Jeder, der Ihre URL kennt und sie als eigenen Connector hinzufügt, erreicht weiterhin Ihre Anmeldeseite. Das Kontokennwort und IP banning bleiben daher wichtig. Außerdem müssen Sie nun einen VPS aktuell halten und absichern.
Welchen Weg sollten Sie wählen?
Nabu Casa ist am schnellsten eingerichtet und benötigt keinen eigenen Server. Funnel und Cloudflare Tunnel vermeiden das Öffnen eines Ports zu Hause. Beide stellen jedoch die vollständige Anmeldeseite im offenen Internet bereit. Der VPS-Proxy verursacht den größten Einrichtungsaufwand und bietet die geringste Angriffsfläche, weil nur die Bereiche von Anthropic und Ihre eigene Adresse eine Verbindung öffnen können. Bei jedem Weg schützen Sie das dedizierte Konto und der Read-only-Schalter stärker als die Wahl des Übertragungswegs.
Connector in Claude hinzufügen
- Öffnen Sie auf claude.ai Customize > Connectors und wählen Sie + Add > Add custom connector. In Claude Desktop verweisen die Home-Assistant-Dokumente auf Settings > Connectors und anschließend auf Add > Add custom connector.
- Nennen Sie den Connector
Home Assistantund fügen Sie die vollständige URL ein, zum Beispielhttps://ha.example.com/api/mcp. - Setzen Sie Authentication auf Sign in now und OAuth client auf Use Claude's published identity. Wählen Sie anschließend Add.
- Wählen Sie auf der Seite des neuen Connectors Connect und melden Sie sich mit dem dafür eingerichteten Konto bei Home Assistant an.
Bei einem Team- oder Enterprise-Plan fügt ein Owner den Connector unter Organization settings > Connectors hinzu. Jedes Mitglied findet ihn anschließend unter Customize > Connectors und wählt Connect. Dadurch führt jedes Mitglied die Anmeldung bei Home Assistant selbst durch.
Sie wählen die veröffentlichte Identität aufgrund der OAuth-Implementierung von Home Assistant. Home Assistant implementiert OAuth 2.0 mit PKCE (proof key for code exchange). Die Software unterstützt OAuth Client ID Metadata Documents. Dadurch werden die Client-ID und die Callback-URL automatisch eingerichtet. Home Assistant verwendet kein Client-Secret. Die Software unterstützt außerdem RFC 7591 Dynamic Client Registration nicht. In der Dokumentation steht, dass Clients, die dies strikt voraussetzen, „cannot register automatically“. Für andere MCP-Clients wird in der Dokumentation angegeben, dass die Client-ID die Basis-URL der Client-Anwendung sein muss, „never your Home Assistant instance URL.“
Home Assistant zu Claude Code hinzufügen
claude mcp add --transport http home-assistant https://ha.example.com/api/mcp
claude mcp login home-assistantclaude mcp login führt den OAuth-Ablauf des Servers aus Ihrer Shell aus. Für SSH-Sitzungen auf einem Remote-Server akzeptiert es außerdem --no-browser. Standardmäßig verwendet claude mcp add den lokalen Gültigkeitsbereich. Dadurch ist der Server auf das aktuelle Projekt auf diesem Rechner beschränkt. Fügen Sie --scope user hinzu, um ihn in jedem Projekt verfügbar zu machen. In Claude Code zeigt /mcp an, ob der Server verbunden ist. Wenn Claude Code unter Linux läuft und noch nicht eingerichtet wurde, wird die Installation unter Claude auf dem Linux-Desktop und in der CLI ausführen beschrieben.
Langlebige Tokens oder OAuth: Was meinen ältere Anleitungen?
Ältere Anleitungen empfehlen, ein langlebiges Zugriffstoken zu erstellen. Das war zum Zeitpunkt ihrer Veröffentlichung korrekt. Es gab kein einzelnes Home Assistant Release, das den Wechsel von Tokens zu OAuth ausgelöst hat. Die Umstellung erfolgte schrittweise:
- In der ersten MCP Server-Dokumentation für 2025.2 hieß es: „For now, we can use Long-lived access token to control access to the API.“
- Seit dem 31. März 2025 beschreibt die Dokumentation OAuth über IndieAuth. Sie weist außerdem darauf hin, dass einige MCP-Clients Zugriffstokens, aber kein OAuth unterstützen.
- PKCE mit der Methode S256 ist erstmals im Home Assistant-Quellcode am Tag 2026.10.0 enthalten. Im Quellcode von 2026.9.0 ist es nicht enthalten.
- Auf der aktuellen Seite zum MCP Server werden langlebige Tokens nicht erwähnt.
Eine Anleitung, die ein Token in einen Request-Header einfügt, beschreibt eine ältere Konfiguration. Verwenden Sie stattdessen die oben beschriebenen aktuellen OAuth-Schritte.
Wann ist der Community-Server ha-mcp die bessere Wahl?
ha-mcp ist ein separates Projekt unter der MIT-Lizenz. Die README im Tag v9.2.0 listet 87 Tools auf. In der README des Standard-Branches werden bereits 86 Tools genannt. Die Anzahl ändert sich daher zwischen den Builds. Wählen Sie ha-mcp, wenn Sie eine größere, speziell dafür entwickelte Tool-Liste benötigen, als die integrierten Tool-Sets bieten, und ein anderes Anmeldedatenmodell akzeptieren.
Die empfohlene Installation in v9.2.0 ist die HA-MCP-Integration. Sie läuft innerhalb von Home Assistant und benötigt Home Assistant 2026.8.0 oder neuer. In den Versionen 2026.8 bis 2026.10 installieren Sie sie über HACS (den Home Assistant Community Store). Ab 2026.11 ist sie unter Settings > Marketplace verfügbar. Fügen Sie nach einem Neustart unter Settings > Devices & services > Add Integration den Eintrag HA-MCP Server hinzu. Die Integration verwendet die Berechtigungen eines Administrators. Die eigene Dokumentation empfiehlt daher ein separates HA-MCP-Konto. Das Projekt stellt außerdem ein Docker-Image, ein PyPI-Paket und eine Home-Assistant-App (Add-on) bereit. In der README wird zudem ein lokaler stdio-Modus beschrieben, der nur zum Testen vorgesehen ist.
Stabile Version festlegen
Am 15. November 2026 war v9.2.0 die aktuelle stabile Version. Sie wurde am 11. November veröffentlicht. Entwicklungs-Builds (.devN) werden bei jedem Push auf master veröffentlicht. In den 24 Stunden vor dieser Prüfung wurden fünf Dev-Tags erstellt. Die Empfehlung des Projekts ist eindeutig: „Dev-Releases (.devN) können Fehler enthalten. Verwenden Sie in Produktionsumgebungen ausschließlich stabile Releases.“ Installieren Sie das Release v9.2.0 und keinen .devN-Build. Die Tags :latest und :stable des Docker-Images verweisen auf stabile Releases und niemals auf Dev-Builds. Wenn Sie es mit uvx ausführen, endet der Befehl aus der README mit @latest. Ersetzen Sie dies durch @9.2.0, da die @-Syntax von uv eine exakte Version erwartet. Für das PyPI-Paket wird Python 3.13 oder 3.14 benötigt.
Die private_ URL ist das Passwort
Der integrierte Server fordert Claude zur Anmeldung auf. Der Hauptmodus von ha-mcp tut dies nicht. In Ihrem Netzwerk sieht die Adresse beispielsweise so aus: http://<ha-ip>:9584/private_<random>. Für den Fernzugriff handelt es sich um eine Webhook-URL wie https://<your-ha-domain>/api/webhook/<webhook-id>. In der Projektdokumentation steht: „Der Pfad ist die Zugangsinformation.“ Außerdem wird empfohlen: „Behandeln Sie die URL wie ein Passwort: Geben Sie sie nicht weiter und fügen Sie sie nicht an Stellen ein, an denen sie protokolliert werden könnte.“ Jeder, der die vollständige URL kennt, erreicht Ihren MCP-Server. Dazwischen gibt es keine Anmeldeseite.
Dadurch ändert sich das Bedrohungsmodell. Eine URL, die in einen gemeinsam genutzten Chat eingefügt oder in einem Proxy-Log hinterlassen wird, ermöglicht den vollständigen Zugriff. Wenn eine URL offengelegt wurde, erzeugen Sie eine neue Webhook-ID und ersetzen Sie die alte URL. Fügen Sie /readonly am Ende des Endpunkts hinzu, um eine Verbindung zu erhalten, die Schreib-Tools ausblendet und Schreibaufrufe blockiert. Der Fernzugriff funktioniert über die Remote-UI von Nabu Casa oder über einen bereits betriebenen Reverse Proxy. Für Cloudflare Tunnel verweist die README auf den Setup Wizard.
ha-mcp bietet außerdem einen als Beta gekennzeichneten OAuth-Modus. Dabei muss jeder Benutzer weiterhin ein langlebiges Home-Assistant-Zugriffstoken in ein Zustimmungsformular einfügen. Dieser Mechanismus unterscheidet sich von der Anmeldung beim integrierten Server.
Warum schlägt die Anmeldung des Connectors fehl?
Die Anmeldeseite wird nicht angezeigt, oder Claude meldet, dass der Server nicht erreichbar ist. Die Cloud von Anthropic kann die URL nicht erreichen. Testen Sie sie über Port 443 aus einem Netzwerk außerhalb Ihres Heimnetzwerks. Prüfen Sie auch Ihre Allowlist, falls Sie eine verwenden.
Die Anmeldung schlägt hinter einem Proxy mit OAuth-Fehlern fehl. Die Home-Assistant-Dokumentation nennt die Ursache: Die Reverse-Proxy-Header (X-Forwarded-Host, X-Forwarded-Proto) fehlen oder stimmen nicht überein. In der Dokumentation steht außerdem: „Conforming OAuth clients reject this metadata.“ Die von Home Assistant erzeugte URL muss exakt mit dem Hostnamen und dem Schema übereinstimmen, die Claude verwendet hat. Korrigieren Sie die Proxy-Header und die Einstellung für vertrauenswürdige Proxys.
Eine Anfrage an /register gibt 404 zurück. Der Client hat die dynamische Clientregistrierung verwendet. Diese wird von Home Assistant nicht unterstützt. Setzen Sie den OAuth-Client in Claude auf Use Claude's published identity.
Ein bekanntes offenes Problem. Am 15. November 2026 meldet Issue #183050, dass ein claude.ai-Connector mit /api/mcp auf Core 2026.11.0 fehlschlägt. Das Issue ist offen und als needing more information markiert. Ein Fix wurde noch nicht bestätigt. Testen Sie Ihren Connector, bevor Sie sich darauf verlassen.
FAQ
Verbindet sich Claude Desktop von meinem eigenen Computer mit Home Assistant?
Nicht bei einem benutzerdefinierten Connector. Anthropic und Home Assistant geben beide an, dass Claude die Verbindung aus der Cloud von Anthropic herstellt, auch in Claude Desktop. Deshalb benötigt Home Assistant eine öffentliche HTTPS-Adresse auf Port 443. Ausnahmen sind lokale Server in claude_desktop_config.json und Claude Code, die eine Verbindung von Ihrem eigenen Rechner herstellen.
Kann Claude über Home Assistant MCP meine Garagentür öffnen?
Ja, sofern das Konto und die Tool-Sammlung dies erlauben. Assist stellt neue Covers standardmäßig bereit. Covers umfassen auch Garagentüren und Tore, sodass die Tool-Sammlung Device control sie normalerweise erreichen kann. Die Tool-Sammlung Home Assistant kann jede Aktion ausführen. Wenn Claude die Covers nicht bewegen soll, entfernen Sie diese Entitäten aus der Assist-Bereitstellung oder aktivieren Sie Read-only für die Haupt-URL.
Benötige ich für den Home Assistant MCP-Server weiterhin ein langlebiges Zugriffstoken?
Nicht für den integrierten Server. Die aktuelle Dokumentation verwendet OAuth 2.0 mit PKCE und erwähnt keine langlebigen Tokens. Tokens waren in der ersten Dokumentation für 2025.2 die verwendete Methode. Der Community-Server ha-mcp ist davon abweichend: Sein Beta-OAuth-Modus fordert weiterhin dazu auf, ein langlebiges Token einzufügen.
Ich bin nach mehreren fehlgeschlagenen Verbindungsversuchen aus Home Assistant ausgesperrt. Was ist passiert?
IP-Banning hat die Adresse blockiert, von der die fehlgeschlagenen Anmeldeversuche ausgingen. Laut der Home-Assistant-Dokumentation ist die wahrscheinlichste Ursache ein falsches OAuth-Detail, beispielsweise die Client-ID oder die Home-Assistant-URL. Öffnen Sie ip_bans.yaml in Ihrem Home-Assistant-Konfigurationsverzeichnis, entfernen Sie den Eintrag für die blockierte Adresse und starten Sie Home Assistant neu. Korrigieren Sie die Connector-Einstellungen, bevor Sie es erneut versuchen.