Installieren Sie „MCP Server for Xiaozhi“ in Home Assistant (HA) über HACS und fügen Sie anschließend die gleichnamige Integration hinzu. Laut Ausgangsartikel ist dieser Schritt auf HAIOTS-Hosts, die nach April 2026 ausgeliefert wurden, bereits eingerichtet.
Schritt 1: MCP-Endpunktadresse von Xiaozhi abrufen
Das Xiaozhi-Gerät benötigt eine Verbindungsadresse zu HA. Melden Sie sich in der offiziellen Xiaozhi-Konsole an (gewöhnlich xiaozhi.me; bei eigener Installation verwenden Sie Ihre eigene Konsolenadresse). Suchen Sie in der Geräteliste Ihr ESP-Xiaozhi-Gerät und öffnen Sie „Konfigurieren“.
Scrollen Sie zum Abschnitt „MCP Setting“ und wählen Sie „Get MCP Endpoint“. Kopieren Sie die erzeugte Adresse, die normalerweise mit wss:// beginnt.
Schritt 2: Xiaozhi-MCP-Integration in HA einrichten
Öffnen Sie in Home Assistant „Einstellungen“ → „Geräte & Dienste“ → „Integration hinzufügen“. Suchen Sie nach „MCP“ oder „Xiaozhi“ und wählen Sie „MCP Server for Xiaozhi“. Fügen Sie die zuvor kopierte MCP-Endpunktadresse ein.
Wenn die Option „llm_hass_api“ angezeigt wird, aktivieren Sie sie. Diese HA-Funktion erlaubt Xiaozhi, freigegebene Geräte zu steuern. Weitere MCPs können Sie bei Bedarf ebenfalls auswählen. Bestätigen Sie mit „Absenden“ bzw. „Fertig“.
Warten Sie ungefähr eine Minute. Öffnen Sie dann „MCP Setting“ in der Xiaozhi-Konsole, aktualisieren Sie die Ansicht und prüfen Sie, ob der Status „Connected“ lautet.
Schritt 3: HA-Geräte für Xiaozhi freigeben
HA gibt aus Sicherheitsgründen nicht automatisch alle Geräte für Sprachassistenten frei. Öffnen Sie „Einstellungen“ → „Sprachassistenten“ → „Freigeben“. Markieren Sie die Geräte, die Xiaozhi bedienen darf, etwa Leuchten, Schalter, Klimageräte, Ventilatoren oder Sensoren. Testen Sie zunächst nur ein oder zwei Leuchten und geben Sie weitere Geräte erst nach einem erfolgreichen Test frei.
Schritt 4: Sprachsteuerung testen und Fehler beheben
Testen Sie einen Befehl wie „Xiaozhi, schalte das Licht im Arbeitszimmer ein“ und eine Abfrage wie „Xiaozhi, wie warm ist es gerade im Wohnzimmer?“.
Wenn Xiaozhi nicht reagiert oder unpassend antwortet, prüfen Sie in der Xiaozhi-Konsole den Chatverlauf: Wurde der Befehl verstanden und ein Home-Assistant-Tool aufgerufen (Function Call)? Bei Konflikten mit Musik- oder Bildschirmfunktionen formulieren Sie den Befehl genauer, etwa „Schalte über Smart Home die Deckenleuchte im Wohnzimmer ein“.
Wenn der Befehl an HA gesendet wurde, aber das Gerät nicht reagiert, öffnen Sie „Einstellungen“ → „System“ → „Protokolle“ und prüfen Sie auf Fehler der MCP-Integration.
