Home Assistant MCP mit Microsoft Copilot verbinden

💡 Keine Installation? Nutze direkt cloud.anythingmcp.com. Melde dich an, klicke auf Connectors → Home Assistant, füge deine Zugangsdaten ein, erstelle einen MCP-API-Key — fertig. Kein Docker, kein git clone, kein lokaler Server.

Home Assistant + Microsoft Copilot

Lass deine KI dein Home Assistant lesen: den aktuellen Zustand jedes Sensors, Lichts, jeder Tür und jedes Thermostats, den aufgezeichneten Verlauf, das Logbuch darüber, was wann passiert ist, und deine Kalender. Nur lesend: Geräte werden nie gesteuert. Funktioniert mit self-hosted Home Assistant.

Voraussetzungen

Die vollständige Einrichtungsanleitung ist direkt im Connector enthalten (sichtbar im In-App-Store, wenn du den Connector auswählst). Die erforderlichen Umgebungsvariablen für diesen Connector sind:

HOME_ASSISTANT_URL, HOME_ASSISTANT_TOKEN

Schritt 1 — Zugangsdaten besorgen

Die Einrichtung dauert etwa 3 Minuten. Du brauchst eine Home-Assistant-Instanz, die AnythingMCP erreichen kann, und ein langlebiges Zugriffstoken, idealerweise von einem eigenen Nicht-Admin-Benutzer.

1. Setze HOME_ASSISTANT_URL auf die Adresse, unter der du Home Assistant öffnest, ohne abschließenden Schrägstrich und ohne /api, zum Beispiel https://home.example.com oder http://192.168.1.10:8123 (der Standardport ist 8123).
2. Empfohlen: Lege unter Einstellungen → Personen → Benutzer → Benutzer hinzufügen einen eigenen Home-Assistant-Benutzer für AnythingMCP an, bei dem Administrator ausgeschaltet ist. Keiner der Endpunkte, die der Connector nutzt, braucht Admin-Rechte.
3. Melde dich als dieser Benutzer an und klicke unten links auf deinen Namen, um dein Profil zu öffnen. Öffne den Tab Sicherheit und klicke unter Langlebige Zugriffstoken auf Token erstellen. Kopiere das Token (es wird nur einmal angezeigt und bleibt 10 Jahre gültig) und füge es in HOME_ASSISTANT_TOKEN ein, ohne das Wort Bearer.
4. Installiere den Connector und führe home_assistant_get_config aus: Das Tool liefert Version, Standortname und Zeitzone zurück und bestätigt, dass Adresse und Token funktionieren.

Was gelesen wird: der aktuelle Zustand jeder Entität (Sensoren, Lichter, Klima, Türen, Anwesenheit) samt Attributen, der aufgezeichnete Verlauf von Werten über einen Zeitraum, das Logbuch darüber, was wann passiert ist (zum Beispiel wann sich das Garagentor zuletzt geöffnet hat), deine Kalender und deren Termine sowie die Instanzkonfiguration. Entity-IDs sehen so aus: sensor.living_room_temperature oder binary_sensor.garage_door.

Nur lesend: Jedes Tool ist eine GET-Anfrage. Der Connector kann keine Aktionen (Services) aufrufen, nichts ein- oder ausschalten, keine Türen entriegeln, keine Skripte ausführen und keine Zustände ändern. Der Aktions-Endpunkt von Home Assistant ist nicht auf Admins beschränkt, daher stammt diese Garantie daraus, dass der Connector nur Lesezugriffe bereitstellt, und nicht aus dem Token.

Wo Home Assistant läuft: Bei einem self-hosted AnythingMCP muss für eine Instanz in einem privaten Netzwerk (http://192.168.x.x:8123, homeassistant.local) ein Administrator den Host in SSRF_ALLOWED_HOSTS oder in der Allowlist in den Admin-Einstellungen freigeben. AnythingMCP Cloud kann nur eine Instanz erreichen, die über HTTPS im öffentlichen Internet erreichbar ist, zum Beispiel hinter einem Reverse Proxy oder über den Remote-Zugriff von Home Assistant Cloud.

Datenschutz: Smart-Home-Daten zeigen, wer zu Hause ist, und verraten die täglichen Routinen des Haushalts. Weise den Connector nur MCP-Servern zu, deren Nutzer diese Daten sehen dürfen.

Zeiten: Zeitstempel werden als ISO 8601 in UTC mit dem Suffix Z übergeben, zum Beispiel 2026-10-01T00:00:00Z. home_assistant_get_config liefert die Zeitzone des Zuhauses zurück, damit du Ergebnisse passend darstellen kannst.

Häufige Fehler: 401 bedeutet, dass das Token falsch ist oder gelöscht wurde. 404 bei einer einzelnen Entität oder deren Kalendertermine bedeutet, dass keine Entität diese ID hat; 404 bei jedem Aufruf bedeutet, dass HOME_ASSISTANT_URL falsch ist oder bereits auf /api endet. 400 bei Kalenderterminen bedeutet, dass start oder end fehlt oder kein gültiger Zeitstempel ist. Eine abgelehnte oder blockierte Verbindung bedeutet, dass der Host nicht in der SSRF-Allowlist freigegeben ist (self-hosted) oder nicht öffentlich über HTTPS erreichbar ist (Cloud).

Der Connector ruft keine Aktionen oder Services auf, schreibt oder löscht keine Zustände, löst keine Events aus, rendert keine Templates, zeigt keine Kamerabilder an und liest weder den Event-Stream noch das Fehlerprotokoll oder die WebSocket-API (Bereiche, Geräte, Entity-Registry).

Schritt 2 — Den Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Den Connector in Microsoft Copilot hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die Home Assistant-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.

Verfügbare Tools

FAQ

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

• Connector-Landingpage
• Mit Claude verbinden
• Mit ChatGPT verbinden