> ## Documentation Index
> Fetch the complete documentation index at: https://storekit.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Dépannage de ton agent IA

> Résous les problèmes courants de connexion de Claude, ChatGPT ou d'un client MCP à storekit : échecs de connexion, non autorisé, mauvais magasin et timeouts.

Parcours la section qui correspond à ce que tu vois. Si aucune ne convient, écris à [mcp@storekit.com](mailto: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

> **La page de connexion dit 'This connection link is invalid or has expired'**
>
> Le lien de connexion ouvert par ton assistant a déjà été utilisé ou a mis trop de temps. Retourne dans l'assistant et redémarre la connexion ; ne recharge pas l'onglet storekit.

> **La page de connexion dit 'Couldn't complete the connection'**
>
> 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](https://t09czsyu90l.typeform.com/to/G6rIJWNv), ou écris à [mcp@storekit.com](mailto:mcp@storekit.com) en indiquant l'email avec lequel tu t'es connecté.

> **Mon client dit 401 ou Unauthorised**
>
> * Ta connexion a expiré ou a été effacée. Utilise l'option de reconnexion de l'assistant (voir ton [guide de connexion](/docs/fr/guides/ai/overview#connecter-ton-assistant)).
> * 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.

> **Mon client ne peut pas ajouter le serveur ou dit qu'il ne prend pas en charge ce transport**
>
> 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](/docs/fr/guides/ai/connect/other-clients) pour les options.

## Les réponses ont l'air fausses

> **Il fait des rapports sur le mauvais magasin, ou sur tous les magasins**
>
> 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.

> **Les totaux sont environ cent fois trop grands**
>
> 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.

> **Les chiffres d'hier ne correspondent pas au dashboard**
>
> 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](/docs/fr/guides/reports/overview) décrivent comment le dashboard compte, afin que tu puisses aligner les deux.

> **Il dit que la période est trop longue**
>
> Une question peut couvrir au plus 90 jours. Demande en deux parties, ou demande une répartition mensuelle.

> **Il dit que le total est une estimation, ou le décompte a changé entre les pages**
>
> 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.

> **Un rapport de snooze dit que les événements ont été tronqués**
>
> 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 top produits affichent un prix qui n'est pas celui auquel on a vendu**
>
> 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

> **Il a atteint le timeout**
>
> 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éé.

> **Trop de requêtes**
>
> 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.

> **L'assistant a créé quelque chose deux fois**
>
> 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](mailto:mcp@storekit.com)**
>
> Indique-nous l'assistant, la question et l'heure.

> **[Référence du MCP marchand](/docs/fr/developers/mcp/overview)**
>
> Pour les développeurs : le protocole, les outils et les codes d'erreur.


## Related topics

- [Connecter ton agent IA](/docs/fr/guides/ai/overview.md)
- [Vue d'ensemble des intégrations](/docs/fr/guides/integrations/overview.md)
- [Introduction pour les développeurs](/docs/fr/developers/introduction.md)
- [Aperçu du MCP marchand](/docs/fr/developers/mcp/overview.md)
- [API et webhooks](/docs/fr/guides/integrations/api-webhooks.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.