Skip to main content
Parcours la section qui correspond à ce que tu vois. Si aucune ne convient, écris à mcp@storekit.com en indiquant le nom de ton assistant, la question posée et l’heure de la question : chaque requête porte un ID que nous pouvons retrouver.

Connexion

storekit n’a pas pu terminer le hand-off vers ton assistant. Réessaie une fois depuis l’assistant. Si ça échoue une deuxième fois, ton compte n’est probablement pas encore activé pour la beta : demande l’accès, ou écris à mcp@storekit.com en indiquant l’email avec lequel tu t’es connecté.
  • Ta connexion a expiré ou a été effacée. Utilise l’option de reconnexion de l’assistant (voir ton guide de connexion).
  • Certains clients demandent d’activer le connector à l’intérieur du chat en plus de l’ajouter. Vérifie le menu d’outils du chat.
storekit utilise MCP Streamable HTTP. Un client qui ne prend en charge que stdio ou SSE ne peut pas se connecter directement ; voir Connecter d’autres clients pour les options.

Les réponses ont l’air fausses

Nomme le magasin dans ta question. Sans cela, les listes de commandes couvrent tout le compte et les totaux sont sommés sur l’ensemble. Si le compte a des magasins dans des devises différentes, les totaux à l’échelle du compte sont refusés et l’assistant te demande d’en choisir un.
storekit renvoie l’argent en unités mineures (pence, cents) et l’assistant a affiché le nombre brut. Dis-lui « les montants sont en pence, affiche-les en pounds ». C’est un glissement de présentation de l’assistant, pas une erreur de données ; la devise est incluse avec chaque chiffre.
Vérifie trois choses :
  1. Quelle horloge. Un seul magasin est rapporté dans son heure locale. Les questions à l’échelle du compte utilisent UTC sauf si tu nommes un fuseau horaire.
  2. Quelle date. Les commandes sont listées par leur heure due (leur créneau), pas par leur heure de passage, sauf si tu demandes « placed » ou « created ». Les stats de ventes et les top produits utilisent toujours l’heure de passage. Les remboursements utilisent la date de remboursement sauf si tu demandes par date de commande.
  3. Quelles commandes. Les totaux excluent les commandes rejetées et annulées et sont bruts de remboursements.
Les pages Rapports décrivent comment le dashboard compte, afin que tu puisses aligner les deux.
Une question peut couvrir au plus 90 jours. Demande en deux parties, ou demande une répartition mensuelle.
Les grandes listes de commandes rapportent un total estimé pour aller plus vite ; les pages individuelles sont exactes. Les listes de commandes sont aussi live, si bien qu’une commande qui arrive pendant que l’assistant pagine peut décaler les résultats. Redemande avec une période plus étroite si tu as besoin d’un décompte ferme.
Les événements par article sont plafonnés à 100 dans une réponse. Le résumé et les totaux restent complets ; seuls les événements individuels on/off sont coupés. Demande une période plus courte pour tous les voir.
Les prix dans la réponse top-produits sont les prix actuels du menu, à titre de référence. Les quantités sont historiques ; les prix, non.

Requêtes lentes ou en échec

Chaque requête dispose de 30 secondes. De longues périodes sur des magasins chargés peuvent dépasser cela : demande une période plus courte ou un magasin à la fois. Si une écriture a atteint le timeout, vérifie le dashboard avant de redemander : le code de réduction ou le lien de paiement a peut-être déjà été créé.
Les requêtes sont limitées par utilisateur. Attends une minute et réessaie. Si une configuration automatisée atteint cette limite régulièrement, espace ses appels.
Cela se produit quand l’assistant réessaie une écriture après un timeout ou une connexion coupée. Désactive le code de réduction ou le lien de paiement en double dans le dashboard, et garde les approbations d’écriture réglées sur « par appel » plutôt que « toujours autoriser ».

Toujours bloqué

Écris à mcp@storekit.com

Indique-nous l’assistant, la question et l’heure.

Référence du MCP marchand

Pour les développeurs : le protocole, les outils et les codes d’erreur.