Ce guide vous mène de l'absence de clé à une connexion Provedly opérationnelle dans Claude Code. Il suppose que vous avez déjà un compte Provedly avec au moins un site, et Claude Code installé dans un terminal. Le tout tient en une clé, une commande et un prompt de test.
Si vous n'avez pas encore lu la présentation, l'article de lancement explique ce que le serveur MCP peut et ne peut pas faire.
Étape 1 : créer une clé d'API de compte
Dans le tableau de bord Provedly, ouvrez Settings puis API keys. Choisissez Create key, donnez-lui un nom que vous reconnaîtrez plus tard, comme « Claude Code sur mon portable », et choisissez un niveau d'accès.
- Read only permet à Claude de consulter votre compte, vos sites, widgets, barres et statistiques.
- Read and write lui permet en plus de mettre en pause et de réactiver des widgets, de créer et modifier des barres, et d'ajouter des enregistrements.
Si c'est votre premier essai, commencez par Read only. Vous pourrez toujours créer une seconde clé plus tard. La clé commence par provedly_ et n'est affichée qu'une fois : copiez-la avant de fermer la fenêtre. Si vous la perdez, révoquez-la et créez-en une nouvelle ; il est impossible de l'afficher à nouveau.
Étape 2 : ajouter le serveur
Dans un terminal, lancez :
claude mcp add --transport http provedly https://provedly.app/mcp \
--header "Authorization: Bearer provedly_YOUR_KEY"
Remplacez provedly_YOUR_KEY par la clé que vous venez de copier. Les éléments de la commande :
| Élément | Ce qu'il fait |
|---|---|
--transport http |
Le serveur de Provedly utilise le streamable HTTP |
provedly |
Le nom que Claude Code affichera pour ce serveur |
https://provedly.app/mcp |
L'adresse du serveur |
--header "..." |
Envoie votre clé avec chaque requête |
Claude Code enregistre cela dans sa configuration MCP. Traitez cette configuration comme un fichier .env : elle contient désormais un secret. Si vous ajoutez le serveur au niveau du projet et commitez la configuration, la clé part avec elle : pour un dépôt partagé, gardez-la au niveau utilisateur ou tenez la clé hors du contrôle de version.
Étape 3 : vérifier la connexion
Lancez Claude Code et exécutez /mcp. Vous devriez voir provedly dans la liste avec un statut connecté et les outils Provedly en dessous : get_account, list_sites, list_widgets, list_bars, get_stats, get_install_snippet, et, avec une clé d'écriture, set_widget_status, set_bar_status, create_bar, update_bar et add_record.
Si le serveur affiche une erreur, les causes habituelles sont une faute de frappe dans la clé, un préfixe Bearer manquant dans l'en-tête, ou une clé révoquée. Les clés révoquées échouent immédiatement, ce qui est le comportement souhaité.
Étape 4 : un premier prompt
Demandez quelque chose qui ne nécessite qu'un accès en lecture et dont vous pouvez vérifier la réponse dans le tableau de bord :
Quel est mon plan, et quelle part des impressions de ce mois ai-je utilisée ?
Claude doit appeler get_account et répondre avec votre plan, ses limites et la consommation actuelle. Ouvrez le tableau de bord et comparez. Si les chiffres correspondent, la connexion fonctionne.
Un deuxième bon test concerne les statistiques :
Combien de commandes mes widgets ont-ils assistées ces 30 derniers jours ?
Cela appelle get_stats et indique les commandes assistées par la preuve et le chiffre d'affaires de la période. La définition d'une commande assistée est la même que dans le tableau de bord, expliquée dans mesurer les commandes assistées par la preuve.
Étape 5 : essayer une modification, prudemment
Avec une clé en lecture et écriture, essayez quelque chose de facile à annuler :
Mets en pause la barre appelée « Free shipping » et dis-moi ce qui a changé.
Claude va généralement lister vos barres, trouver celle qui correspond, appeler set_bar_status et indiquer le nouvel état. Claude Code vous demande d'approuver les appels d'outils sauf si vous les avez autorisés, et cette étape d'approbation vaut la peine d'être conservée pour tout ce qui écrit. Lisez l'appel d'outil avant de l'approuver : il nomme la barre et l'action.
Réactivez-la de la même manière. Si vous demandez à réactiver quelque chose qui vous ferait dépasser la limite de votre plan, la demande est refusée et Claude vous dira pourquoi, avec le même refus que dans le tableau de bord.
Garder les choses en ordre
Quelques habitudes utiles une fois que cela fait partie de votre routine :
- Une clé par machine ou par outil, clairement nommée, pour qu'en révoquer une ne casse pas les autres.
- Des clés en lecture seule partout où vous ne voulez que des rapports. Plus de détails dans clés en lecture seule ou en écriture.
- Révoquez les clés que vous n'utilisez plus. L'écran des clés d'API les liste toutes.
Si vous demandez à Claude de créer une barre, attendez-vous à ce qu'elle revienne en pause. Les nouvelles barres créées via l'API ou le MCP démarrent toujours ainsi pour que vous puissiez d'abord vérifier le texte et les dates ; demander à Claude de l'activer est la seconde étape.
Quand vous serez prêt à aller plus loin, le recueil de prompts propose des exemples pour chaque outil.
Questions fréquentes
Puis-je utiliser la même clé dans Claude Code et dans un script ?
Oui, une clé fonctionne à la fois pour le serveur MCP et pour l'API REST. Des clés séparées restent plus simples à gérer, car vous pouvez en révoquer une sans toucher à l'autre.
Que se passe-t-il si je retire le serveur de Claude Code ?
Claude Code cesse d'appeler Provedly, et rien ne change sur votre compte. La clé reste valide jusqu'à ce que vous la révoquiez dans Settings : révoquez-la si vous n'en avez plus besoin.
Claude voit-il les données personnelles de mes clients ?
Il voit ce que renvoient les outils : les informations du compte, les sites, widgets, barres et statistiques, et, lors de l'ajout d'un enregistrement, l'enregistrement que vous lui demandez d'ajouter. Traitez la session comme tout autre endroit par lequel transitent des données de votre entreprise.
Les comptes et les clés sont gratuits pour démarrer : inscrivez-vous ici.