Nabu Casa

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

• 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.

Teksten waarvoor de repository geen Nederlandse vertaling heeft, zijn automatisch vertaald.

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.

Configuratie

• Externe URL (optioneel)Openbare basis-URL voor externe toegang (bijv. https://example.customurl.com). Deze moet direct naar Home Assistant verwijzen: als je hem in een browser opent, hoort de inlogpagina van je HA te verschijnen. Hij mag geen poort bevatten, zoals ":8123" (of een andere poort), anders kunnen externe MCP-clients hem niet bereiken. Laat leeg om Nabu Casa automatisch te detecteren.
• MCP-server-URL (optioneel)Volledige URL van de MCP-server waarnaar de proxy doorstuurt (bijv. http://192.168.1.100:9583/private_abc123). Laat leeg om automatisch te ontdekken vanuit een draaiende HA MCP-addon.
• MCP-serverpoort (optioneel)Poort waarop de MCP-addon luistert. Wordt alleen gebruikt bij automatische ontdekking. Standaard: 9583.
• OAuth inschakelen (Beta)Voegt OAuth 2.1-authenticatie toe aan de webhook-URL. Dezelfde URL blijft werken, maar vereist nu een geslaagde OAuth-flow voordat MCP-verzoeken worden afgehandeld. Dit staat standaard UIT en verandert niets voor wie het uit laat staan: de webhook werkt dan precies zoals voorheen, zonder authenticatiecontrole. Er zijn twee modi beschikbaar (zie OAuth Mode hieronder): - ha_auth (aanbevolen, de standaard bij de eerste keer inschakelen): je logt in met je Home Assistant-account. LAAT de OAuth-velden van de connector BLANK, dus geen Client ID of Client Secret. Werkt met elke hostnaam of URL en vereist GEEN herstart van Home Assistant om het in of uit te schakelen. - legacy: de vorige flow, waarbij de add-on een Client ID en Secret genereert die je in de connector plakt (zie de opties OAuth Client ID / Secret). Voor het inschakelen van legacy is een volledige herstart van Home Assistant nodig (er verschijnt een reparatie met een herstartknop); bij uitschakelen is dat niet nodig. Upgraden is veilig: als je de legacy-flow al gebruikte (je hebt een Client ID/Secret ingesteld, of de add-on heeft er een opgeslagen), houdt de add-on je op legacy zodat je bestaande connector blijft werken. Van modus wisselen is een bewuste actie (stel OAuth Mode in) en vereist dat je je MCP-connector verwijdert en opnieuw toevoegt.
• OAuth-modus (Beta)Welke OAuth-modus wordt gebruikt als Enable OAuth aan staat. Laat dit UNSET, tenzij je wilt wisselen: de add-on kiest automatisch de juiste standaard. - ha_auth: log in met je Home Assistant-account. Laat de OAuth-velden van de connector leeg; werkt met elke hostnaam of URL; geen herstart van Home Assistant nodig. Dit is de standaard bij de eerste keer OAuth inschakelen. - legacy: de vorige flow met client-id en secret (verouderd), voor opstellingen die dit nog nodig hebben. Als dit niet is ingesteld, blijven upgrades veilig: als je al legacy OAuth gebruikte (een ingestelde of opgeslagen Client ID/Secret), blijft de add-on op legacy zodat er niets kapotgaat; anders wordt ha_auth gebruikt. Als je dit wijzigt en herstart, wissel je van modus: je moet daarna je MCP-connector verwijderen en opnieuw toevoegen.
• OAuth Client ID (legacy-modus; automatisch gegenereerd als leeg)Alleen voor legacy OAuth-modus (genegeerd in ha_auth-modus). Client ID dat de MCP-client (bijv. Claude.ai) moet tonen bij het OAuth-tokeneindpunt. Laat leeg zodat de addon bij de eerste start een waarde genereert (aanbevolen); de gegenereerde waarde wordt bewaard in /data/oauth_creds.json, zodat hij na herstarts gelijk blijft. Als je hier zelf een waarde instelt, moet die minstens 16 tekens lang zijn.
• OAuth Client Secret (legacy-modus; automatisch gegenereerd als leeg)Alleen voor legacy OAuth-modus (genegeerd in ha_auth-modus). Client Secret dat de MCP-client (bijv. Claude.ai) moet tonen bij het OAuth-tokeneindpunt. Laat leeg zodat de addon bij de eerste start een sterke willekeurige waarde genereert (aanbevolen). Behandel de waarde als een wachtwoord: iedereen die haar heeft, kan de OAuth-flow met je MCP-server doorlopen.
• OAuth-inloggegevens opnieuw genereren bij volgende start (legacy-modus)Alleen voor legacy OAuth-modus (genegeerd in ha_auth-modus). Eenmalige actie: als je dit aanzet en de addon herstart, worden het opgeslagen OAuth Client ID en Client Secret gewist en worden nieuwe willekeurige waarden gegenereerd. De nieuwe waarden worden in het addon-log getoond en bewaard over herstarts heen. De addon probeert deze schakelaar na het opnieuw genereren automatisch weer uit te zetten, zodat volgende herstarts niet steeds opnieuw genereren. Lukt dat niet (oudere Supervisor-versies), dan meldt het addon-log dat je dit handmatig moet uitzetten. Gebruik dit als je vermoedt dat je OAuth-inloggegevens zijn uitgelekt of gewoon nieuwe wilt. Vergeet daarna niet je MCP-client (bijv. Claude.ai) met de nieuwe waarden bij te werken.
• Binnenkomende verzoeken loggen (Beta)Logt elk verzoek dat deze webhook bereikt. De regels verschijnen in het eigen log van deze addon (hieronder) EN in het Home Assistant-log (Instellingen -> Systeem -> Logs, filter op "mcp_proxy"). De webhook wordt binnen Home Assistant afgehandeld en niet door deze addon, dus de integratie logt elk verzoek daar en de addon spiegelt die regels naar dit log. Elke regel toont de methode, een gemaskeerd webhook-pad, het bronadres, of er een Authorization-header aanwezig was en de responsstatus van de upstream. Gebruik dit om te controleren of je MCP-client (bijv. Claude.ai) de server echt bereikt: zet het aan, herstart de addon, probeer verbinding te maken vanuit je client en volg dit log. Als er geen binnenkomende regels verschijnen, is het verzoek nooit aangekomen: dan ligt het probleem bij de netwerkbereikbaarheid (openbare URL / DNS / TLS) en niet bij de addon. Herstart de addon nadat je deze optie hebt gewijzigd. Laat uit tijdens normaal gebruik.