Home Assistant MCP Server

Over dit item

Automatische samenvatting van de documentatie en configuratie van homeassistant-ai/ha-mcp, automatisch vertaald. Klopt er iets niet, of ben je de maintainer en wil je hier je eigen tekst tonen? Neem contact op

Ondersteunt

• Opent in de zijbalk Een eigen pagina opent binnen Home Assistant.

• Actief onderhouden De auteur heeft in de afgelopen zes maanden een release of wijziging gepubliceerd.

Instellen

Voeg de app-repository toe onder Instellingen > Apps. Installeer en start de app daarna.

Uit de documentatie

Machtigingen

• HostnetwerkGebruikt rechtstreeks het netwerk van de host in plaats van een eigen netwerk.
• Home Assistant-APIKan Home Assistant uitlezen en bedienen.
• Supervisor-APIKan communiceren met de Supervisor, die de apps en het systeem beheert.

Netwerk

• 9583/tcp

Configuratie

• TLS-certificaten verifiërenVerifieer het TLS-certificaat van de Home Assistant-server. Schakel dit alleen uit op een vertrouwd netwerk, voor een zelfondertekend certificaat of een hostnaamafwijking: dit verzwakt de transportbeveiliging.
• Home Assistant-toolgelijktijdigheidOptionele limiet voor uiterste Home Assistant-toolaanroepen over alle sessies heen. Interne REST-, WebSocket- en per-tool fan-out-gelijktijdigheid blijft ongewijzigd. 0 behoudt onbeperkt gedrag. Een aanroep die wacht op capaciteit mislukt na 60 seconden. Bereik 0–32.
• Niveau van back-uptipHoe sterk AI-assistenten worden aangespoord om een volledige Home Assistant-back-up voor te stellen vóór risicovolle wijzigingen. Dit wijzigt alleen deze tip; automatische bewerkingsback-ups hebben hun eigen instelling.
• Aangepaste serverinstructiesTekst die naar elke verbindende AI-assistent wordt verzonden als onderdeel van de MCP-serverinstructies — bijvoorbeeld waar huishoudelijke notities worden bewaard en wanneer je deze moet lezen of bijwerken. Maakt ook deel uit van de prompt van Home Assistant-gespreksagenten (Assist) die deze toolset gebruiken. Gebruik dit voor richtlijnen die al je clients tegelijk moeten bereiken; houd het kort en vrij van geheimen. Laat leeg om niets toe te voegen. Vereist een herstart; clients zien de wijziging wanneer ze opnieuw verbinden.
• Schakel tool-zoekfunctie inVervang de volledige toolcatalogus door zoekgebaseerde ontdekking. Vermindert inactieve context met ongeveer 90%, tot ongeveer 5K tokens. ⚠️ Schakel dit NIET in bij clients met een ingebouwde toolzoekfunctie / uitgestelde tools (claude.ai, Claude Desktop, Claude Code) — de twee zoeklagen conflicteren en de ingebouwde toolzoekfunctie van de client heeft daar de voorkeur; laat dit uitgeschakeld. Of tools worden uitgesteld hangt af van je client- en modelcombinatie: gebruik dit wanneer je opstelling de volledige catalogus vooraf laadt — modellen zonder native uitgestelde tools (bijv. Gemini, OpenAI-compatibele lokale modellen, Claude Haiku), clients die alle toolschema's inline opnemen ongeacht het model (bijv. GitHub Copilot CLI), of kleinere contextvensters. Sommige Codex-modellen en ChatGPT bevatten ook uitgestelde tools — controleer je client/model direct om de functies te bevestigen zodat je dit niet onnodig ingeschakeld laat. Tools worden gevonden via ha_search_tools en uitgevoerd via gecategoriseerde proxy's (lezen/schrijven/verwijderen). Vereist een herstart van de app (add-on) om van kracht te worden — maak daarna opnieuw verbinding of vernieuw de MCP-server in je AI-client zodat deze de toollijst opnieuw laadt. Alleen de app (add-on) herstarten vernieuwt de gecached toollijst van een client NIET; dit is van toepassing na het wijzigen van een instelling hier.
• Max. resultaten tool-zoekfunctieMaximum aantal verborgen tools geretourneerd per ha_search_tools aanroep wanneer toolzoeken is ingeschakeld; een vastgezette tool die in die top valt, wordt daarboven toegevoegd als een korte vermelding met alleen de naam. Lagere waarden (2-3) besparen contexttokens, maar missen mogelijk relevante tools. Vereist herstart. Bereik 2–10.
• Schakel Tool Beveiligingsbeleid in (geavanceerd)Beveilig risicovolle tool-aanroepen (vergrendelings-/alarmbediening, automatiseringsschrijvingen, enz.) achter gebruikersgoedkeuring. Wanneer een beveiligde tool wordt aangeroepen, instrueert de agent de gebruiker om het tabblad 'Tool Security Policies' in de web-UI te openen en op 'Goedkeuren' te klikken voordat de aanroep doorgaat. Per-tool regels met optionele argumentcondities worden geconfigureerd in het tabblad 'Tool Security Policies'. Standaard uitgeschakeld. Vereist een herstart om van kracht te worden.
• Laat AI-agenten het beveiligingsbeleid van tools bewerkenRegistreert de ha_manage_security_policy tool, waarmee verbonden AI-agenten het beveiligingsbeleid van tools kunnen lezen en herschrijven — inclusief het verwijderen van goedkeuringspoorten. Standaard uitgeschakeld. Onafhankelijk van de optie 'Tool Security Policies' hierboven: dit bepaalt wie de regels kan bewerken, niet of ze worden afgedwongen. De tool kan openstaande goedkeuringen niet zien of beslissen. Om een mens in de lus te houden, sluit de tool af voordat je deze inschakelt: schakel "security gated" in voor 'Manage Security Policy' op het tabblad 'Tools' van de web-UI. Vereist herstart om van kracht te worden.
• Alleen-lezen modusSchakelt alle schrijftools uit en verwijdert de mogelijkheid voor tools om schrijf- of destructieve aanroepen te doen. Gemengde lees-/schrijftools — back-ups, apps (add-ons), energievoorkeuren, spraakpijplijnen en codemodus wanneer ingeschakeld — blijven beschikbaar waarbij hun schrijfoperaties worden geblokkeerd. Dezelfde schakelaar als het web-ui-tabblad Tools. Standaard uit. Vereist herstart om van kracht te worden.
• Geheimen redigerenVerbergt geheimen in toolreacties voordat ze de AI-assistent bereiken. App-optie (add-on) velden en integratievelden die als wachtwoord zijn gemarkeerd, worden vervangen door een marker voor ingesteld/leeg (zodat "is dit credential geconfigureerd?" beantwoordbaar blijft), en andere toolreacties worden opgeschoond van geheime waarden die de server al heeft gezien (waarden korter dan 6 tekens worden overgeslagen, omdat het vervangen van kleine fragmenten ongerelateerde uitvoer zou beschadigen. Andere velden worden niet gedetecteerd, met uitzondering van privésleutels in app-opties en de hieronder vermelde app-optienamen. Standaard uitgeschakeld.
• Extra app-optiesleutels om te verbergenNamen van app-opties (add-on) om te verbergen zoals wachtwoordvelden, voor apps waarvan het schema een geheim opslaat als platte tekst (bijvoorbeeld backup_password). Scheid namen met komma's of nieuwe regels. Een naam is van toepassing op elke app; schrijf app_slug:name om het te beperken tot één app. Het benoemen van een optiegroep dekt elke optie daarin. Alleen gebruikt wanneer Verberg geheimen aan staat. Standaard leeg.
• Koppel best-practice vaardigheden aan schrijfbewerkingenHoofdschakelaar voor de functie voor het leveren van vaardigheidsinhoud voor schrijftools (issue #1182). Wanneer ingeschakeld (standaard), koppelen de zes configuratie-schrijftools (automatiseringen, scripts, scènes, helpers, dashboards, ruwe YAML) de canonieke Home Assistant best-practice referentiebestanden onder skill_content bij elke succesvolle schrijfbewerking, plus automatisch ingebedde referentiesecties die worden genoemd in best-practice waarschuwingen. Elke tool exposeert ook een per-aanroep MandatoryBPS-parameter die de agent op 'false' kan zetten bij volgende aanroepen zodra deze de inhoud heeft. Wanneer deze hoofdschakelaar uit staat, wordt GEEN skill_content verzonden, ongeacht de per-aanroep parameter of BP-waarschuwingen. Aanbevolen AAN als eerste keuze; alleen uitschakelen voor modellen met zeer kleine contextvensters. Het uitschakelen hiervan kan de schijfnauwkeurigheid verminderen. Vereist een herstart om van kracht te worden.
• Strikte best-practices modusStrikte modus: voorkomt dat de client de tool gebruikt totdat deze kan bewijzen dat het de best practices heeft gelezen. Wanneer ingeschakeld, worden de zes best-practice schrijftools (automatiseringen, scripts, scènes, helpers, dashboards, ruwe YAML) geblokkeerd en retourneren ze een fout die de client instrueert om de best-practice vaardigheid te lezen via ha_get_skill_guide en de daar verkregen bevestigingssleutel terug te sturen. Wanneer ingeschakeld, is de ha_get_skill_guide tool vergrendeld ingeschakeld — het is de enige uitgever van de bevestigingssleutel. Onderdeel van de optie "Koppel best-practice vaardigheden aan schrijfbewerkingen" hierboven en inactief zolang die ouder uitgeschakeld is. Vereist een herstart om van kracht te worden.
• Auto-backup bewerkingenSla een snapshot van een entiteit op voordat een toolaanroep voor schrijven of verwijderen deze wijzigt. Zolang dit is uitgeschakeld, weigeren de bestand- en ruwe-YAML-tools (ha_write_file, ha_delete_file, ha_config_set_yaml) te schrijven.
• Throttle voor automatisch back-uppen (minuten)Hoe vaak automatisch back-uppen dezelfde entiteit mag vastleggen. 0 legt bij elke schrijfaktie vast; N groter dan 0 legt maximaal één snapshot per N minuten per entiteit vast. Bereik 0–1440.