Avant la connexion
- Le tenant marchand doit avoir un abonnement Diamond actif.
- Connectez-vous comme propriétaire ou administrateur. Un agent Workstation ne peut pas autoriser une nouvelle connexion IA.
- Choisissez une boutique ou toutes les boutiques, puis un accès en lecture seule ou opérationnel.
Connecter Claude simplement
- Ouvrez les paramètres de Claude, puis Connectors, et ajoutez un connecteur personnalisé.
- Nommez-le COD Scale et saisissez exactement : https://app.codscale.io/mcp
- Cliquez sur Connect. COD Scale s’ouvre dans le navigateur. Connectez-vous, ou continuez si votre session est déjà ouverte.
- Vérifiez le client, sélectionnez une boutique ou toutes les boutiques du tenant, puis Lecture seule ou Opérer avec confirmation.
- Autorisez la connexion et revenez dans Claude.
Le bon premier parcours
Demandez d’abord à Claude de lister les boutiques. Sélectionnez ensuite une boutique et demandez son résumé de workspace avant toute opération sur les commandes, produits, OMS, checkout, tracking, finance ou adaptateurs.
- Exemple : « Liste mes boutiques et indique les intégrations qui demandent une action. »
- Exemple : « Ouvre le workspace de Boutique A et résume les commandes du jour, les risques de livraison et le cash COD. »
- Exemple : « Prévisualise la correction du checkout sans rien appliquer avant mon accord. »
Autorisations et sécurité
- OAuth 2.1 avec PKCE gère la connexion dans le navigateur. Le mot de passe COD Scale et les secrets fournisseurs ne sont jamais transmis à Claude.
- Une connexion limitée à une boutique ne peut pas lire ou modifier une autre boutique du tenant.
- La lecture seule masque les outils d’écriture. Les changements destructifs exigent toujours une prévisualisation et une confirmation.
- Chaque appel est limité, isolé par tenant et boutique, audité et expurgé des secrets.
- Le connecteur privé des opérations COD Scale est séparé du connecteur marchand.
Gérer ou révoquer
Dans COD Scale, ouvrez Paramètres > Connexions IA. Vous pouvez voir la portée, le dernier usage et l’expiration, puis révoquer la connexion immédiatement.
Dépannage
- Diamond requis : vérifiez que l’abonnement actif est lié au tenant utilisé pour la connexion.
- Aucune boutique : connectez d’abord une boutique ou autorisez la boutique voulue.
- Outil absent : vérifiez le mode lecture seule, la boutique autorisée, le plan et les capacités de l’adaptateur.
- Autorisation expirée : reconnectez la même URL. Le renouvellement conserve la portée approuvée.
- Pour supprimer définitivement l’accès, révoquez-le aussi dans Paramètres > Connexions IA.
Questions fréquentes
Dois-je coller une clé API dans Claude ?
Non. Ajoutez https://app.codscale.io/mcp ; COD Scale gère l’authentification et le consentement dans le navigateur.
Claude peut-il accéder à une autre boutique ?
Uniquement si vous autorisez toutes les boutiques. Une autorisation mono-boutique est contrôlée par la passerelle et le moteur commerce.
Claude peut-il appliquer seul une action destructive ?
Non. Une prévisualisation et un jeton de confirmation temporaire sont exigés.
Quel plan inclut cette fonction ?
Le connecteur MCP marchand est inclus dans le plan Diamond.
Les plans qui l'incluent
- Agent IA (MCP) · dès Diamond