Une URL de serveur MCP est l’adresse web que votre client d’IA appelle pour joindre un serveur distant du Model Context Protocol. Cet article détaille sa construction, avec des exemples réels de Notion, GitHub et Sentry, et les endroits où trouver celle qu’il vous faut.
Vous collez un lien dans un client d’IA, vous cliquez sur « Connecter », et rien ne se passe. Ou un écran de configuration vous demande une « URL de serveur MCP » et vous ignorez d’où vient cette adresse. Voici la réponse courte : une URL de serveur MCP est l’adresse web d’un serveur distant du Model Context Protocol. C’est le point de terminaison exact que votre client d’IA appelle pour lister les outils, lire les données et exécuter des actions en votre nom.
Cet article détaille ce que signifie cette adresse, comment elle est construite, quels exemples réels vous pouvez comparer et où trouver celle dont vous avez besoin. Vous verrez aussi les erreurs derrière la plupart des connexions échouées, ainsi qu’une méthode rapide pour vérifier une configuration avant d’incriminer le serveur.
Le Model Context Protocol (MCP) est un standard ouvert qui permet à une application d’IA de communiquer avec des outils externes grâce à un langage unique et prévisible. Trois rôles entrent en jeu : l’hôte (l’application d’IA que vous utilisez), le client qui fonctionne à l’intérieur de cette application, et le serveur qui expose des outils, des ressources et des prompts. Les messages entre le client et le serveur circulent au format JSON-RPC.
Lorsque le serveur se trouve sur internet plutôt que sur votre propre machine, le client doit savoir où envoyer ces messages. Cet emplacement est l’URL de serveur MCP. Imaginez-la comme le numéro de téléphone d’un fournisseur d’outils précis : vous l’appelez, et le serveur répond en listant ce qu’il sait faire.
La spécification officielle appelle cette adresse le point de terminaison MCP (MCP endpoint). Il s’agit d’un seul chemin HTTP, et la spécification exige qu’il prenne en charge à la fois POST et GET. Chaque message de votre client est un nouveau POST vers ce chemin. Facultativement, le client ouvre un GET sur le même chemin pour écouter les messages que le serveur souhaite lui envoyer. Une seule adresse, sans longue liste de routes à mémoriser.
💡 Astuce : Si une page de configuration affiche « server URL », « endpoint URL », « connector URL » ou « remote MCP URL », cela désigne presque toujours cette même adresse unique.
L’URL ne décrit pas les outils. Elle ne contient pas vos identifiants de connexion. Ce n’est qu’une porte d’entrée. Ce que le serveur propose apparaît une fois que le client s’est connecté et le demande. C’est pourquoi deux serveurs aux adresses d’apparence similaire peuvent se comporter très différemment, et pourquoi une URL qui fonctionne ne prouve jamais à elle seule que la configuration est correcte.
Une URL de serveur MCP est une URL web standard. La syntaxe ne réserve aucune surprise. La spécification elle-même utilise cet exemple :
https://example.com/mcp
Décomposez cet exemple en parties : chacune a un rôle.
| Élément | Exemple | Rôle |
|---|---|---|
| Schéma | https:// | Indique au client d’utiliser HTTP chiffré. Les serveurs distants doivent toujours l’utiliser. |
| Hôte | mcp.example.com | Le nom de domaine du serveur. Commence souvent par mcp. ou api.. |
| Port (facultatif) | :8443 | Affiché uniquement lorsque le serveur n’utilise pas le port HTTPS par défaut. |
| Chemin | /mcp | Le point de terminaison unique qui gère le trafic MCP. |
| Requête (facultatif) | ?workspace=123 | Rare, mais certains fournisseurs ajoutent des paramètres, comme un espace de travail. |
Les serveurs de développement local utilisent souvent un simple http://localhost:3000/mcp. C’est acceptable sur votre propre machine. N’exposez jamais une adresse non chiffrée à l’internet public.
La spécification indique seulement que le point de terminaison « pourrait être une URL comme » l’exemple ci-dessus. Le chemin relève d’une convention, non d’une règle. Néanmoins, deux suffixes dominent en pratique :
/mcp pointe généralement vers un serveur Streamable HTTP, le transport standard actuel./sse pointe généralement vers l’ancien transport HTTP+SSE, issu de la version 2024-11-05 du protocole.Considérez le suffixe comme un indice, non comme une garantie. Un fournisseur peut publier son point de terminaison à /v1/mcp ou à la racine d’un sous-domaine. Copiez l’URL exactement telle qu’elle est affichée, y compris une éventuelle barre oblique finale. Le serveur distant de GitHub, par exemple, se termine par /mcp/.
Streamable HTTP a remplacé l’ancien transport HTTP+SSE. Avec cette conception plus récente, le client envoie toujours un POST accompagné d’un en-tête Accept qui liste à la fois application/json et text/event-stream. Le serveur répond soit par un seul objet JSON, soit par un flux d’événements. Un serveur peut aussi renvoyer un en-tête Mcp-Session-Id, que le client répète sur chaque requête suivante. Les clients envoient enfin un en-tête MCP-Protocol-Version afin que les deux parties s’accordent sur la révision de la spécification.
La documentation de Claude Code décrit désormais SSE comme obsolète et recommande les serveurs HTTP partout où ils existent. Beaucoup de fournisseurs maintiennent une adresse /sse active pour les anciens clients, ce qui explique que vous rencontriez encore les deux styles.
💡 Astuce : Un client qui veut rester compatible avec les anciens serveurs accepte une URL saisie par l’utilisateur et tente d’abord un POST. Si le serveur répond par une erreur 4xx, il bascule vers un GET et attend un flux SSE. Ce mécanisme de repli explique pourquoi la même URL collée fonctionne parfois dans une application et échoue dans une autre.
Tous les serveurs MCP n’ont pas d’URL. Cela surprend beaucoup de monde, et explique pourquoi certaines configurations demandent une commande plutôt qu’une adresse.
Avec le transport stdio, le client lance le serveur comme sous-processus sur votre ordinateur. Les messages transitent par l’entrée et la sortie standard. Il n’y a ni saut réseau ni adresse. Vous fournissez une commande et ses arguments, par exemple npx suivi d’un nom de paquet, et c’est tout ce dont le client a besoin. La spécification demande aux clients de prendre en charge stdio chaque fois que c’est possible, et il reste donc la valeur par défaut pour les outils locaux.
Avec Streamable HTTP, le serveur fonctionne comme un processus indépendant et peut traiter plusieurs clients à la fois. C’est dans ce cas que l’URL devient indispensable, car le client doit trouver le serveur sur le réseau.
| Transport | A une URL ? | Configuration type | Statut |
|---|---|---|---|
| stdio | Non | command et args dans un fichier de configuration | Standard, les clients doivent le prendre en charge |
| Streamable HTTP | Oui, un seul point de terminaison | Coller https://…/mcp | Transport distant standard |
| HTTP+SSE | Oui, souvent /sse | Coller https://…/sse | Obsolète, conservé pour les anciens clients |
Utilisez la deuxième colonne comme règle de décision. Si votre fournisseur vous donne une ligne de commande, vous êtes en stdio. S’il vous donne un lien, vous êtes sur un transport distant.
Lorsqu’un serveur fonctionne sur votre propre machine en HTTP, la spécification indique qu’il doit se lier à 127.0.0.1 plutôt qu’à 0.0.0.0, et qu’il doit valider l’en-tête Origin pour bloquer les attaques de DNS rebinding. En clair : un serveur MCP local sur localhost ne doit jamais être accessible depuis d’autres appareils de votre réseau, sauf si vous le souhaitez expressément.
Les adresses ci-dessous proviennent de pages de documentation officielles et de listes publiques. Les fournisseurs modifient leurs points de terminaison : considérez ce tableau comme une référence de schémas, et vérifiez chaque URL dans la documentation actuelle du fournisseur avant de vous y fier.
| Fournisseur | Exemple d’URL | Style |
|---|---|---|
| Exemple de la spécification | https://example.com/mcp | Streamable HTTP |
| Notion | https://mcp.notion.com/mcp | Streamable HTTP |
| GitHub | https://api.githubcopilot.com/mcp/ | Streamable HTTP |
| Sentry | https://mcp.sentry.dev/mcp | Streamable HTTP |
| Supabase | https://mcp.supabase.com/mcp | Streamable HTTP |
| PostHog | https://mcp.posthog.com/mcp | Streamable HTTP |
| Asana | https://mcp.asana.com/sse | SSE hérité |
| Serveur de test local | http://localhost:3000/mcp | Streamable HTTP sur votre propre machine |
mcp. dédié : mcp.notion.com, mcp.sentry.dev, mcp.supabase.com.api.githubcopilot.com.Authorization.La documentation de Claude Code présente ces formes exactes pour Notion et Asana :
claude mcp add --transport http notion https://mcp.notion.com/mcp
claude mcp add --transport sse asana https://mcp.asana.com/sse
La seule différence réside dans la valeur --transport et dans le chemin. Tout le reste, y compris le nom que vous choisissez, reste à votre discrétion.
Comme l’URL appartient au propriétaire du serveur, la source la plus fiable reste toujours ce propriétaire. Cet ordre vous fait gagner le plus de temps.
Recherchez dans la documentation du fournisseur « MCP », « remote MCP » ou « connectors ». Les portails développeurs ont généralement une page dédiée, souvent avec un bouton de copie à côté de l’adresse. Cette page indique explicitement le suffixe /mcp ou /sse, vous n’avez donc pas à deviner.
Certains produits affichent l’adresse dans votre compte. Une page de paramètres pour les intégrations, les connexions ou les outils développeur peut la faire figurer avec les étapes de configuration pour chaque client. Si la page demande une connexion, c’est normal : beaucoup de fournisseurs lient la connexion à votre compte.
Les serveurs open source se décrivent dans un fichier README. Cherchez une section intitulée « Usage », « Installation » ou « Configuration ». Si le README ne montre que command et args, le serveur fonctionne uniquement en stdio et n’a pas d’URL publique tant que quelqu’un ne le déploie pas.
Des annuaires publics comme MCPservers.org tiennent à jour des listes de serveurs MCP distants et de leurs points de terminaison. Utilisez-les pour trouver des candidats, puis confirmez l’adresse dans la documentation du fournisseur. Les entrées des annuaires peuvent devenir obsolètes.
Si un collègue a déjà connecté le serveur, demandez-lui d’exécuter claude mcp list ou claude mcp get <name> dans Claude Code. Ces deux commandes affichent la configuration d’un serveur, ce qui permet de repérer l’adresse. Dans une session en cours, la commande /mcp affiche l’état de chaque serveur.
Une fois la bonne adresse en main, la configuration prend moins d’une minute. Trois méthodes conviennent à presque tous les clients.
Claude Code demande un transport, un nom et l’URL :
claude mcp add --transport http <name> <url>
Pour envoyer un jeton avec chaque requête, ajoutez un en-tête :
claude mcp add --transport http secure-api https://api.example.com/mcp \
--header "Authorization: Bearer your-token"
La plupart des clients lisent aussi un fichier JSON. Les noms de champs varient d’une application à l’autre, vérifiez donc la documentation de votre client, mais la structure ressemble à ceci :
{
"mcpServers": {
"notion": {
"type": "http",
"url": "https://mcp.notion.com/mcp"
},
"local-files": {
"command": "npx",
"args": ["-y", "example-mcp-package"]
}
}
}
La première entrée est distante et utilise url. La seconde est en stdio et utilise command. Gardez un seul style par entrée.
Les applications de chat dotées d’un écran de connecteur personnalisé demandent généralement deux informations : un nom et l’URL. Collez l’adresse, enregistrez, puis terminez l’invite de connexion si elle apparaît. Rien d’autre n’est nécessaire, car l’application trouve les outils toute seule une fois la connexion ouverte.
La plupart des connexions échouées découlent d’une courte liste de causes. Vérifiez-les dans cet ordre avant de toucher à quoi que ce soit d’autre.
Un simple nom d’hôte, comme https://mcp.example.com, ne suffit souvent pas. Le client a besoin du chemin exact du point de terminaison. Si vous obtenez une erreur 404, recopiez l’adresse depuis la documentation actuelle du fournisseur et comparez-la caractère par caractère, y compris la barre oblique finale.
Une URL de base d’API REST classique n’est pas une URL MCP. Une base comme https://api.example.com/v1 sert des requêtes ordinaires et ne parle pas JSON-RPC sur le transport MCP. Si un fournisseur propose les deux, la documentation les présente sur des pages séparées. Ne collez jamais une base d’API dans un champ intitulé « URL de serveur MCP » en espérant voir apparaître des outils.
Une URL correcte échoue quand même sans l’autorisation d’y accéder. Les serveurs répondent par 401 lorsque votre jeton est absent ou expiré, et par 403 lorsque votre compte ne peut pas accéder à cet espace de travail. Reconnectez-vous via le client, ou renouvelez le jeton Bearer que vous transmettez dans l’en-tête Authorization.
💡 Astuce : Gardez les jetons hors de l’URL. Si un fournisseur vous demande de coller un secret dans une chaîne de requête, traitez ce lien comme un mot de passe et ne le partagez jamais dans des captures d’écran ou des tickets.
| Symptôme | Cause probable | Solution |
|---|---|---|
| 404 Introuvable | Mauvais chemin, ou le fournisseur a déplacé le point de terminaison | Recopiez l’URL depuis la documentation actuelle |
| 405 Méthode non autorisée | POST envoyé à une adresse SSE uniquement, ou GET envoyé à une adresse POST uniquement | Essayez l’adresse /mcp ou passez le transport sur sse |
| 401 Non autorisé | Jeton absent ou expiré, OAuth non terminé | Reconnectez-vous ou renouvelez le jeton Bearer |
| 403 Interdit | Le compte n’a pas accès à ce serveur ou à cet espace de travail | Vérifiez le forfait, l’espace de travail et les autorisations |
| Connexion refusée | Serveur local non démarré, ou mauvais port | Démarrez le serveur et vérifiez le port |
| Erreur de certificat | Certificat HTTPS auto-signé ou non concordant | Utilisez un certificat valide |
| Fonctionne dans une seule application | Prise en charge du transport différente | Faites correspondre le transport (http ou sse) au client |
Une nuance évite beaucoup de confusion : la spécification permet à un serveur de répondre à un GET par 405 pour indiquer qu’il ne propose pas de flux SSE à ce point de terminaison. Un 405 sur un GET seul n’est donc pas toujours une faute.
PicassoIA publie une API pour développeurs à https://api.picassoia.com/v1. Elle utilise des points de terminaison de style Replicate, comme POST /v1/models/{owner}/{name}/predictions et GET /v1/predictions/{id}, et s’authentifie avec un jeton Bearer qui commence par pia_sk_. Cette adresse appartient à l’API REST. Ce n’est pas une URL de serveur MCP : ne la collez donc pas dans un champ MCP.
Les connexions MCP se gèrent depuis votre compte à picassoia.com/en/mcp/accounts, ce qui nécessite une connexion. L’URL du serveur MCP n’est pas affichée sur les pages publiques : commencez donc par là plutôt que de deviner une adresse. Les règles du forfait s’appliquent, consultez donc la page tarifs pour savoir ce qu’inclut votre forfait.
Quatre modèles sont disponibles à la fois via l’API et via MCP :
Les tâches s’exécutent de façon asynchrone : vous créez une prédiction, vous l’interrogez, puis vous récupérez le résultat. La limite est de 5 prédictions simultanées par compte, partagées entre les jetons et les connexions MCP, avec des prompts allant jusqu’à 4 000 caractères.
Le modèle Claude Sonnet 5 gère les tâches de code et d’utilisation d’outils, ce qui en fait un second regard utile sur un fichier de configuration. Voici une courte procédure sur PicassoIA :
💡 Astuce : Considérez la réponse comme une piste, non comme un verdict. La documentation du fournisseur prévaut toujours lorsque les deux divergent.
GPT 5.6 Sol fonctionne de la même façon si vous préférez un second avis.
Un serveur connecté n’est utile que si vous avez quelque chose à construire avec lui. Ouvrez PicassoIA, choisissez PicassoIA Image ou Seedance 2.5 Lite, rédigez un prompt décrivant la scène que vous imaginez, et générez votre premier résultat en quelques minutes. Essayez une photo pour votre prochain article, une image de produit ou un court clip, puis affinez la formulation et relancez. La plateforme récompense l’expérimentation : lancez donc votre premier prompt dès aujourd’hui et voyez ce que vos propres mots peuvent produire.
Choisissez votre langue
