Les connecteurs personnalisés utilisant MCP distant sont disponibles sur Claude, Cowork et Claude Desktop pour les utilisateurs des plans Free, Pro, Max, Team et Enterprise. Les utilisateurs gratuits sont limités à un connecteur personnalisé. Cette fonctionnalité est actuellement en version bêta.
Créer des serveurs MCP distants
Pour commencer avec les serveurs distants, consultez les ressources suivantes :
La spécification d'authentification, en particulier les détails sur le flux d'authentification pour les services tiers.
Les exemples de serveur distant dans les SDK TypeScript et Python.
Les implémentations d'authentification client et serveur dans les SDK TypeScript et Python.
La feuille de route officielle de MCP et le journal des modifications de la spécification brouillon pour connaître l'évolution du protocole.
D'autres ressources (comme celle-ci) peuvent également être utiles pour en savoir plus sur les considérations lors de la création, du déploiement et du dépannage des serveurs distants.
De plus, certaines solutions comme Cloudflare offrent l'hébergement de serveurs MCP distants avec mise à l'échelle automatique intégrée, gestion des jetons OAuth et déploiement.
Support MCP
Plateformes
Les serveurs MCP distants sont pris en charge sur Claude et Claude Desktop pour les plans Pro, Max, Team et Enterprise.
Pour configurer les serveurs MCP distants à utiliser dans Claude Desktop, ajoutez-les via Personnaliser > Connecteurs. Claude Desktop ne se connectera pas aux serveurs distants configurés directement via
claude_desktop_config.json.
Depuis juillet, Claude pour iOS et Android prennent également en charge les serveurs MCP distants !
Les utilisateurs peuvent utiliser les outils, les invites et les ressources des serveurs distants qu'ils ont déjà ajoutés via claude.ai. Les utilisateurs ne peuvent pas ajouter de nouveaux serveurs directement depuis Claude Mobile.
Accessibilité réseau
Toutes les connexions MCP distantes proviennent de l'infrastructure cloud d'Anthropic, quel que soit le client Claude que l'utilisateur exécute. Votre serveur doit accepter les connexions HTTPS entrantes à partir des plages d'adresses IP d'Anthropic — consultez Adresses IP d'Anthropic pour la liste actuelle.
Cela s'applique même lorsque les utilisateurs exécutent Cowork ou Claude Desktop localement. Les connecteurs distants ajoutés via Personnaliser > Connecteurs sont gérés côté serveur, de sorte que la demande à votre serveur MCP provient d'Anthropic, et non de la machine de l'utilisateur.
Si votre serveur s'exécute dans un réseau privé, configurez votre pare-feu ou votre entrée pour autoriser le trafic entrant à partir des plages d'adresses IP publiées d'Anthropic. Les serveurs qui ne sont accessibles que via VPN ou derrière un pare-feu qui bloque les adresses IP de sortie d'Anthropic ne pourront pas se connecter.
Transport et authentification
Claude prend en charge les serveurs distants basés sur SSE et HTTP Streamable, bien que le support de SSE puisse être déprécié dans les mois à venir.
Claude prend en charge les serveurs distants sans authentification et basés sur OAuth.
Support d'authentification
Claude prend en charge la spécification d'authentification 3/26 et (depuis juillet) la spécification d'authentification 6/18.
Claude prend en charge l'enregistrement dynamique des clients (DCR).
Les serveurs OAuth peuvent signaler à Claude qu'un client DCR a été supprimé et que Claude doit réenregistrer le client en renvoyant un HTTP 401 avec une erreur invalid_client du point de terminaison du jeton, comme décrit dans RFC 6749.
Depuis juillet, les utilisateurs peuvent également spécifier un ID client et un secret client personnalisés lors de la configuration d'un serveur qui ne prend pas en charge DCR.
L'URL de rappel OAuth de Claude est https://claude.ai/api/mcp/auth_callback et son nom de client OAuth est Claude.
Cette URL de rappel peut changer en https://claude.com/api/mcp/auth_callback à l'avenir — si vous choisissez de mettre en liste blanche les URL de rappel des clients MCP, veuillez également mettre en liste blanche cette URL de rappel pour vous assurer que votre serveur continue de fonctionner avec Claude.
Claude prend en charge l'expiration et l'actualisation des jetons — les serveurs doivent prendre en charge cette fonctionnalité pour offrir la meilleure expérience aux utilisateurs.
Consultez ici pour connaître les adresses IP utilisées par Claude pour les connexions entrantes et sortantes vers les serveurs MCP. Les développeurs de serveurs souhaitant interdire les clients MCP non-Claude peuvent mettre en liste blanche ces adresses IP, l'URL de rappel OAuth de Claude et/ou le nom du client OAuth de Claude.
Fonctionnalités du protocole
Claude prend en charge les outils, les invites et les ressources.
Claude prend en charge les résultats d'outils basés sur du texte et des images.
Claude prend en charge les ressources basées sur du texte et du binaire.
Claude ne prend pas encore en charge les abonnements aux ressources, l'échantillonnage et d'autres capacités plus avancées ou brouillon.
Tester les serveurs MCP distants
La meilleure façon de tester et de valider un serveur est d'essayer de l'ajouter à Claude.
Vous pouvez également utiliser l'outil inspecteur. Cela vous permettra de valider :
que votre serveur initie et complète correctement le flux d'authentification.
que votre serveur implémente correctement diverses parties du flux d'authentification.
quels outils, invites, ressources et autres fonctionnalités MCP votre serveur expose.
Consultez la documentation MCP pour plus de détails sur l'utilisation de l'inspecteur et pour d'autres conseils sur la façon de déboguer et dépanner votre serveur.
De plus, d'autres solutions comme le terrain de jeu IA de Cloudflare vous permettent de tester la fonctionnalité du serveur MCP distant.