HA-MCP Custom Component

Après la mise en place

• Chemins de fichiers supplémentairesChemins relatifs au répertoire de configuration, y compris les noms de fichiers exacts tels que sensor.yaml, ou chemins sous /share, /media et /ssl (en lecture seule sur HAOS et Supervised). Chaque entrée dispose d'un accès en lecture et en écriture pour ce chemin et tout ce qu'il contient ; saisissez chaque entrée comme un élément de liste séparé. Les entrées sont comparées textuellement ; les jokers tels que * ne sont pas pris en charge. Les parcours de répertoires et autres chemins non autorisés sont ignorés.
• Clés d'écriture YAML supplémentairesClés de premier niveau que ha_config_set_yaml peut écrire en plus de celles intégrées, pour les intégrations YAML-first de cette installation (ex. alert2). Les clés de limite de confiance sont ignorées.
• Port d'écoute du serveur MCPLe port sur lequel ce serveur écoute. L'application (add-on) ha-mcp utilise le port 9583, celui-ci utilise donc 9584 par défaut pour permettre aux deux de fonctionner côte à côte – si vous n'exécutez pas l'application (add-on), n'importe quel port libre convient.
• Accès réseauQui peut se connecter directement au port du serveur MCP. Réseau local le rend accessible depuis votre réseau local, avec le chemin secret comme identifiant, tout comme l'application (add-on). Cette machine uniquement autorise les connexions provenant de la machine Home Assistant elle-même - l'URL du webhook et le panneau de la barre latérale fonctionnent dans les deux cas.
• Mode d'authentificationComment les clients MCP s'authentifient sur l'URL du webhook. Avec l'URL secrète, le lien lui-même est le seul identifiant - OAuth fonctionne toujours pour les clients qui l'utilisent, et une connexion renvoyant vers une URL de rappel autorisée (voir ci-dessous) est approuvée automatiquement : aucun identifiant ni aucun ID client ou secret n'est nécessaire. Avec la connexion Home Assistant, les clients tels que claude.ai se connectent avec un compte administrateur Home Assistant (OAuth). Avec OAuth hérité, cette intégration exécute son propre service de connexion et émet un ID client et un secret à coller dans les clients qui en requièrent un - un redémarrage de Home Assistant peut être nécessaire pour l'activer ou le désactiver complètement.
• OAuth hérité : Client ID personnalisé (optionnel)Remplace le Client ID OAuth hérité généré automatiquement. Laissez vide pour conserver l'actuel. Utilisé uniquement lorsque le mode d'authentification est défini sur OAuth hérité.
• OAuth hérité : Client Secret personnalisé (optionnel)Remplace le Client Secret OAuth hérité généré automatiquement. Laissez vide pour conserver l'actuel. Utilisé uniquement lorsque le mode d'authentification est défini sur OAuth hérité.
• OAuth hérité : régénérer Client ID/Secret maintenantAction unique : génère un nouveau Client ID et Secret pour le mode OAuth hérité. Cela ne prend effet qu'après le redémarrage de Home Assistant demandé par l'invite de réparation – jusqu'au redémarrage, les anciens Client ID et Secret continuent de fonctionner et les nouveaux ne sont pas encore actifs. Efface également les deux champs de surcharge ci-dessus.
• Développeur : surcharge du paquet ha-mcpLaissez vide pour exécuter le serveur ha-mcp installé par cette version du composant. Uniquement pour tester une version spécifique de ha-mcp (un épinglage de version, une archive tarball de pull-request ou une URL de wheel) ; appliqué en rechargeant le serveur, sans redémarrer Home Assistant. Effacez pour revenir au serveur associé.
• URL Home Assistant (avancé)L'URL que le serveur intégré utilise pour atteindre votre Home Assistant (généralement cette instance elle-même). Laissez vide pour la dériver du port et des paramètres SSL de cette instance ; ne définissez une valeur que si le serveur a besoin d'une autre route.
• URL externe (optionnel)Affichée comme URL de connexion principale – utilisez-la lorsque Home Assistant est derrière votre propre domaine ou un reverse proxy. Entrez l'adresse de base complète, y compris le schéma. Elle doit pointer directement vers Home Assistant – l'ouvrir dans un navigateur doit atteindre votre page de connexion HA – et ne doit pas contenir de port tel que :8123 (ou tout autre port), sinon les clients MCP distants ne pourront pas l'atteindre. Laissez vide pour utiliser automatiquement Nabu Casa / l'adresse locale.
• Secret webhook personnalisé (optionnel)Remplace le secret webhook aléatoire dans l'URL de connexion (/api/webhook/...). L'URL est l'identifiant – utilisez une valeur longue et difficile à deviner. Laissez vide pour conserver l'actuel.
• Chemin d'accès direct personnalisé (optionnel)Remplace le chemin aléatoire utilisé pour l'accès direct sur le port du serveur. Même règle : le chemin est l'identifiant. Laissez vide pour conserver l'actuel.
• Régénérer les secrets de connexion maintenantAction unique : génère un nouveau secret webhook aléatoire et un chemin d'accès direct, invalidant immédiatement les anciennes URL de connexion. Efface également les deux champs de surcharge ci-dessus.
• Accès distant via webhookDésactivez pour le mode local uniquement : le webhook Home Assistant n'est pas enregistré du tout, donc rien – y compris Nabu Casa – ne peut atteindre le serveur via Home Assistant. Le port serveur direct et le panneau latéral continuent de fonctionner.
• API LLM pour agents de conversation
• Exposition des outils pour agents de conversation