Claude Code dispose d'une commande d'une ligne pour ajouter des serveurs MCP. La plupart des autres clients utilisent plutôt un écran de réglages ou un fichier JSON. Les informations à saisir sont partout les mêmes : une fois que vous connaissez les trois valeurs dont Provedly a besoin, vous pouvez le connecter à l'outil dans lequel vous travaillez.
Les trois valeurs
Chaque client MCP qui prend en charge les serveurs distants vous demande les mêmes éléments :
- Transport : HTTP. Le serveur de Provedly utilise le streamable HTTP : choisissez l'option HTTP ou « remote », pas stdio.
- URL :
https://provedly.app/mcp - En-tête :
Authorization: Bearer provedly_YOUR_KEY
La clé se crée dans Settings, puis API keys, dans le tableau de bord Provedly. Choisissez Read only ou Read and write à la création. Elle n'est affichée qu'une fois, commence par provedly_ et peut être révoquée quand vous le souhaitez. Si votre client ne peut pas envoyer d'en-tête Authorization personnalisé à un serveur distant, il ne peut pas encore se connecter à Provedly ; l'API REST est alors la solution de repli.
Cursor
Cursor lit les serveurs MCP depuis un fichier mcp.json, soit globalement dans votre répertoire personnel sous .cursor/, soit par projet dans le dossier .cursor/ du projet. Au moment où nous écrivons, un serveur distant avec un en-tête ressemble à ceci :
{
"mcpServers": {
"provedly": {
"url": "https://provedly.app/mcp",
"headers": {
"Authorization": "Bearer provedly_YOUR_KEY"
}
}
}
}
Enregistrez le fichier et ouvrez les réglages MCP de Cursor. L'entrée provedly doit apparaître comme activée, avec ses outils listés. Si vous placez cette configuration dans un fichier de projet, vérifiez si ce dossier est commité dans git. Une clé dans un fichier commité est une clé divulguée, et la solution est de la révoquer dans Provedly et d'en créer une nouvelle.
Les éditeurs modifient souvent leurs écrans de réglages : si la disposition diffère de cette description, cherchez l'option de serveur distant ou HTTP et saisissez la même URL et le même en-tête.
Les autres outils compatibles MCP
Le principe se répète d'un client à l'autre. Cherchez un moyen d'ajouter un serveur distant, HTTP ou « streamable HTTP », donnez-lui un nom, collez l'URL et ajoutez un en-tête. Certains clients ont un champ d'en-tête dans le formulaire ; d'autres acceptent un bloc JSON semblable à celui de Cursor. Quelle que soit la forme, le nom de l'en-tête est Authorization et sa valeur est Bearer suivi de votre clé, avec un seul espace.
Quelques clients ne prennent en charge que les serveurs stdio locaux. Ceux-là ne peuvent pas joindre Provedly directement. Provedly ne publie pas d'adaptateur local : pour ces outils, l'API REST à l'adresse https://provedly.app/api/v1 est la voie d'accès, avec la même clé. La visite guidée avec curl couvre chaque point d'accès.
Vérifier la connexion
Une fois que le client affiche le serveur comme connecté, posez une question dont vous pouvez vérifier la réponse :
Liste mes sites Provedly et les widgets de chacun.
L'assistant doit appeler list_sites et list_widgets et vous donner des noms qui correspondent au tableau de bord. Si vous avez créé une clé en lecture seule, toute tentative de mise en pause, de création ou de modification sera refusée. C'est normal, et demander une modification anodine est un bon moyen de confirmer que la clé fait ce que vous pensez.
Causes d'échec courantes, à peu près par ordre de fréquence :
| Symptôme | Cause habituelle |
|---|---|
| Le serveur affiche une erreur d'authentification | Préfixe Bearer manquant ou faute de frappe dans la clé |
| Fonctionnait hier, échoue aujourd'hui | La clé a été révoquée dans Settings |
| Outils listés, écritures refusées | La clé est Read only |
| Une réactivation est refusée | Cette modification dépasserait la limite de votre plan |
| Le client ne peut pas ajouter le serveur | Il ne prend en charge que les serveurs stdio locaux |
Ce que vous pouvez en faire
Le client change, les outils non. Depuis n'importe quel outil connecté, vous pouvez lire votre compte, vos sites, widgets, barres et statistiques, et avec une clé d'écriture vous pouvez mettre en pause ou réactiver des widgets, créer et modifier des barres, et ajouter des enregistrements. Quelques prompts qui fonctionnent bien pour commencer :
- « Quel widget a eu le plus de clics cette semaine ? »
- « Montre-moi toutes les barres actuellement actives, avec leur date de fin. »
- « Donne-moi le snippet d'installation pour ma boutique. »
Pour une liste plus longue avec ce que fait chacun en coulisses, consultez le recueil de prompts. Si vous êtes dans Claude Code plutôt que dans un éditeur, le guide Claude Code propose la version en une ligne.
Un mot sur les équipes
Si plusieurs personnes d'une équipe connectent leur éditeur, donnez à chacune sa propre clé. L'écran des clés d'API liste chaque clé avec son nom et son niveau d'accès : quand quelqu'un part, vous révoquez sa clé sans affecter personne d'autre. Partager une seule clé dans une équipe rend cela impossible sans couper l'accès à tout le monde d'un coup.
Questions fréquentes
Le serveur MCP de Provedly fonctionne-t-il dans claude.ai ou ChatGPT ?
La configuration prise en charge est Claude Code, Cursor et les autres outils compatibles MCP capables de se connecter à un serveur HTTP distant avec un en-tête Authorization. Nous n'annonçons pas la prise en charge d'autres produits tant qu'elle n'a pas été développée et testée.
Faut-il utiliser une configuration globale ou au niveau du projet dans Cursor ?
La configuration globale est plus simple et garde la clé hors des dépôts. N'utilisez le niveau projet que si vous avez besoin de clés différentes par projet et que le dossier n'est pas commité.
Puis-je connecter deux comptes Provedly ?
Oui. Ajoutez deux serveurs avec des noms différents, chacun avec une clé de son propre compte. L'assistant verra les deux jeux d'outils et vous pourrez préciser de quel compte vous parlez.
Vous pouvez créer une clé sur n'importe quel plan, Free compris : commencez ici.