Avant de commencer
Le connecteur est réservé aux plans Pro, Scale et Enterprise, comme l'API abonné. Si votre compte est sur Starter ou en essai, l'écran d'autorisation vous proposera de changer de plan avant de continuer.
Côté Claude, les connecteurs personnalisés s'ajoutent depuis claude.ai, Claude Desktop ou l'application mobile, qui partagent la même liste. Claude Code s'installe à part, par une commande.
- Un compte Sweeprice actif, plan Pro ou supérieur
- Un compte Claude (le même pour claude.ai, Desktop et mobile)
- Pour Claude Code : Claude Code installé sur votre machine
Depuis claude.ai, Claude Desktop ou l'application mobile
Ouvrez Réglages, puis Connecteurs, et choisissez « Ajouter un connecteur personnalisé ». Donnez-lui le nom Sweeprice et collez l'adresse du serveur, sans rien d'autre.
Validez, puis cliquez sur Connecter : Claude ouvre la page d'autorisation Sweeprice dans votre navigateur. Une fois autorisé, le connecteur apparaît dans la liste et ses outils sont disponibles dans chaque nouvelle conversation, sur les trois applications.
https://mcp.sweeprice.com/mcpDepuis Claude Code
Dans votre terminal, ajoutez le serveur avec la commande ci-dessous. Elle enregistre le connecteur pour votre utilisateur ; ajoutez --scope project pour le partager avec un dépôt.
Lancez ensuite Claude Code, tapez /mcp, sélectionnez sweeprice puis Authenticate. Votre navigateur ouvre la page d'autorisation Sweeprice. Après votre accord, il revient vers une adresse locale de votre machine (localhost) pour remettre le code à Claude Code : c'est normal, et l'écran Sweeprice vous le signale.
claude mcp add --transport http sweeprice https://mcp.sweeprice.com/mcpL'écran d'autorisation
La page affiche qui demande l'accès (l'adresse de l'application, claude.ai par exemple), le compte Sweeprice concerné et les permissions demandées, en deux groupes : lecture et écriture. Si vous n'êtes pas connecté, vous passez d'abord par la page de connexion et revenez sur l'écran.
Autoriser crée une application connectée et renvoie un code à Claude ; Refuser renvoie Claude sans rien créer. La demande expire au bout de dix minutes : passé ce délai, relancez la connexion depuis Claude.
Outils et permissions
Le connecteur déclare douze outils, chacun rattaché à une permission. Claude voit la liste complète et vous annonce une écriture avant de la faire.
- catalog:read : produits suivis et résumé du compte
- prices:read : positions de prix, offres concurrentes, historique sur 90 jours, prix recommandés
- alerts:read : alertes et notifications
- catalog:write : ajouter un produit à suivre, par lien ou code-barres
- settings:write : plancher, plafond et mode d'une ligne
- alerts:write : marquer des notifications comme lues
Révoquer l'accès
Dans Sweeprice, ouvrez Réglages, API, puis la carte Applications connectées : chaque autorisation y figure avec son hôte, ses permissions et son dernier usage. Révoquer coupe l'accès à l'instant ; le prochain appel de Claude échoue et vous propose de vous reconnecter.
Vous pouvez aussi retirer le connecteur côté Claude. Dans ce cas, le jeton reste listé dans vos réglages jusqu'à ce que vous le révoquiez ou qu'il expire, sans pouvoir être utilisé par une autre application.
Limites et allocation
Les appels de Claude consomment la même allocation mensuelle que l'API : 10 000 appels sur Pro, 100 000 sur Scale. Un outil appelé vaut un appel ; le compteur est visible dans Réglages, API.
Les listes sont bornées à 100 éléments par appel, l'historique à 90 jours. Un plan devenu insuffisant, une allocation épuisée ou une permission manquante produisent un message lisible par Claude, qui vous l'explique, jamais une déconnexion silencieuse.
Dépannage
Les situations courantes et leur remède.
- Claude dit qu'il n'a pas accès à Sweeprice : le jeton a été révoqué ou a expiré ; relancez la connexion depuis les connecteurs de Claude (ou /mcp dans Claude Code).
- L'écran d'autorisation propose un changement de plan : le compte est sur Starter ou en essai ; passez sur Pro puis reprenez la connexion.
- La demande est expirée : plus de dix minutes se sont écoulées ; relancez la connexion depuis Claude.
- Claude répond qu'un outil est indisponible : l'allocation du mois est épuisée ; elle se réinitialise au mois suivant.
- Claude Code n'ouvre pas le navigateur : copiez l'adresse affichée dans le terminal et ouvrez-la vous-même ; le retour vers localhost fonctionne de la même façon.