HA-MCP Custom Component

Na het instellen

• Extra bestandspadenPaden relatief ten opzichte van de config-directory, inclusief exacte bestandsnamen zoals sensor.yaml, of paden onder /share, /media en /ssl (alleen-lezen op HAOS en Supervised). Aan elk item wordt lees- en schrijftoegang verleend voor dat pad en alles daaronder; voer elk pad in als een apart lijstitem. Vermeldingen worden letterlijk gematcht; jokers zoals * worden niet ondersteund. Traversal en andere niet-toegestane paden worden genegeerd.
• Extra YAML-schrijfsleutelsTop-level sleutels die ha_config_set_yaml mag schrijven naast de ingebouwde, voor YAML-first integraties op deze installatie (bijv. alert2). Trust-boundary sleutels worden genegeerd.
• Luisterpoort MCP serverDe poort waarop deze server luistert. De ha-mcp app (add-on) gebruikt 9583, dus de standaardwaarde is 9584 zodat beide naast elkaar kunnen draaien - als je de app (add-on) niet gebruikt, werkt elke vrije poort.
• NetwerktoegangWie rechtstreeks verbinding kan maken met de MCP-serverpoort. Lokaal netwerk maakt deze bereikbaar vanaf je lokale netwerk, met het geheime pad als inloggegevens, net als de app (add-on). Alleen deze machine staat alleen verbindingen toe vanaf de Home Assistant-machine zelf - de webhook-URL en het zijbalkpaneel werken in beide gevallen.
• AuthenticatiemodusHoe MCP-clients zichzelf verifiëren bij de webhook-URL. Bij de geheime URL is de link zelf de enige inloggegevens - OAuth werkt nog steeds voor clients die het gebruiken, en een aanmelding die terugkeert naar een toegestane callback-URL (zie hieronder) wordt automatisch goedgekeurd: geen login en geen Client ID of Secret nodig. Met Home Assistant-aanmelding loggen clients zoals claude.ai in met een Home Assistant-beheerdersaccount (OAuth). Met legacy OAuth voert deze integratie haar eigen aanmeldingsservice uit en geeft deze een Client ID en Secret uit om te plakken in clients die er een vereisen - een herstart van Home Assistant kan nodig zijn om deze volledig in of uit te schakelen.
• Legacy OAuth: aangepaste Client ID (optioneel)Vervangt de automatisch gegenereerde legacy OAuth Client ID. Laat leeg om de huidige te behouden. Alleen gebruikt wanneer Authenticatiemodus is ingesteld op legacy OAuth.
• Legacy OAuth: aangepaste Client Secret (optioneel)Vervangt de automatisch gegenereerde legacy OAuth Client Secret. Laat leeg om de huidige te behouden. Alleen gebruikt wanneer Authenticatiemodus is ingesteld op legacy OAuth.
• Legacy OAuth: genereer nu Client ID/Secret opnieuwEenmalige actie: genereert een nieuwe Client ID en Secret voor legacy OAuth-modus. Het wordt pas van kracht na de Home Assistant herstart waar de reparatieprompt om vraagt - totdat je herstart, blijven de vorige Client ID en Secret werken en de nieuwe niet. Maakt ook de twee overschrijvingsvelden hierboven leeg.
• Ontwikkelaar: ha-mcp pakketoverheersingLaat leeg om de ha-mcp-server uit te voeren die deze componentrelease heeft geïnstalleerd. Alleen voor het testen van een specifieke ha-mcp-build (een versiepining, een pull-request tarball of een wheel-URL); wordt toegepast door de server te herladen, zonder Home Assistant te herstarten. Wis dit om terug te keren naar de gekoppelde server.
• Home Assistant URL (geavanceerd)De URL die de in-process server gebruikt om je Home Assistant te bereiken (meestal deze instantie zelf). Laat leeg om het af te leiden van de poort- en SSL-instellingen van deze instantie; stel alleen een waarde in wanneer de server een andere route nodig heeft.
• Externe URL (optioneel)Weergegeven als de primaire verbindings-URL - gebruik dit wanneer Home Assistant achter je eigen domein of reverse proxy zit. Voer het volledige basisadres in, inclusief het schema. Het moet direct naar Home Assistant wijzen - het openen in een browser zou je HA-inlogpagina moeten bereiken - en mag geen poort bevatten zoals :8123 (of enige andere poort), anders kunnen externe MCP-clients het niet bereiken. Laat leeg om Nabu Casa / het lokale adres automatisch te gebruiken.
• Aangepast webhook geheim (optioneel)Vervangt het willekeurige webhook-geheim in de verbindings-URL (/api/webhook/...). De URL is de referentie - gebruik een lange, moeilijk te raden waarde. Laat leeg om de huidige te behouden.
• Aangepast direct-toegangspad (optioneel)Vervangt het willekeurige pad dat wordt gebruikt voor directe toegang op de serverpoort. Dezelfde regel: het pad is de referentie. Laat leeg om de huidige te behouden.
• Genereer verbindingsgeheimen nu opnieuwEenmalige actie: genereert een nieuw willekeurig webhook-geheim en direct-toegangspad, waardoor de oude verbindings-URL's onmiddellijk ongeldig worden. Maakt ook de twee bovenstaande overschrijvingsvelden leeg.
• Toegang op afstand via webhookSchakel uit voor de lokale-modus: de Home Assistant-webhook wordt helemaal niet geregistreerd, dus niets - inclusief Nabu Casa - kan de server via Home Assistant bereiken. De directe serverpoort en het zijbalkpaneel blijven werken.
• Conversatie-agent LLM API
• Blootstelling van conversatie-agent hulpmiddelen