Connecteur Claude ne fonctionne pas ? Deux erreurs expliquées

Claude affiche deux erreurs principales quand un connecteur personnalisé échoue : « Couldn't reach the MCP server » (Impossible de joindre le serveur MCP) et « Authorization with the MCP server failed » (l'autorisation avec le serveur MCP a échoué). La plupart des causes se trouvent côté serveur, donc tes étapes utiles sont courtes. Vérifie que l'URL est exactement celle que le service t'a donnée, et que ton forfait ou le réglage de ton administrateur autorise les connecteurs personnalisés. Supprime le connecteur et ajoute-le à nouveau. Copie ensuite l'identifiant de référence qui commence par ofid_, et envoie-le à la personne qui gère le serveur.

Points clés

• Deux messages couvrent la plupart des échecs de connexion. Un troisième, « Unexpected error while invoking tool » (erreur inattendue lors de l'appel d'un outil), signifie que le connecteur est connecté et qu'un appel d'outil a échoué.
• La page de dépannage d'Anthropic indique que « Couldn't reach » « isn't always a network failure » (ce n'est pas toujours une panne réseau), traduction de notre part. Elle est écrite pour le développeur du serveur, pas pour toi.
• Sur le forfait Free, tu peux ajouter un seul connecteur personnalisé. Sur un forfait Team, seuls les « Owners » (propriétaires) et les « Primary Owners » (propriétaires principaux) peuvent en ajouter un.
• Pour changer les réglages d'un connecteur personnalisé, tu le supprimes puis tu l'ajoutes à nouveau. Il n'y a pas de bouton de modification.
• Une URL de serveur qui redirige vers un autre hôte perd l'en-tête de connexion en chemin, et Claude affiche alors l'erreur d'autorisation. Seul le propriétaire du serveur peut te donner la bonne URL, et tu devras peut-être ajouter à nouveau le connecteur avec celle-ci.
• L'identifiant ofid_ dans l'erreur a une durée limitée. Copie-le tout de suite après l'échec.

Que signifient les deux erreurs du connecteur Claude ?

Un connecteur personnalisé est un service que tu ajoutes à Claude par son URL, en utilisant le Model Context Protocol (MCP). Claude ne l'appelle pas depuis ton ordinateur. La page de dépannage d'Anthropic indique que les connecteurs sur claude.ai « run on Anthropic's infrastructure and reach your server over the public internet » (ils tournent sur l'infrastructure d'Anthropic et atteignent le serveur par internet public), traduction de notre part. Beaucoup de pannes viennent de ce fait : le serveur doit être joignable depuis l'extérieur de ton réseau, et pas seulement depuis toi.

La même page liste les messages et ce qu'ils couvrent. Elle décrit « Couldn't reach the MCP server » comme l'erreur affichée « when Claude can't complete the connection handshake » (quand Claude ne peut pas terminer la négociation de connexion), et ajoute : « Despite the wording, it isn't always a network failure » (malgré la formulation, ce n'est pas toujours une panne réseau), traduction de notre part. Elle décrit « Authorization with the MCP server failed » comme une erreur qui « usually appears after the OAuth flow has started » (apparaît en général après le début du flux OAuth). OAuth est la norme de connexion qu'utilisent les connecteurs.

Message	Quand il apparaît	Qui peut le corriger en général	Source
Couldn't reach the MCP server	Claude ne peut pas terminer la négociation de connexion	Le développeur du serveur (DNS, pare-feu, découverte de la connexion). Tu peux vérifier l'URL que tu as collée.	Troubleshoot your connector
Authorization with the MCP server failed	La connexion démarre mais ne se termine pas, ou l'URL redirige vers un autre hôte	Le développeur du serveur (configuration de la connexion, redirection). Tu peux te reconnecter ou ajouter à nouveau le connecteur.	Troubleshoot your connector
Unexpected error while invoking tool	Le connecteur apparaît comme connecté, mais un appel d'outil échoue	Le développeur du serveur. Cette erreur n'a pas d'identifiant ofid_.	Troubleshoot your connector

La page est franche sur son public : « This page is for the developer of the MCP server » (cette page est destinée au développeur du serveur MCP), traduction de notre part. Elle dit aussi que chaque message « covers several causes on your side » (couvre plusieurs causes de ton côté), où « your » désigne le développeur. C'est pourquoi une courte liste de vérifications pour toi suit, puis une liste plus longue de causes côté développeur. La page se trouve à claude.com/docs/connectors/building/troubleshooting.

Que peux-tu vérifier toi-même ?

Cinq étapes suivent l'aide et les pages de test et de dépannage d'Anthropic. Elles ne demandent aucun outil de développeur.

1. Forfait et rôle. L'aide d'Anthropic indique que les connecteurs personnalisés sont disponibles « for users on Free, Pro, Max, Team, and Enterprise plans » (pour les utilisateurs des forfaits Free, Pro, Max, Team et Enterprise), traduction de notre part. Elle précise que « Free users are limited to one custom connector » (les utilisateurs Free sont limités à un connecteur personnalisé) et que « only Owners and Primary Owners can add them to Team plans » (seuls les Owners et les Primary Owners peuvent en ajouter sur les forfaits Team). Sur Enterprise, la page cite aussi les personnes ayant un rôle personnalisé qui inclut « Manage access to Libraries ». Si tu es sur Team et que tu n'es pas Owner, demande à un Owner de l'ajouter.
2. L'URL, exactement telle que le service la donne. Colle-la en entier, avec le chemin. Si la page du service liste une seconde adresse, par exemple avec www. devant, utilise celle que le service indique. Une URL qui redirige vers un autre hôte est une cause connue de l'erreur d'autorisation (voir l'exemple résolu plus bas).
3. Supprime-le, puis ajoute-le à nouveau. La page d'aide dit : « If you're hoping to edit a custom connector, you'll need to remove it first, then re-add it using the updated details » (si tu veux modifier un connecteur personnalisé, tu dois d'abord le supprimer, puis le rajouter avec les nouvelles informations), traduction de notre part. Sur le web et le bureau, les utilisateurs Pro et Max individuels trouvent les connecteurs sous « Customize » (Personnaliser) > « Connectors » (Connecteurs). Les Owners des forfaits Team et Enterprise passent par « Organization settings » (Paramètres de l'organisation) > « Connectors » (Connecteurs).
4. Reconnecte-toi quand Claude le demande. La page de test d'Anthropic indique qu'un connecteur qui fonctionne affiche Connected (Connecté) sous « Your connectors » (Tes connecteurs). S'il affiche Connect (Connecter) ou Reconnect (Reconnecter) à la place, « sign-in didn't finish » (la connexion n'est pas allée à son terme), traduction de notre part. Termine l'étape de connexion, puis vérifie à nouveau le statut.
5. Copie l'identifiant ofid_. Il figure dans le message d'erreur et dans l'adresse de la page. Copie-le avant de fermer l'onglet.

Rien dans ces pages ne suggère de désactiver une protection du navigateur, un pare-feu ou une étape de connexion. Si une étape le demande, arrête-toi et demande au fournisseur du service.

Que peut corriger seul le développeur du serveur ?

Quand les cinq vérifications ne suffisent pas, la cause se trouve en général dans la configuration du serveur. Tu n'as pas à corriger ces points, mais les connaître t'indique ce qu'il faut demander. Le tableau suit la page de dépannage d'Anthropic, en termes simples.

Cause	Ce que fait Claude	Vérification du développeur
Le nom d'hôte se résout en une adresse privée	Rejette la connexion avant qu'aucune requête ne sorte d'Anthropic. Les journaux du serveur ne voient rien.	Résous le nom d'hôte depuis l'extérieur du réseau. Chaque adresse doit être routable publiquement.
Un pare-feu ou une règle anti-bot bloque Anthropic	La requête est arrêtée avant que l'application ne la voie.	Cherche des réponses 403 ou 429 dans les journaux en bordure de réseau (edge). Autorise la plage d'adresses IP publiée par Anthropic.
L'URL redirige vers un autre hôte	Perd l'en-tête de connexion lors de la redirection. La cible répond 401. Claude affiche l'erreur d'autorisation.	Demande l'URL et lis la cible de la redirection. Enregistre cette URL.
Les données de découverte de la connexion manquent	Ne peut pas trouver le serveur d'autorisation. Peut afficher « Couldn't reach » même si le point de terminaison répond.	Demande les documents de découverte depuis un réseau public. Ils doivent répondre 200.
Aucun moyen d'enregistrer un client	Ne peut pas obtenir d'identité client, donc la connexion ne peut pas démarrer.	Propose l'enregistrement dynamique du client, des documents de métadonnées d'identifiant client ou des identifiants pré-enregistrés.
PKCE avec S256 n'est pas pris en charge	Le flux échoue au point de terminaison des jetons.	Prends en charge S256 et annonce-le dans les métadonnées du serveur d'autorisation.
Le point de terminaison des jetons prend plus de 10 secondes	Attend 10 secondes au maximum la réponse, puis échoue, même si le jeton est émis plus tard.	Mesure le gestionnaire de jetons et tout proxy placé devant lui.

La même page liste d'autres causes de l'erreur d'autorisation, comme une incohérence de l'émetteur (issuer), une incohérence de l'audience et des échecs de renouvellement de jeton. Sa liste de diagnostic suit l'ordre dans lequel Claude passe chaque étape. Un de ses contrôles est une simple requête des en-têtes de redirection :

curl -sI https://your-server.example.com/your-mcp-path

Si la réponse est une 3xx qui pointe vers un autre hôte, « that target is the URL you should register » (cette cible est l'URL à enregistrer), traduction de notre part. La page de dépannage indique que les requêtes sortantes d'Anthropic viennent d'une plage publiée, qu'Anthropic liste sur sa page des adresses IP. La spécification d'autorisation MCP indique que les serveurs MCP « MUST implement » OAuth 2.0 Protected Resource Metadata, défini dans la RFC 9728. Ces métadonnées sont ce que désignent les lignes « découverte » du tableau ci-dessus.

Qu'est-ce que l'identifiant de référence ofid_ et qui le reçoit ?

Quand une connexion ou une autorisation échoue sur claude.ai, la page d'Anthropic dit que « the error message and the page URL include a reference ID that starts with ofid_ » (le message d'erreur et l'URL de la page contiennent un identifiant de référence qui commence par ofid_), traduction de notre part. Cet identifiant « lets Anthropic trace the exact failure on its side, and it's time-limited, so report soon after the failure » (permet à Anthropic de retrouver l'échec exact de son côté ; il a une durée limitée, donc signale-le peu après l'échec), traduction de notre part.

La voie prévue par Anthropic pour un signalement est un ticket sur le suivi de tickets anthropics/claude-ai-mcp, avec l'identifiant, l'URL du serveur et ce que les journaux du serveur montrent pendant la tentative. La page s'adresse aux développeurs, qui peuvent fournir ces journaux. Toi, non. L'ordre que nous suggérons est donc le suivant : envoie d'abord l'identifiant, le message exact et l'heure au fournisseur du service. Si le fournisseur ne trouve rien de son côté, c'est lui qui ouvre le ticket. Si tu l'ouvres toi-même, le suivi est lisible sans connexion, donc retire les données personnelles et tout jeton.

Une panne d'appel d'outil est différente. Anthropic indique qu'« there is no ofid_ reference ID » (il n'y a pas d'identifiant de référence ofid_) pour celle-ci, traduction de notre part. Un signalement pour cette erreur contient le nom de l'outil et l'heure de la panne en UTC.

Exemple : une URL qui redirige vers www

Exemple résolu (hypothétique) : un service te demande d'ajouter https://example.com/mcp. Rien ici n'est une vraie sortie de serveur. Cet exemple suit seulement une erreur, du message jusqu'à la cause.

1. Message : tu ajoutes l'URL et tu cliques sur Connect. Claude affiche « Authorization with the MCP server failed ». Cela fonctionne pour le développeur dans MCP Inspector ou Claude Code.
2. Cause : le serveur répond 301 et envoie les clients vers https://www.example.com/mcp. La page d'Anthropic explique la suite : Claude suit la redirection, perd l'en-tête de connexion, la cible répond 401, et l'erreur d'autorisation apparaît. Les clients locaux « fail fast on a redirect » (échouent vite sur une redirection), et claude.ai non, donc la panne se montre plus tard, sous forme d'erreur d'autorisation.
3. Vérification : curl -sI https://example.com/mcp renvoie un statut 3xx et un en-tête Location sur l'hôte www..
4. Correction : le développeur confirme l'URL finale. Tu supprimes le connecteur et tu l'ajoutes à nouveau avec https://www.example.com/mcp.

La page d'Anthropic cite la redirection parmi les causes de l'erreur d'autorisation. Cela rend la vérification de l'étape 3 utile à demander au propriétaire.

Cela explique le constat courant selon lequel un connecteur fonctionne dans MCP Inspector ou Claude Code mais pas dans claude.ai. La page donne aussi une deuxième raison : « the CLI and curl connect from your machine, while claude.ai connects from Anthropic's servers » (la CLI et curl se connectent depuis ta machine, alors que claude.ai se connecte depuis les serveurs d'Anthropic), traduction de notre part. Si un nom d'hôte se résout différemment à l'intérieur et à l'extérieur d'un réseau d'entreprise, claude.ai peut obtenir une adresse privée et afficher « Couldn't reach ».

Que dois-tu savoir avant d'ajouter un connecteur personnalisé ?

Un connecteur personnalisé peut être n'importe quel service dont le propriétaire publie une URL. L'aide d'Anthropic indique que les connecteurs personnalisés relient Claude à des services arbitraires qu'Anthropic n'a pas examinés. Elle avertit aussi : « Malicious MCP servers may include hidden instructions that try to make Claude perform unintended actions. » (des serveurs MCP malveillants peuvent contenir des instructions cachées qui tentent de faire agir Claude de façon non voulue), traduction de notre part.

La page donne deux bons réflexes. Examine chaque demande d'approbation d'outil avant de l'autoriser : « Review Claude's tool approval requests carefully » (examine attentivement les demandes d'approbation d'outil de Claude). Choisis « Allow always » (Toujours autoriser) seulement pour les serveurs et les outils en qui tu as confiance. N'ajoute un connecteur que si tu sais qui exploite le service et ce qu'il peut faire de tes données. La page se trouve à Get started with custom connectors using remote MCP.

Et si c'est le connecteur Remembite ?

L'URL du connecteur Remembite est https://remembite.com/mcp. Il fonctionne dans Claude, y compris dans l'application iPhone. Remembite fonctionne aussi dans ChatGPT (bêta, via le mode développeur) : dépannage ChatGPT. Commence par le guide qui correspond à ce que tu vois :

• Connecté, mais Claude n'affiche aucun outil Remembite : le connecteur Remembite n'affiche aucun outil.
• Claude te demande de te connecter ou d'autoriser à nouveau : Claude demande de reconnecter Remembite.
• Première configuration, étape par étape : connecter Remembite à Claude.
• Toujours bloqué après ces pages : support Remembite. Indique le message exact et l'identifiant ofid_.

Ton IA fait les calculs. Remembite tient le journal. Le connecteur est le lien entre les deux, donc pour un pas à pas d'enregistrement de repas, lis comment enregistrer des repas avec Claude. Pour comprendre comment les pièces s'emboîtent, lis comment fonctionne Remembite. Pour savoir ce qu'est un serveur MCP, lis le guide du serveur MCP nutrition.

Que ne couvre pas cette page ?

• Les pages d'Anthropic changent. Chaque citation ici a été lue le 18 oct. 2026. Si un nom de menu ou une limite diffère quand tu lis cette page, la page d'Anthropic fait foi.
• Nous n'avons pas reproduit ces erreurs. Les causes viennent des pages d'Anthropic et de la spécification MCP, pas de nos propres tests.
• Cette page couvre les connecteurs personnalisés. Les connecteurs du répertoire d'Anthropic sont un cas à part.
• Elle ne dit rien d'un serveur particulier, y compris de la question de savoir si un service donné est bien exploité ou maintenu en service.
• La liste des vérifications pour toi est volontairement courte. Elle ne contient que les étapes qu'une page d'Anthropic étaye.

Questions fréquentes

Pourquoi mon connecteur personnalisé Claude ne fonctionne-t-il pas ?

Claude joint le serveur depuis l'infrastructure d'Anthropic, donc une adresse privée, une règle de pare-feu, une redirection ou un problème de configuration de connexion côté serveur peuvent tout bloquer. Vérifie ton forfait, l'URL exacte et si la connexion est allée à son terme, puis ajoute à nouveau le connecteur et envoie l'identifiant ofid_ au propriétaire du serveur.

Pourquoi cela fonctionne-t-il dans Claude Code ou MCP Inspector mais pas dans Claude ?

Anthropic indique que les outils locaux se connectent depuis ta machine, et claude.ai depuis les serveurs d'Anthropic. Un nom d'hôte qui se résout différemment hors de ton réseau, ou une URL qui redirige vers un autre hôte, n'apparaît que dans claude.ai.

Qu'est-ce que l'identifiant ofid_ dans l'erreur ?

C'est un identifiant de référence, présent dans le message d'erreur et dans l'URL de la page, qui permet à Anthropic de retrouver une connexion échouée. Il a une durée limitée : copie-le peu après l'échec et donne-le au fournisseur du service.

Faut-il un forfait payant pour ajouter un connecteur personnalisé ?

La page d'aide d'Anthropic, lue le 18 oct. 2026, liste les forfaits Free, Pro, Max, Team et Enterprise. Free est limité à un connecteur personnalisé. Les règles des forfaits peuvent changer, donc vérifie la page.

Pourquoi ne puis-je pas ajouter de connecteur sur un forfait Team ?

La page d'aide indique que seuls les Owners et les Primary Owners peuvent ajouter des connecteurs personnalisés sur les forfaits Team. Demande à un Owner de l'ajouter sous « Organization settings » (Paramètres de l'organisation) > « Connectors » (Connecteurs).

Estimations, pas des conseils médicaux. Comment fonctionnent les chiffres.