Outil MCP absent ou refusé
Un outil que votre client IA ne voit pas, ou une connexion MCP refusée, et les trois portes qu’un outil doit franchir.
Le serveur MCP de BoostEcom n’affiche pas un outil pour le refuser ensuite : un outil qui ne passe pas ses conditions n’est pas enregistré, et votre client ne le voit pas du tout.
Les trois portes
Un outil doit toutes les franchir pour apparaître dans votre client :
- Le scope BoostEcom approuvé : ce à quoi vous avez consenti sur l’écran d’autorisation.
- Les droits Shopify de la boutique : si l’installation n’a jamais obtenu
read_orders, aucun scope BoostEcom ne fera apparaîtrelistOrders. - Un appelant identifié, pour les outils native seulement.
Diagnostiquer
| Symptôme | Cause probable | Que faire |
|---|---|---|
| Seuls les outils relay apparaissent | Le client se connecte avec une clé statique bst_mcp_, qui n’ouvre que la famille relay | Connecter le client en OAuth et approuver les scopes voulus |
| Un outil relay manque | La boutique n’a pas le droit Shopify qu’il exige | Accorder le droit dans l’installation ou la Custom App, puis reconnecter |
searchDocs et getDoc manquent | Le scope boostecom:docs.read n’a pas été approuvé, ou le client utilise une clé statique | Reconnecter en OAuth en approuvant ce scope |
Le serveur répond 401 | Aucun identifiant, ou un identifiant non reconnu | Vérifier l’URL et l’identifiant dans la configuration du client |
Le serveur répond 429 | Limite d’appels atteinte | Ralentir avec un backoff exponentiel ; les limites dépendent du plan |
Le tableau complet des scopes, de leurs outils et des droits Shopify exigés est dans Outils MCP et scopes. Les modes d’authentification sont dans Serveur MCP.
Was this page helpful?