Nabu Casa

À propos

Résumé automatique de la documentation et de la configuration de homeassistant-ai/ha-mcp, traduit automatiquement. Une erreur, ou tu maintiens ce projet et tu veux ton propre texte ici ? Prendre contact

Prise en charge

• Maintenance active Son auteur a publié une version ou poussé une modification au cours des six derniers mois.

Mise en place

Ajoute son dépôt d’applications dans Paramètres > Applications, puis installe-la et démarre-la.

Les textes que le dépôt ne fournit pas en français ont été traduits automatiquement.

Extrait de la documentation

Autorisations

• Réseau de l’hôteUtilise directement le réseau de l’hôte au lieu du sien.
• API Home AssistantPeut lire et contrôler Home Assistant.
• API SupervisorPeut communiquer avec le Supervisor, qui gère les applications et le système.

Configuration

• URL externe (facultatif)URL de base publique pour l’accès distant (par exemple https://example.customurl.com). Elle doit pointer directement vers Home Assistant : l’ouvrir dans un navigateur doit afficher la page de connexion de ton HA. Elle ne doit pas contenir de port comme ":8123" (ni aucun autre port), sinon les clients MCP distants ne pourront pas l’atteindre. Laisse vide pour détecter Nabu Casa automatiquement.
• URL du serveur MCP (facultatif)URL complète du serveur MCP vers lequel faire le proxy (par exemple http://192.168.1.100:9583/private_abc123). Laisse vide pour la découverte automatique à partir d’une application HA MCP en cours d’exécution.
• Port du serveur MCP (facultatif)Port sur lequel l’application MCP écoute. Utilisé uniquement pendant la découverte automatique. Par défaut : 9583.
• Activer OAuth (bêta)Ajoute l'authentification OAuth 2.1 à l'URL du webhook. La même URL continue de fonctionner, mais exige désormais un flux OAuth réussi avant de traiter les requêtes MCP. Cette option est désactivée (OFF) par défaut et rien ne change pour qui la laisse désactivée : le webhook fonctionne alors exactement comme avant, sans contrôle d'authentification. Deux modes sont disponibles (voir OAuth Mode ci-dessous) : - ha_auth (recommandé, la valeur par défaut lors d'une première activation) : tu te connectes avec ton compte Home Assistant. Laisse les champs OAuth du connecteur BLANK, sans Client ID ni Client Secret. Fonctionne avec n'importe quel nom d'hôte ou URL et ne demande AUCUN redémarrage de Home Assistant pour l'activer ou le désactiver. - legacy : l'ancien flux, où l'application génère un Client ID et un Secret que tu colles dans le connecteur (voir les options OAuth Client ID / Secret). Activer legacy exige un redémarrage complet de Home Assistant (une correction avec un bouton de redémarrage apparaît) ; la désactivation n'en exige pas. Les mises à jour sont sans risque : si tu as déjà utilisé le flux legacy (tu as défini un Client ID/Secret, ou l'application en a enregistré un), l'application te garde en legacy pour que ton connecteur existant continue de fonctionner. Changer de mode est une action explicite (définir OAuth Mode) et demande de supprimer puis de rajouter ton connecteur MCP.
• Mode OAuth (bêta)Le mode OAuth à utiliser quand Enable OAuth est activé. Laisse cette option UNSET sauf si tu veux changer de mode : l'application choisit automatiquement la bonne valeur par défaut. - ha_auth : connexion avec ton compte Home Assistant. Laisse les champs OAuth du connecteur vides ; fonctionne avec n'importe quel nom d'hôte ou URL ; aucun redémarrage de Home Assistant n'est nécessaire. C'est la valeur par défaut lors d'une première activation d'OAuth. - legacy : l'ancien flux avec client-id et secret (obsolète), pour les installations qui en ont encore besoin. Quand l'option n'est pas définie, les mises à jour restent sans risque : si tu as déjà utilisé OAuth legacy (un Client ID/Secret configuré ou enregistré), l'application reste en legacy pour que rien ne casse ; sinon elle utilise ha_auth par défaut. Modifier cette option puis redémarrer change de mode : tu dois ensuite supprimer et rajouter ton connecteur MCP.
• OAuth Client ID (mode legacy ; généré automatiquement si vide)Mode OAuth legacy uniquement (ignoré en mode ha_auth). Client ID que le client MCP (par exemple Claude.ai) doit présenter au point de terminaison de jeton OAuth. Laisse vide pour que l’application génère une valeur au premier démarrage (recommandé) ; la valeur générée est conservée dans /data/oauth_creds.json pour rester identique après chaque redémarrage. Si tu définis une valeur ici, elle doit contenir au moins 16 caractères.
• OAuth Client Secret (mode legacy ; généré automatiquement si vide)Mode OAuth legacy uniquement (ignoré en mode ha_auth). Client Secret que le client MCP (par exemple Claude.ai) doit présenter au point de terminaison de jeton OAuth. Laisse vide pour que l’application génère une valeur aléatoire robuste au premier démarrage (recommandé). Traite cette valeur comme un mot de passe : quiconque la possède peut mener à bien le flux OAuth vers ton serveur MCP.
• Régénérer les identifiants OAuth au prochain démarrage (mode legacy)Mode OAuth legacy uniquement (ignoré en mode ha_auth). Action unique : quand tu l’actives et redémarres l’application, le Client ID et le Client Secret OAuth enregistrés sont effacés et de nouvelles valeurs aléatoires sont générées. Les nouvelles valeurs sont affichées dans le journal de l’application et conservées après les redémarrages. L’application essaie de remettre automatiquement cette option sur désactivé après la régénération, afin que les redémarrages suivants ne régénèrent pas à nouveau. Si cela échoue (anciennes versions du Supervisor), le journal de l’application t’indiquera de la désactiver manuellement. Utilise cette option si tu penses que tes identifiants OAuth ont fuité ou si tu veux simplement en avoir de nouveaux. N’oublie pas de mettre ensuite à jour ton client MCP (par exemple Claude.ai) avec les nouvelles valeurs.
• Journaliser les requêtes entrantes (bêta)Journalise chaque requête qui atteint ce webhook. Les lignes apparaissent dans le journal propre à cette application (ci-dessous) ET dans le journal de Home Assistant (Réglages -> Système -> Journaux, filtre "mcp_proxy"). Le webhook est servi dans Home Assistant et non dans cette application : l’intégration y journalise donc chaque requête et l’application reprend ces lignes dans ce journal. Chaque ligne indique la méthode, un chemin de webhook masqué, l’adresse source, si un en-tête Authorization était présent et le statut de la réponse en amont. Utilise-la pour vérifier si ton client MCP (par exemple Claude.ai) atteint réellement le serveur : active-la, redémarre l’application, essaie de te connecter depuis ton client et surveille ce journal. Si aucune ligne entrante n’apparaît, la requête n’est jamais arrivée : le problème vient de l’accessibilité réseau (URL publique / DNS / TLS), pas de l’application. Redémarre l’application après avoir modifié cette option. Laisse désactivé pour un fonctionnement normal.