ChatGPT Home Assistant MCP : corrections en cas de panne, accès distant et configuration gratuite

ChatGPT refuse de se connecter à votre serveur Home Assistant MCP, ou se connecte sans jamais rien contrôler ? Cet article détaille les vraies causes : échecs OAuth, accès distant absent, appels d’outils bloqués et mauvaises URL. Il montre aussi comment construire une configuration d’accès distant gratuite et garder l’ensemble sécurisé.

ChatGPT Home Assistant MCP : corrections en cas de panne, accès distant et configuration gratuite
Cristian Da Conceicao

Vous avez saisi l’URL du serveur MCP dans ChatGPT, cliqué sur connecter, et vous voyez un cercle de chargement qui ne s’arrête jamais. Ou pire : un message obscur indiquant qu’un client OAuth n’a pas pu être résolu. Si votre lien ChatGPT Home Assistant MCP ne fonctionne pas, vous êtes en bonne compagnie. C’est le mur le plus fréquent quand on tente de piloter sa maison connectée via un chatbot, et presque chaque cas se ramène à l’une de cinq causes : le serveur est injoignable depuis Internet, la découverte OAuth échoue derrière un proxy, l’URL est erronée, l’intégration n’expose pas les bonnes entités, ou les appels d’outils sont bloqués côté ChatGPT.

Cet article passe en revue chaque cause dans l’ordre où vous risquez de les rencontrer, puis construit une configuration d’accès distant gratuite pour que vous n’ayez rien à payer afin qu’une fenêtre de chat atteigne votre salon.

💡 Réponse rapide : ChatGPT sur le site tourne dans le cloud. Les services cloud ne peuvent pas voir homeassistant.local. Votre instance a besoin d’une adresse HTTPS publique, et cette adresse doit passer la découverte OAuth sans erreur. Réglez ces deux points et la plupart des cas « ne fonctionne pas » disparaissent.

Un utilisateur contrarié devant un ordinateur portable, avec un message d’erreur rouge et des notes manuscrites sur un bureau

Ce que MCP fait réellement ici

MCP signifie Model Context Protocol. Considérez-le comme une prise standard entre un assistant IA et un outil. Home Assistant propose une intégration de serveur MCP qui expose les entités et services que vous choisissez, afin qu’un client IA puisse lire des états (« la porte du garage est-elle ouverte ? ») et déclencher des actions (« éteignez la lumière de la cuisine »).

Le déroulement semble simple sur le papier :

  1. Vous activez l’intégration de serveur MCP dans Home Assistant.
  2. Vous décidez quelles entités l’assistant peut voir, via les paramètres d’exposition d’Assist.
  3. Vous collez l’URL du serveur dans ChatGPT comme connecteur personnalisé et choisissez OAuth comme méthode d’authentification.
  4. ChatGPT découvre les points de terminaison OAuth, vous fait passer par une connexion, et liste les outils.

Chacune de ces étapes peut échouer silencieusement. Le reste de cet article est une carte de ces points.

Le point de terminaison dont vous avez besoin

L’intégration native expose son point de terminaison au chemin /api/mcp de votre adresse Home Assistant. D’anciens tutoriels communautaires mentionnent encore un chemin /mcp_server/sse, qui date des premiers temps de la fonctionnalité. Si vous suivez un tutoriel de plus de quelques mois, vérifiez le chemin qu’il utilise avant d’incriminer votre réseau.

Clients locaux contre clients cloud

Un client de bureau qui tourne sur votre propre ordinateur peut souvent joindre votre instance via le réseau local. ChatGPT sur le web ne le peut pas. Cette différence explique un nombre surprenant de fils de forum où « ça marche sur mon ordinateur portable mais pas dans le navigateur ».

Type de clientD’où vient la requêteAccès public nécessaire ?
Application de bureau sur votre réseau domestiqueVotre propre ordinateurGénéralement non
ChatGPT sur le site webServeurs d’OpenAIOui
Application mobile en données mobilesCloud ou téléphone, hors de votre LANOui
Script ou agent localMême réseauNon

Pourquoi ChatGPT ne peut pas se connecter

Passons en revue les échecs du plus fréquent au moins fréquent.

Cause 1 : pas d’adresse publique

Si votre URL Home Assistant se termine par .local, commence par 192.168, ou ne fonctionne que sur votre Wi-Fi, ChatGPT ne l’atteindra jamais. La documentation de Home Assistant est claire à ce sujet : lorsque l’agent IA tourne dans le cloud, l’instance doit être joignable depuis Internet, par exemple via Home Assistant Cloud ou une autre méthode d’accès distant.

Comment tester : désactivez le Wi-Fi de votre téléphone, ouvrez votre URL externe dans un navigateur mobile, et vérifiez si la page de connexion s’affiche. Si ce n’est pas le cas, le problème ne vient pas de ChatGPT.

Un routeur blanc avec des voyants verts et un câble Ethernet bleu sur une étagère en bois

Cause 2 : la découverte OAuth échoue derrière un proxy

Ce cas produit la fameuse erreur : « Failed to resolve OAuth client for MCP connector. » Des retours de la communauté la signalent sur des instances derrière un domaine personnalisé, un tunnel ou un reverse proxy. La raison habituelle : les métadonnées renvoyées par Home Assistant pendant la découverte ne correspondent pas à l’adresse que ChatGPT a utilisée pour l’atteindre.

Déclencheurs fréquents :

  • L’URL externe dans les paramètres de Home Assistant diffère de l’adresse que vous avez collée dans ChatGPT.
  • Un reverse proxy réécrit l’en-tête host, de sorte que Home Assistant annonce une adresse interne.
  • trusted_proxies et use_x_forwarded_for sont absents de la configuration http:, si bien que l’instance ne fait pas confiance aux en-têtes transmis.
  • Une redirection de http vers https, ou d’un domaine nu vers www, change l’émetteur en plein milieu de la poignée de main.

💡 Ordre de correction : réglez l’URL externe sur l’adresse HTTPS publique exacte que vous collerez dans ChatGPT, ajoutez votre proxy à la liste des proxys de confiance, redémarrez, puis supprimez et rajoutez le connecteur. Ne réessayez pas simplement l’ancien. Un enregistrement échoué resté en cache peut continuer à échouer.

Cause 3 : le connecteur est ajouté mais les outils ne s’exécutent jamais

Certains utilisateurs terminent la connexion OAuth, voient les outils listés, puis chaque appel est refusé. Des fils de la communauté évoquent des appels d’outils bloqués côté OpenAI alors même que la connexion semble saine. Si vos outils apparaissent mais que rien ne se passe :

  • Vérifiez que vous êtes sur une offre et un mode de ChatGPT qui autorisent les connecteurs personnalisés avec des actions d’écriture. Les conditions d’accès aux connecteurs MCP personnalisés ont changé plus d’une fois, alors consultez l’écran des paramètres actuel plutôt qu’un ancien article.
  • Commencez par une requête en lecture seule, comme « quelle est la température du couloir ? », avant de demander une action.
  • Ouvrez une nouvelle conversation. Les connecteurs activés en cours de discussion ne se rattachent parfois pas.

Cause 4 : la mauvaise forme d’URL

Beaucoup collent l’une de ces formes et se demandent pourquoi rien ne marche :

Ce que vous avez colléProblème
http://homeassistant.local:8123/api/mcpLocal uniquement, et non HTTPS
https://myhome.example.comChemin MCP absent
https://myhome.example.com/api/mcp/La barre oblique finale peut casser la correspondance stricte sur certains proxys
https://myhome.example.com/api/mcpForme correcte

Cause 5 : rien n’est exposé

Même une connexion parfaite ne sert à rien si aucune entité n’est exposée. Ouvrez les paramètres des assistants vocaux dans Home Assistant et exposez les lumières, interrupteurs, appareils de climatisation et scènes que vous voulez que l’assistant voie. Commencez avec cinq à dix entités. Une liste géante ralentit les réponses et augmente le risque que le modèle choisisse le mauvais appareil.

Une femme en chemise en jean souriant à son téléphone dans une cuisine lumineuse pendant qu’une suspension s’allume

Une liste de contrôle pas à pas pour corriger

Suivez-la dans l’ordre. Arrêtez-vous dès que quelque chose fonctionne.

  1. Vérifiez que l’intégration est activée. Dans Home Assistant, ajoutez l’intégration Model Context Protocol Server et vérifiez qu’elle se charge sans erreur.
  2. Vérifiez l’exposition. Assurez-vous qu’au moins une entité est exposée à l’assistant.
  3. Vérifiez l’URL externe. Paramètres, Système, Réseau. Utilisez la même adresse HTTPS que celle que vous prévoyez de donner à ChatGPT.
  4. Testez depuis l’extérieur. Données mobiles, sans VPN, chargez la page de connexion.
  5. Vérifiez les en-têtes du proxy. Si vous utilisez un proxy ou un tunnel, ajoutez-le à trusted_proxies.
  6. Supprimez les anciens connecteurs. Effacez les tentatives échouées dans ChatGPT avant d’en ajouter un nouveau.
  7. Ajoutez le connecteur. Collez l’URL complète /api/mcp et choisissez OAuth.
  8. Testez avec une question en lecture seule. Puis essayez une action anodine, comme une seule lampe.
  9. Lisez les journaux. Si quelque chose échoue encore, le journal de Home Assistant et celui de votre proxy désignent généralement le vrai coupable.

Un développeur dans un bureau à domicile lisant des journaux sur deux écrans à la lumière du soir

Lire les journaux sans perdre une soirée

Les journaux sont bruyants. Astuce pratique : copiez les dix lignes autour de la tentative de connexion échouée, retirez les jetons et adresses personnelles, puis collez-les dans un modèle de chat pour obtenir une explication en langage courant. Sur PicassoIA, vous pouvez le faire avec GPT-4o, Claude Sonnet 5 ou Gemini 3.5 Flash. Pour les configurations de proxy plus longues, GPT 5.6 Sol gère bien les tâches riches en code. Retirez toujours les secrets en premier.

Accès distant sans payer

Voici la partie que la plupart des tutoriels survolent. La solution la plus propre est Home Assistant Cloud de Nabu Casa. Elle gère pour vous l’adresse HTTPS publique et les certificats, et votre URL externe est détectée automatiquement. C’est aussi un abonnement payant, et il finance le développement du projet : c’est donc un choix légitime si vous voulez le moins d’efforts.

Mais vous avez demandé une configuration gratuite, alors voyons ce qui fonctionne réellement sans frais mensuels.

Vue de dessus d’un établi avec un petit ordinateur monocarte, un SSD, des câbles et un carnet avec un croquis de réseau

Option A : un service de tunnel gratuit

Un tunnel établit une connexion sortante depuis votre domicile vers un fournisseur, qui transmet ensuite le trafic HTTPS public jusqu’à vous. Vous n’ouvrez aucun port sur votre routeur.

Ce qu’il vous faut :

  • Un nom de domaine (le domaine est le seul petit coût incontournable, souvent quelques dollars par an) ou un sous-domaine gratuit chez certains fournisseurs.
  • L’extension ou le conteneur de tunnel à côté de Home Assistant.
  • Votre proxy ajouté à trusted_proxies.

Avantages : pas de redirection de port, fonctionne derrière un NAT opérateur (CGNAT), certificats gérés pour vous.

Inconvénients : vous dépendez d’un tiers, et certaines fonctions de tunnel modifient les conditions de leur offre gratuite.

Option B : DNS dynamique et redirection de port

La voie classique. Un nom DNS dynamique gratuit pointe vers votre IP domestique, votre routeur redirige le port 443 vers un reverse proxy, et le proxy obtient un certificat gratuit auprès de Let’s Encrypt.

Avantages : entièrement sous votre contrôle, aucun frais récurrent.

Inconvénients : nécessite une IP publique (pas derrière un NAT opérateur), expose un port, et exige de garder le proxy à jour.

Option C : une passerelle publique via un VPN maillé

Certains outils VPN maillés peuvent publier un service sur Internet en HTTPS, à une adresse générée, tandis que le reste de vos appareils reste privé. La mise en place est courte, mais l’adresse générée est fixée par le fournisseur : vérifiez donc que la découverte OAuth passe toujours avec ce nom d’hôte.

Quelle option gratuite vous convient

SituationMeilleur choixEffort
Derrière un NAT opérateur ou une connexion Internet d’immeuble partagéeService de tunnelFaible
Connexion domestique avec une vraie IP publique et un peu d’aisance en réseauDNS dynamique et reverse proxyMoyen
Vous voulez le test le plus rapidePasserelle VPN mailléFaible
Vous voulez zéro maintenanceHome Assistant Cloud (payant)Le plus faible

💡 Testez avant de vous engager. Quelle que soit votre option, vérifiez que la page https://your-address/api/mcp répond depuis les données mobiles avant de toucher à ChatGPT. Cela vous évite une heure de devinettes.

Un jeune homme sur un quai de gare au crépuscule, en train de regarder son téléphone

La voie du proxy webhook

Certains projets communautaires, comme l’extension ha-mcp, prennent une autre voie que l’intégration intégrée. Ils font tourner leur propre serveur MCP et l’exposent soit via une URL secrète, soit via un proxy webhook. Pour les utilisateurs de Nabu Casa, le proxy produit une adresse de la forme https://xxxxx.ui.nabu.casa/api/webhook/mcp_xxxxxxxx.

Si vous optez pour cette voie, trois points comptent :

  • Copiez l’URL complète depuis le journal de l’extension. Un secret mal saisi ou régénéré est une cause fréquente d’échec.
  • Traitez l’URL comme un mot de passe. Quiconque la détient pourrait atteindre vos outils.
  • Régénérez-la en cas de fuite. Mettez ensuite le connecteur à jour.

Cette voie est utile si le flux OAuth intégré continue d’échouer dans votre configuration. Le compromis : vous dépendez d’une extension tierce, alors lisez ce qu’elle expose avant de l’activer.

Rester en sécurité

Confier à un chatbot cloud le pouvoir d’actionner des interrupteurs mérite de la prudence. Quelques règles limitent le risque.

Un cadenas en laiton sur un portail de jardin en bois patiné, entouré de lierre et de lumière matinale

Exposez moins que vous ne le pensez

N’exposez pas les serrures de porte, les portes de garage, les centrales d’alarme ni rien qui ouvre votre domicile à un inconnu. Commencez avec les lumières, la climatisation et les médias. N’ajoutez davantage qu’une fois que vous faites confiance au comportement.

Utilisez un utilisateur dédié

Créez un utilisateur Home Assistant distinct pour l’assistant si votre configuration le permet, afin de pouvoir révoquer l’accès en un clic sans toucher à votre propre connexion.

Surveillez l’activité

Consultez le journal d’événements après les premières sessions. Vous verrez exactement quels services l’assistant a appelés. Si quelque chose vous surprend, réduisez la liste des entités exposées.

Gardez les logiciels à jour

Home Assistant et tout proxy ou extension de tunnel reçoivent des correctifs de sécurité. Une adresse publique rend les mises à jour plus importantes, pas moins.

Ne collez jamais de secrets dans un chat

Les jetons d’accès longue durée, les URL de webhook et les mots de passe n’ont pas leur place dans les prompts. Si vous partagez une configuration pour le dépannage, remplacez-les par des espaces réservés.

Ce que vous pouvez faire une fois que ça marche

Quand la connexion tient enfin, le plaisir commence. Voici des requêtes qui fonctionnent bien avec un jeu modeste d’entités exposées :

  • « Éteignez toutes les lumières du rez-de-chaussée sauf celle du couloir. »
  • « Y a-t-il encore quelque chose d’allumé dans la cuisine ? »
  • « Réglez le thermostat de la chambre à 19 degrés et dites-moi la valeur actuelle. »
  • « Lancez la scène cinéma. »
  • « Quelles fenêtres sont ouvertes en ce moment ? »

Une main appuyant sur un simple interrupteur mural blanc, avec une lampe chaude allumée en arrière-plan

Donnez de meilleurs noms aux entités

Le modèle choisit les appareils par leur nom. « Lumière 3 » est un mauvais nom. « Lampe de lecture du salon » est un bon nom. Consacrez vingt minutes à renommer les entités et les zones, et la précision progresse nettement. Affectez chaque appareil à une zone pour qu’une phrase comme « éteignez les lumières de la chambre » ait quelque chose à laquelle correspondre.

Utilisez les scripts et scènes comme raccourcis

Au lieu de faire composer à l’assistant cinq actions séparées, regroupez-les dans un script ou une scène. « Bonne nuit » devient un seul appel qui fige la logique à laquelle vous faites confiance : lumières éteintes, thermostat baissé, média en pause. Moins d’appels, c’est moins de risques d’erreur.

Demandez l’état avant l’action

Une habitude qui évite les surprises : demandez ce qui est allumé avant de demander d’éteindre quoi que ce soit. Cela confirme que la connexion est active et que les noms d’entités correspondent à ce que vous attendez.

Un couple détendu sur un canapé le soir avec un ordinateur portable, une lampe allumée et un chat sur une couverture

Toujours bloqué ? Tableau de diagnostic rapide

SymptômeCause la plus probableEssayez ceci
Cercle de chargement sans fin à l’ajout du connecteurServeur injoignable depuis InternetTestez l’URL en données mobiles
« Failed to resolve OAuth client »Décalage entre proxy, domaine ou URL externeAlignez l’URL externe, ajoutez les proxys de confiance, rajoutez le connecteur
Connexion réussie, aucun outil listéAucune entité exposéeExposez quelques entités dans les paramètres des assistants vocaux
Outils listés, actions refuséesOffre, mode ou appels d’outils bloquésEssayez une requête en lecture seule, une nouvelle conversation, vérifiez les paramètres du connecteur
Fonctionne un jour puis s’arrêteIP modifiée, tunnel expiré ou secret régénéréVérifiez le DNS dynamique, l’état du tunnel et le journal de l’extension
Mauvais appareil activéNoms d’entités vaguesRenommez les entités et affectez des zones
Erreur 404 sur l’URL du connecteurMauvais cheminUtilisez le chemin /api/mcp

Quel assistant associer à Home Assistant

ChatGPT n’est pas le seul assistant capable de dialoguer avec un serveur MCP. Si vous voulez un second avis ou une solution de secours quand un service est en panne, d’autres modèles de chat méritent d’être gardés sous la main pour l’aide à la configuration, l’écriture de YAML et la lecture des journaux. Sur PicassoIA, vous pouvez comparer Claude Fable 5 pour les tâches de code, Gemini 3.1 Pro pour les réponses générales, DeepSeek V3.1 pour un raisonnement économique, et GPT 5.6 Luna pour les réponses rapides. Ils sont pratiques pour rédiger des automatisations, transformer une idée floue en script propre, ou rendre un journal confus en langage clair. Ils ne se connectent pas à votre Home Assistant par eux-mêmes ici, mais ils accélèrent nettement tout le travail de dépannage.

💡 Prompt efficace pour l’aide à la configuration : « Voici ma section http: de Home Assistant et l’erreur du connecteur. Expliquez ce qui ne correspond pas et montrez une version corrigée. Utilisez des espaces réservés pour toute adresse ou tout jeton. »

Essayez par vous-même sur Picasso IA

Faire piloter votre maison par un chatbot est un projet satisfaisant, et la même curiosité paie ailleurs. Si le dépannage vous plaît, ouvrez les modèles de langage de Picasso IA et essayez de coller un journal, de rédiger une automatisation ou de demander une explication claire d’un paramètre de proxy. Puis allez plus loin : générez des images, de courts clips, des voix off ou de la musique avec les autres outils de la plateforme. Choisissez un modèle, rédigez un prompt, et voyez ce qui en ressort. Votre prochaine expérience ne tient qu’à un prompt.

Partager cet article

Choisissez votre langue

FreeCréez des images et vidéos IAGratuit, sans carte bancaireGénérations gratuites pour commencerSeedance 2.5 Lite inclusCommencez gratuitement