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.

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 :
- Vous activez l’intégration de serveur MCP dans Home Assistant.
- Vous décidez quelles entités l’assistant peut voir, via les paramètres d’exposition d’Assist.
- Vous collez l’URL du serveur dans ChatGPT comme connecteur personnalisé et choisissez OAuth comme méthode d’authentification.
- 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 client | D’où vient la requête | Accès public nécessaire ? |
|---|
| Application de bureau sur votre réseau domestique | Votre propre ordinateur | Généralement non |
| ChatGPT sur le site web | Serveurs d’OpenAI | Oui |
| Application mobile en données mobiles | Cloud ou téléphone, hors de votre LAN | Oui |
| Script ou agent local | Même réseau | Non |
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.

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/mcp | Local uniquement, et non HTTPS |
https://myhome.example.com | Chemin 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/mcp | Forme 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 liste de contrôle pas à pas pour corriger
Suivez-la dans l’ordre. Arrêtez-vous dès que quelque chose fonctionne.
- 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.
- Vérifiez l’exposition. Assurez-vous qu’au moins une entité est exposée à l’assistant.
- 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.
- Testez depuis l’extérieur. Données mobiles, sans VPN, chargez la page de connexion.
- Vérifiez les en-têtes du proxy. Si vous utilisez un proxy ou un tunnel, ajoutez-le à
trusted_proxies.
- Supprimez les anciens connecteurs. Effacez les tentatives échouées dans ChatGPT avant d’en ajouter un nouveau.
- Ajoutez le connecteur. Collez l’URL complète
/api/mcp et choisissez OAuth.
- Testez avec une question en lecture seule. Puis essayez une action anodine, comme une seule lampe.
- 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.

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.

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
| Situation | Meilleur choix | Effort |
|---|
| Derrière un NAT opérateur ou une connexion Internet d’immeuble partagée | Service de tunnel | Faible |
| Connexion domestique avec une vraie IP publique et un peu d’aisance en réseau | DNS dynamique et reverse proxy | Moyen |
| Vous voulez le test le plus rapide | Passerelle VPN maillé | Faible |
| Vous voulez zéro maintenance | Home 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.

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.

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 ? »

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.

Toujours bloqué ? Tableau de diagnostic rapide
| Symptôme | Cause la plus probable | Essayez ceci |
|---|
| Cercle de chargement sans fin à l’ajout du connecteur | Serveur injoignable depuis Internet | Testez l’URL en données mobiles |
| « Failed to resolve OAuth client » | Décalage entre proxy, domaine ou URL externe | Alignez l’URL externe, ajoutez les proxys de confiance, rajoutez le connecteur |
| Connexion réussie, aucun outil listé | Aucune entité exposée | Exposez quelques entités dans les paramètres des assistants vocaux |
| Outils listés, actions refusées | Offre, mode ou appels d’outils bloqués | Essayez une requête en lecture seule, une nouvelle conversation, vérifiez les paramètres du connecteur |
| Fonctionne un jour puis s’arrête | IP 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 vagues | Renommez les entités et affectez des zones |
| Erreur 404 sur l’URL du connecteur | Mauvais chemin | Utilisez 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.