En bref
Si un assistant IA ne peut pas lire vos données Dashboardly, les causes possibles sont une connexion OAuth révoquée, une clé API absente ou révoquée, un périmètre de boutiques incorrect, une version sans prise en charge du Model Context Protocol ou une boutique déconnectée côté TikTok. Les vérifications ci-dessous couvrent chaque situation.
Cet article couvre la connexion avec votre compte Dashboardly (OAuth) et les connexions par clé API. Si vous n'avez pas encore connecté d'assistant, commencez par « Connecter les assistants IA à Dashboardly ».
« L'onglet API Keys n'apparaît pas dans les paramètres »
Les clés API MCP sont incluses dans Brand Growing, Pro et Enterprise ainsi que dans tous les plans Agency. Brand Free et Starter n'incluent pas cette fonction. Developer REST est une capacité distincte : l'éligibilité MCP n'accorde pas cet accès.
Que vérifier
- Consultez votre plan dans Settings > Subscriptions.
- Si vous utilisez Brand Free ou Starter, comparez les plans éligibles avant de décider d'une mise à niveau.
- Après un changement de plan, actualisez Settings et vérifiez API Keys.
Si votre plan Brand ou Agency éligible n'affiche toujours pas l'onglet, déconnectez-vous puis reconnectez-vous pour actualiser la session. Si le problème persiste, contactez l'assistance.
Le message « Failed to load API keys » apparaît
Votre navigateur a atteint Dashboardly, mais n'a pas pu charger la liste des clés.
Que vérifier
- Actualisez la page. Une panne réseau temporaire ou un déploiement récent peut provoquer l'erreur ; une actualisation peut la résoudre.
- Déconnectez-vous puis reconnectez-vous. Votre session a peut-être expiré. Ouvrez ensuite à nouveau Settings > API Keys.
- Vérifiez la connexion TikTok Shop. Certains types de comptes nécessitent une boutique active. Dans Settings > Shops, vérifiez qu'au moins une boutique indique « Active » ou « Connected ».
- Essayez un autre navigateur ou une fenêtre privée. Des extensions peuvent perturber les requêtes sécurisées.
Si l'erreur persiste dans deux navigateurs après reconnexion, envoyez le message et une capture à l'assistance. Retirez auparavant clés API, en-têtes d'autorisation, cookies, jetons et données clients des captures ou extraits de console.
« Mon assistant IA n'arrive pas à se connecter à Dashboardly »
Les causes les plus fréquentes sont :
L'URL du point de terminaison est incorrecte
Utilisez le point de terminaison du bon type de connexion : MCP n'est pas l'API Developer REST. ChatGPT et Claude Desktop utilisent la connexion au compte Dashboardly (OAuth), sans clé API secrète. Claude Code et Cursor peuvent utiliser le point de terminaison MCP HTTP distant avec une clé Bearer.
Que vérifier
Consultez les instructions publiques ; inutile de créer une clé temporaire pour trouver l'URL. Pour MCP, utilisez https://mcp.dashboardly.io/mcp, avec /mcp. Developer REST utilise https://api.dashboardly.io/api/developer/v1 depuis votre serveur, pas depuis un navigateur ou une application mobile. N'intervertissez pas ces points de terminaison.
Votre version de l'assistant ne prend pas en charge MCP
Vérifiez que l'assistant prend en charge la connexion MCP souhaitée et que votre compte ou espace de travail l'autorise. Mettre l'application à jour n'active pas à lui seul une intégration désactivée.
Que vérifier
Mettez votre assistant IA à jour :
- Claude Desktop : Vérifiez les mises à jour et suivez les instructions OAuth de Dashboardly.
- Claude sur le web : Consultez les intégrations actuellement disponibles pour votre compte ou espace de travail.
- ChatGPT : Les connexions personnalisées dépendent des paramètres du compte et de l'espace de travail ; voir les instructions officielles.
- Cursor : Mettez l'application à jour et suivez les instructions MCP.
Après la mise à jour, redémarrez l'application et réessayez la connexion.
« Authentication failed » ou « Invalid API key »
L'assistant atteint Dashboardly, mais la clé est refusée.
Que vérifier
- Vérifiez que la clé est active. Une clé révoquée dans Settings > API Keys n'est pas réutilisable ; créez une remplaçante si nécessaire.
- Vérifiez l'expiration. Une clé expirée ne peut pas s'authentifier ; remplacez-la si nécessaire.
- Retirez les espaces accidentels. Aucun espace ou saut de ligne ne doit entourer la clé.
- Copiez le secret complet. Il commence par
dk_live_. Dashboardly ne l'affiche qu'à la création ou à la rotation. Si vous l'avez perdu, utilisez l'action de rotation disponible ou créez une remplaçante, puis actualisez l'assistant. - Vérifiez le compte. La clé doit appartenir au compte Dashboardly dont vous voulez lire les données.
Si une nouvelle clé est refusée immédiatement, vérifiez point de terminaison, authentification, expiration et compte. Contactez l'assistance si cela continue ; ne multipliez pas les clés uniquement pour diagnostiquer le problème.
« L'assistant ne renvoie pas de données » ou « Je ne trouve aucune commande »
La connexion fonctionne, mais l'assistant ne trouve pas de données correspondant à votre question.
Que vérifier
- Vérifiez la boutique et le type d'accès. Consultez Shop dans API Keys et remplacez une clé mal limitée par une clé pour la boutique voulue. Seuls les propriétaires/administrateurs éligibles peuvent choisir All shops pour MCP. Les clés Collaborator et Developer REST sont limitées à une boutique. Les nouvelles clés MCP utilisent Reporting & reconciliation par défaut, sans contacts, adresses ni suivi des acheteurs. Full orders & fulfilment exige un choix explicite d'un propriétaire/administrateur éligible.
- Vérifiez la période. Une boutique peu active peut n'avoir aucune commande la semaine passée ; essayez ce mois ou cette année.
- Vérifiez la même période dans Dashboardly. Si la métrique y manque aussi, examinez connexion et état d'import ; voir « Pourquoi mes données sont-elles retardées ? ».
- Vérifiez l'activité pertinente. Les métriques publicitaires ou de diffusion en direct nécessitent les données correspondantes. Sans publicité, un ROAS nul ou absent n'implique pas une erreur de connexion.
« L'assistant ne voit qu'une boutique alors que j'en ai plusieurs »
La solution dépend de l'utilisation du compte Dashboardly ou d'une clé API.
Que vérifier
Pour une connexion OAuth ChatGPT ou Claude Desktop :
- Ouvrez Settings > API Keys et cherchez l'assistant dans Connected Apps.
- Si Current shop only apparaît, reconnectez uniquement pour changer de périmètre. Révoquer supprime l'accès actuel.
- Sur le nouvel écran de consentement, choisissez Selected shops only pour certaines boutiques, ou All shops I can access seulement si vous voulez autoriser toutes les boutiques accessibles.
Une connexion peut alors utiliser les boutiques autorisées. Dashboardly retire automatiquement les boutiques déconnectées ou auxquelles vous n'avez plus accès. Les connexions OAuth antérieures à la sélection multiboutique gardent leur périmètre initial d'une boutique jusqu'à leur révocation et reconnexion.
Pour une clé API MCP, les options dépendent du rôle de votre compte :
- Une clé par boutique. Utilisez des noms comme « Claude Code — US Shop » ou « Claude Code — UK Shop » et choisissez la clé voulue dans l'assistant.
- Une clé MCP pour toutes les boutiques. Les propriétaires/administrateurs éligibles peuvent choisir explicitement All shops dans Shop pour des questions transversales. Les clés Collaborator restent limitées à une boutique ; Developer REST exige aussi une boutique sélectionnée. Une clé MCP multiboutique n'accorde ni Developer REST ni permissions d'écriture facultatives.
Le rattachement à une boutique ne peut pas être modifié après création. Pour changer de boutique, révoquez la clé et créez-en une nouvelle.
« Certaines réponses prennent beaucoup de temps »
Le délai dépend de l'assistant, du réseau, de la période et de la complexité de la requête. Aucun délai n'est garanti pour toutes les questions. Exemples pouvant être plus longs :
- Profits et pertes sur une longue période. Un détail annuel peut demander davantage de traitement.
- Meilleurs produits de plusieurs boutiques. Comparer les boutiques ajoute du travail.
- Valeur client sur la durée. L'analyse des achats répétés peut demander plus de données.
Si des questions simples dépassent régulièrement 30 secondes, indiquez à l'assistance l'heure de la requête lente pour permettre l'examen des journaux.
« J'ai révoqué une clé par erreur »
Les clés révoquées ne sont pas restaurables. Il n'existe pas d'annulation car Dashboardly invalide définitivement le secret.
Que vérifier
- Dans Settings > API Keys, cliquez sur New API key.
- Choisissez boutique, expiration et accès autorisé. Les nouvelles clés MCP commencent avec l'accès aux rapports ; ne supposez pas qu'une remplaçante hérite des permissions facultatives.
- Copiez le nouveau secret lorsqu'il apparaît et actualisez l'assistant.
La remplaçante possède son propre secret et historique d'utilisation. Vérifiez boutique et permissions avant usage : un même nom ne rend pas son accès identique à celui de la clé révoquée.
« Une connexion inconnue apparaît dans Connected Apps »
Connected Apps, en bas d'API Keys, liste les assistants qui se sont connectés avec votre compte Dashboardly. Si vous ne reconnaissez pas une connexion :
Que vérifier
- Cliquez sur Revoke à côté de la connexion. Ses jetons d'accès et de renouvellement sont immédiatement invalidés, empêchant leur utilisation future.
- Changez votre mot de passe Dashboardly si vous soupçonnez une compromission du compte.
Si vous reconnaissez l'assistant mais souhaitez un autre périmètre de boutiques, révoquez la connexion et reconnectez depuis l'assistant.
Quand contacter l'assistance
Contactez l'assistance si :
- Vous avez suivi les étapes sans réussir à vous connecter.
- Une clé présente une utilisation inconnue.
- API Keys se comporte autrement que décrit, par exemple une clé révoquée semble encore fonctionner.
- Un plan Brand ou Agency éligible n'affiche pas API Keys après reconnexion.
Indiquez nom de la clé, nom de l'assistant, erreur exacte et capture pertinente, pas le secret. Masquez jetons, en-têtes d'autorisation, cookies et données clients. Pour une requête lente, indiquez l'heure.
Ne partagez jamais la clé API complète dans un message à l'assistance. Traitez-la comme un mot de passe.