Connecteurs Claude absents des paramètres, bloqués sur Connect ou en erreur en pleine conversation ? Cet article classe les causes par symptôme : limites du forfait, validation par l’administrateur, boucles de connexion, serveurs injoignables, fichiers de configuration erronés et erreurs d’outils, avec une solution concrète pour chacune.
Peu de choses dans Claude sont aussi agaçantes qu’un connecteur qui fonctionnait hier et a disparu aujourd’hui. Le menu des connecteurs est vide, le bouton Connect tourne indéfiniment, ou un outil qui semblait en bon état génère une erreur au milieu d’une conversation. La bonne nouvelle, c’est que presque tous les cas remontent à une poignée de causes, et vous pouvez les écarter en une dizaine de minutes si vous procédez dans le bon ordre.
Cet article suit cet ordre. Il commence par les vérifications basiques (forfait, paramètres d’administration, compte), car elles expliquent la plupart des signalements « absent », puis passe aux échecs de connexion, à l’accessibilité des serveurs, aux erreurs de configuration locale et aux erreurs qui n’apparaissent qu’une fois qu’un connecteur s’affiche comme connecté. Les menus et les libellés changent souvent. Si un bouton ne se trouve pas où vous l’attendez, cherchez la zone Connecteurs ou Personnaliser dans les paramètres.
💡 Règle générale : si le connecteur n’est pas visible, soupçonnez votre forfait ou un paramètre d’administration. S’il est visible mais ne se connecte pas, soupçonnez la connexion ou l’accessibilité. S’il se connecte mais échoue en conversation, soupçonnez l’appel de l’outil lui-même.
Commencez par identifier votre symptôme, car chacun renvoie à une solution différente :
Les connecteurs, et en particulier les connecteurs personnalisés qui pointent vers un serveur MCP distant, sont réservés aux forfaits payants. Sur un forfait qui ne les inclut pas, l’option Connecteurs n’apparaît tout simplement pas, et aucun rafraîchissement ne la fera revenir. Ouvrez les paramètres de votre compte, vérifiez le forfait actif et comparez-le à l’article d’aide officiel sur les connecteurs. Si vous avez récemment changé de forfait ou d’espace de travail, déconnectez-vous puis reconnectez-vous pour que le nouveau forfait soit pris en compte.
Sur les forfaits Team et Enterprise, un Owner ou le Primary Owner doit activer un connecteur pour l’organisation avant que quiconque puisse l’utiliser. Dans la zone d’administration, il faut ouvrir la liste des connecteurs via Parcourir les connecteurs, puis choisir Ajouter à votre équipe. Activer un connecteur le rend seulement disponible. Chaque personne doit ensuite se connecter individuellement. Voir « connecté » chez un collègue ne vous dit donc rien de votre propre compte.
Trois questions à poser à votre administrateur :
Elles ne prennent que deux minutes et règlent une part surprenante des cas. Faites-les avant de toucher aux paramètres du serveur.
Les sessions périmées provoquent des problèmes fantômes. Suivez ces étapes dans l’ordre et testez après chacune :
Un connecteur peut être connecté tout en étant désactivé pour la conversation en cours. Ouvrez le menu des outils près de la zone de saisie et vérifiez que le connecteur est activé. Contrôlez ensuite ses autorisations d’outils : chaque outil peut être réglé sur demander d’abord, toujours autoriser ou rester bloqué. Un outil bloqué ressemble exactement à un outil absent.
| Symptôme | Cause la plus probable | Solution la plus rapide |
|---|---|---|
| Aucune option Connecteurs dans les paramètres | Votre forfait ne l’inclut pas | Vérifiez le forfait, passez à un forfait supérieur ou demandez à votre administrateur |
| Connecteur présent pour les autres, pas pour vous | Jamais connecté, ou non ajouté par un Owner | Demandez à l’Owner de l’ajouter, puis connectez-vous vous-même |
| Le bouton Connect ne fait rien | Pop-up bloquée ou session périmée | Autorisez les pop-ups, actualisez, réessayez |
| Connecté, mais Claude l’ignore | Désactivé dans cette conversation | Activez-le dans le menu des outils |
| Fonctionnait hier, échoue aujourd’hui | Jeton expiré ou révoqué | Déconnectez-vous, puis reconnectez-vous |
Quand le connecteur est visible mais que la connexion échoue, le problème se situe entre votre navigateur, la page de connexion de l’autre service et Claude.
La connexion ouvre une page de connexion de l’autre service : votre agenda, votre CRM ou votre propre serveur. Si cette fenêtre n’apparaît jamais, se ferme immédiatement ou revient au début :
💡 Reconnectez-vous proprement. Supprimez le connecteur, fermez l’onglet, reconnectez-vous, puis ajoutez-le à nouveau. Une tentative précédente restée inachevée peut laisser un état défectueux que des essais répétés ne réparent jamais.
Le message « Authorization with the MCP server failed » apparaît généralement une fois la connexion déjà commencée. La documentation de dépannage des connecteurs d’Anthropic répertorie les causes suivantes, côté serveur :
Si vous utilisez simplement le connecteur de quelqu’un d’autre, transmettez-lui cette liste. Si vous gérez le serveur, la section suivante vous concerne.
Ce message évoque une panne réseau, pourtant la cause est souvent plus discrète. Le fait essentiel : les connecteurs distants sur claude.ai fonctionnent sur l’infrastructure d’Anthropic, et non sur votre ordinateur. Claude résout le nom d’hôte de votre serveur depuis l’internet public, et si le résultat n’est pas routable globalement, il rejette la connexion avant même l’envoi de la moindre requête. Vos journaux d’accès n’affichent alors absolument rien.
Claude rejette les noms d’hôte qui se résolvent vers des plages privées (10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16), les adresses de NAT de niveau opérateur (100.64.0.0/10), les adresses de bouclage ou de liaison locale, ou un mélange de résultats publics et privés. Les connecteurs ne fonctionnent aussi qu’en IPv4, donc un nom d’hôte qui ne dispose que d’enregistrements AAAA échoue.
Cela explique la plainte classique : « Ça marche dans Claude Code et avec curl, mais pas sur claude.ai. » Ces outils se connectent depuis votre machine, alors que claude.ai se connecte depuis le cloud. Si votre nom d’hôte se résout d’une façon à l’intérieur de votre réseau et d’une autre à l’extérieur (DNS à vues séparées), ou s’il se cache derrière un VPN, un fournisseur de DNS dynamique ou un routeur domestique avec CGNAT, l’application web ne reçoit jamais d’adresse utilisable.
Vérifiez depuis un réseau extérieur au vôtre :
dig +short your-server.example.com
Chaque adresse renvoyée doit être publique. Pour un serveur installé sur votre ordinateur portable, exposez-le via un tunnel public ou un proxy inverse plutôt qu’avec une URL localhost.
Avec un DNS correct, un CDN, un WAF ou un limiteur de débit peut encore rejeter la requête avant que votre application ne la voie. Repérez les réponses 403 ou 429 dans vos journaux de périphérie pendant une tentative de connexion, puis ajoutez à la liste autorisée la plage sortante publiée sur la page des adresses IP d’Anthropic, ou exemptez les chemins MCP et de connexion de la règle de blocage.
Vérifiez ensuite les redirections :
curl -sI https://your-server.example.com/mcp
Si la réponse est une 301, 302, 307 ou 308 pointant vers un autre hôte, enregistrez cette URL cible à la place. Les clients locaux échouent aussitôt sur la redirection, alors que claude.ai la suit, perd l’identifiant et signale plus tard une erreur d’autorisation.
Quand un serveur exige une connexion, Claude consulte d’abord ses métadonnées OAuth. Demandez chaque document depuis un réseau public et attendez un 200 avec un JSON valide :
curl -i https://your-server.example.com/.well-known/oauth-protected-resource
curl -i https://your-server.example.com/.well-known/oauth-authorization-server
curl -i https://your-server.example.com/.well-known/openid-configuration
Une seule des deux dernières réponses suffit. Les métadonnées doivent aussi proposer un moyen d’enregistrer Claude comme client (enregistrement dynamique de client, documents de métadonnées d’identifiant client, ou identifiants préenregistrés) et annoncer la prise en charge de S256 PKCE. Un proxy qui supprime l’en-tête WWW-Authenticate, ou qui renvoie un 403 sur les chemins /.well-known/, produit le même message « couldn’t reach » alors que le serveur derrière lui est parfaitement sain.
Microsoft Entra mérite sa propre remarque. Si la requête de jeton échoue avec AADSTS9010010, Entra rejette la valeur de ressource que Claude envoie. Enregistrez l’URL complète de votre serveur MCP comme Application ID URI sur l’inscription d’application de l’API, en utilisant un domaine personnalisé vérifié si vous êtes sur un nom d’hôte de plateforme.
💡 Conservez l’identifiant de référence. Lorsqu’une connexion échoue sur claude.ai, l’URL de la page d’erreur contient une valeur qui commence par
ofid_. Copiez-la immédiatement, car elle expire, et joignez-la quand vous ouvrez un ticket sur le suivi anthropics/claude-ai-mcp.
Les serveurs qui tournent sur votre propre machine suivent un autre chemin. L’application de bureau les lance à partir d’un fichier de configuration : rien ne transite par internet, et aucun des conseils DNS ci-dessus ne s’applique.
Les échecs locaux les plus courants sont banals :
npx ou node fonctionne dans un terminal mais pas depuis l’application. Utilisez le chemin absolu de l’exécutable.Passez le fichier dans un validateur JSON avant de redémarrer.
L’application de bureau écrit les journaux MCP dans %APPDATA%\Claude\logs sous Windows et dans ~/Library/Logs/Claude sous macOS, avec un journal MCP général et un fichier par serveur. Un serveur qui plante au démarrage affiche généralement la raison ici : un paquet manquant, une mauvaise version de Node ou une variable d’environnement absente. Dans Claude Code, claude mcp list affiche l’état de chaque serveur configuré, et /mcp dans une session affiche les détails et permet de se connecter.
« Unexpected error while invoking tool », suivi d’un nom d’outil, signifie que la connexion elle-même est saine. La requête de Claude a atteint le serveur, et celui-ci a répondu par une erreur. Il n’y a pas d’identifiant de référence ofid_ ici, car rien n’a échoué au moment de la connexion.
Procédez par étapes dans cet ordre :
Les limites de débit sont un autre coupable fréquent, et elles semblent aléatoires. Beaucoup de services plafonnent le nombre de tâches exécutées simultanément. La connexion MCP de PicassoIA en est un bon exemple : ses modèles d’image, d’édition d’image et de vidéo partagent une limite de 5 prédictions en cours par compte, pour l’ensemble des identifiants et des connexions MCP. Au moment de la rédaction, vous ajoutez cette connexion depuis la page MCP de votre compte, ce qui nécessite une connexion. Si Claude lance dix générations en une seule requête, certaines échoueront. Demandez-lui de travailler par lots plus petits.
Voici un petit décodeur pour les messages que vous rencontrerez le plus souvent :
| Message | Signification | Où chercher |
|---|---|---|
| Impossible de joindre le serveur MCP | La prise de contact a échoué | DNS, pare-feu, redirections, métadonnées OAuth |
| L’autorisation avec le serveur MCP a échoué | La connexion a démarré mais ne s’est pas terminée | Émetteur, audience, PKCE, vitesse du jeton, redirections |
| Erreur inattendue lors de l’appel de l’outil | Connecté, mais l’appel de l’outil a échoué | Journaux du serveur, MCP Inspector, limites de débit |
| Aucune option Connecteurs | Paramètre du plan ou de l’organisation | Page du plan, paramètres d’administration |
Un connecteur défaillant ne doit pas paralyser votre journée. Pendant que vous le réparez, collez le texte de l’erreur, un extrait de journal ou une capture d’écran dans un modèle qui ne dépend d’aucun connecteur. Claude Sonnet 5 est disponible sur PicassoIA, gère le code et les tâches qui reposent beaucoup sur les outils, et accepte les images en entrée, ce qui convient aux captures d’écran de pages d’erreur.
💡 Retirez d’abord les secrets. Supprimez les jetons, les secrets client et les mots de passe de toute configuration ou de tout journal avant de les coller n’importe où.
Avant de fermer l’onglet des paramètres, faites cette dernière vérification :
ofid_ est conservé si vous avez besoin d’aide
Une fois vos connecteurs de nouveau opérationnels, donnez-leur quelque chose de créatif à faire. Picasso IA transforme un court prompt en image photoréaliste en quelques secondes avec PicassoIA Image, vous permet d’affiner le résultat avec PicassoIA Image Editor Pro, et anime une image fixe avec PicassoIA Video. Ouvrez la plateforme, rédigez un prompt sur une scène que vous avez en tête, modifiez l’éclairage ou l’angle de prise de vue, puis relancez. Dix minutes d’expérimentation vous montreront ce que fait le mieux chaque modèle, et vous pouvez parcourir toutes les options sur la page de tous les modèles.
Choisissez votre langue
