Kurz erklärt
Wenn ein KI-Assistent Ihre Dashboardly-Daten nicht lesen kann, sind mögliche Ursachen eine widerrufene OAuth-Verbindung, ein fehlender oder widerrufener API-Schlüssel, der falsche Shop-Bereich, eine Assistentenversion ohne Unterstützung für das Model Context Protocol oder eine auf TikTok-Seite getrennte Shop-Verbindung. Die folgenden Abschnitte helfen bei der jeweiligen Prüfung.
Dieser Artikel behandelt die Anmeldung mit Ihrem Dashboardly-Konto (OAuth) und Verbindungen per API-Schlüssel. Wenn noch keine Verbindung besteht, beginnen Sie mit „KI-Assistenten mit Dashboardly verbinden“.
„In den Einstellungen fehlt der Tab API Keys“
MCP-API-Schlüssel sind in Brand Growing, Pro und Enterprise sowie allen Agency-Plänen enthalten. Brand Free und Starter enthalten diese Funktion nicht. Developer REST ist eine eigene Berechtigung; MCP-Verfügbarkeit gewährt keinen Developer-REST-Zugriff.
Was Sie prüfen sollten
- Prüfen Sie Ihren aktuellen Plan unter Settings > Subscriptions.
- Vergleichen Sie bei Brand Free oder Starter die berechtigten Pläne, bevor Sie über ein Upgrade entscheiden.
- Laden Sie nach einem Planwechsel Settings neu und prüfen Sie API Keys.
Fehlt der Tab trotz eines berechtigten Brand- oder Agency-Plans, melden Sie sich ab und wieder an, um die Sitzung zu aktualisieren. Bleibt er unsichtbar, kontaktieren Sie den Support.
Auf der Seite erscheint „Failed to load API keys“
Ihr Browser hat Dashboardly erreicht, konnte aber die Schlüsselliste nicht laden.
Was Sie prüfen sollten
- Laden Sie die Seite neu. Eine vorübergehende Netzwerkstörung oder ein kürzliches Deployment kann die Ursache sein. Neuladen kann helfen.
- Melden Sie sich ab und wieder an. Ihre Sitzung könnte abgelaufen sein. Öffnen Sie danach erneut Settings > API Keys.
- Prüfen Sie die TikTok-Shop-Verbindung. Manche Kontotypen benötigen einen aktiven Shop. Prüfen Sie unter Settings > Shops, ob mindestens ein Shop „Active“ oder „Connected“ anzeigt.
- Testen Sie einen anderen Browser oder ein privates Fenster. Erweiterungen können sichere Anfragen beeinträchtigen.
Bleibt der Fehler nach erneuter Anmeldung in zwei Browsern bestehen, senden Sie dem Support die Fehlermeldung und einen Screenshot. Entfernen Sie vorher API-Schlüssel, Autorisierungsheader, Cookies, Tokens und Kundendaten aus Bildern oder Konsolenauszügen.
„Mein KI-Assistent kann keine Verbindung zu Dashboardly herstellen“
Häufige Ursachen sind:
Die Endpunkt-URL ist falsch
Verwenden Sie den Endpunkt für Ihren Verbindungstyp: MCP ist nicht die Developer REST API. ChatGPT und Claude Desktop verwenden die Dashboardly-Kontoanmeldung (OAuth) und benötigen keinen geheimen API-Schlüssel. Claude Code und Cursor können den entfernten HTTP-MCP-Endpunkt mit einem Bearer-Schlüssel verwenden.
Was Sie prüfen sollten
Lesen Sie die öffentlichen Einrichtungsanweisungen. Sie müssen keinen temporären Schlüssel erstellen, um die URL zu finden. Für MCP verwenden Sie https://mcp.dashboardly.io/mcp, einschließlich /mcp. Developer REST verwendet https://api.dashboardly.io/api/developer/v1 von Ihrem Server aus, nicht vom Browser oder einer mobilen App. Verwechseln Sie die Endpunkte nicht.
Ihre Assistentenversion unterstützt MCP nicht
Prüfen Sie, ob der Assistent die gewünschte MCP-Verbindung unterstützt und Ihr Konto oder Workspace sie aktiviert hat. Ein App-Update allein schaltet eine deaktivierte Integration nicht frei.
Was Sie prüfen sollten
Aktualisieren Sie Ihren KI-Assistenten auf die neueste Version:
- Claude Desktop: Prüfen Sie Updates und folgen Sie den Dashboardly-OAuth-Anweisungen.
- Claude im Web: Prüfen Sie die aktuellen Integrationsmöglichkeiten Ihres Kontos oder Workspace.
- ChatGPT: Eigene Verbindungen hängen von Konto- und Workspace-Einstellungen ab; siehe offizielle Hinweise.
- Cursor: Aktualisieren Sie die App und folgen Sie den MCP-Anweisungen.
Starten Sie die App nach dem Update neu und versuchen Sie die Verbindung erneut.
„Authentication failed“ oder „Invalid API key“
Der Assistent erreicht Dashboardly, aber der Schlüssel wird abgelehnt.
Was Sie prüfen sollten
- Prüfen Sie den Schlüsselstatus. Ein unter Settings > API Keys widerrufener Schlüssel ist nicht wiederverwendbar. Erstellen Sie bei Bedarf einen Ersatz.
- Prüfen Sie das Ablaufdatum. Ein abgelaufener Schlüssel kann sich nicht authentifizieren; ersetzen Sie ihn bei Bedarf.
- Entfernen Sie versehentliche Leerzeichen. Vor oder nach dem Schlüssel dürfen keine Leerzeichen oder Zeilenumbrüche stehen.
- Kopieren Sie das vollständige Geheimnis. Es beginnt mit
dk_live_. Dashboardly zeigt es nur beim Erstellen oder Rotieren. Ist es verloren, nutzen Sie die verfügbare Rotationsaktion oder erstellen Sie einen Ersatz und aktualisieren Sie den Assistenten. - Prüfen Sie das Konto. Der Schlüssel muss zum Dashboardly-Konto gehören, dessen Daten Sie lesen möchten.
Wird ein neuer Schlüssel sofort abgelehnt, prüfen Sie Endpunkt, Authentifizierungsmethode, Ablaufdatum und Konto. Kontaktieren Sie bei anhaltenden Problemen den Support; erstellen Sie nicht wiederholt weitere Schlüssel nur zur Fehlersuche.
„Der KI-Assistent liefert keine Daten“ oder „Ich finde keine Bestellungen“
Die Verbindung funktioniert, aber der Assistent findet keine Daten zu Ihrer Frage.
Was Sie prüfen sollten
- Prüfen Sie Shop und Zugriffstyp. Kontrollieren Sie Shop unter API Keys und ersetzen Sie falsch zugeordnete Schlüssel durch einen für den gewünschten Shop. Nur berechtigte Eigentümer/Administratoren können bei MCP All shops wählen. Collaborator- und Developer-REST-Schlüssel sind auf einen Shop beschränkt. Neue MCP-Schlüssel verwenden standardmäßig Reporting & reconciliation, ohne Käuferkontakte, Adressen oder Tracking. Full orders & fulfilment verlangt eine ausdrückliche Auswahl durch berechtigte Eigentümer/Administratoren.
- Prüfen Sie den Zeitraum. Ein ruhiger Shop hat vielleicht letzte Woche keine Bestellungen. Versuchen Sie diesen Monat oder dieses Jahr.
- Prüfen Sie denselben Zeitraum in Dashboardly. Fehlt die Kennzahl auch dort, prüfen Sie Shop-Verbindung und Importstatus; siehe „Warum sind meine Daten verzögert?“.
- Prüfen Sie die passende Aktivität. Werbe- und Livestream-Kennzahlen benötigen entsprechende Daten. Ohne Werbung bedeutet kein oder null ROAS nicht automatisch einen Verbindungsfehler.
„Der Assistent sieht nur einen Shop, obwohl ich mehrere habe“
Die Lösung hängt davon ab, ob Sie die Dashboardly-Kontoanmeldung oder einen API-Schlüssel verwenden.
Was Sie prüfen sollten
Für eine OAuth-Verbindung mit ChatGPT oder Claude Desktop:
- Öffnen Sie Settings > API Keys und suchen Sie den Assistenten unter Connected Apps.
- Bei Current shop only verbinden Sie nur neu, wenn Sie den Shop-Bereich ändern möchten. Ein Widerruf entfernt den aktuellen Zugriff.
- Wählen Sie auf der neuen Zustimmungsseite Selected shops only für einzelne Shops oder All shops I can access nur, wenn Sie wirklich alle zugänglichen Shops freigeben möchten.
Eine Verbindung kann dann die autorisierten Shops verwenden. Getrennte Shops oder Shops ohne Ihre Zugriffsberechtigung werden automatisch entfernt. OAuth-Verbindungen aus der Zeit vor der Mehrshop-Auswahl behalten ihren ursprünglichen Einshop-Bereich bis zum Widerruf und erneuten Verbinden.
Bei MCP-API-Schlüsseln hängen die verfügbaren Optionen von Ihrer Kontorolle ab:
- Ein Schlüssel je Shop. Benennen Sie ihn passend, etwa „Claude Code — US Shop“ oder „Claude Code — UK Shop“, und wählen Sie im Assistenten den gewünschten Schlüssel.
- Ein MCP-Schlüssel für alle Shops. Berechtigte Eigentümer/Administratoren können für shopübergreifende Fragen unter Shop ausdrücklich All shops auswählen. Collaborator-Schlüssel bleiben auf einen Shop beschränkt; Developer REST erfordert ebenfalls einen ausgewählten Shop. Ein All-Shop-MCP-Schlüssel gewährt weder Developer-REST-Zugriff noch optionale Schreibberechtigungen.
Die Shop-Zuordnung eines Schlüssels lässt sich nach Erstellung nicht ändern. Widerrufen Sie ihn und erstellen Sie einen neuen, um zu einem anderen Shop zu wechseln.
„Einige Fragen brauchen lange bis zur Antwort“
Die Antwortzeit hängt von Assistent, Netzwerk, Zeitraum und Abfragekomplexität ab. Eine feste Antwortzeit für jede Frage wird nicht garantiert. Länger dauern können beispielsweise:
- Gewinn und Verlust über lange Zeiträume. Eine Jahresübersicht kann mehr Verarbeitung benötigen.
- Top-Produkte mehrerer Shops. Shop-Vergleiche verursachen zusätzliche Arbeit.
- Kundenlebenszeitwert. Wiederkaufsanalysen können mehr Daten benötigen.
Dauern einfache Fragen regelmäßig länger als 30 Sekunden, kontaktieren Sie den Support mit dem Zeitpunkt der langsamen Anfrage, damit wir die Logs prüfen können.
„Ich habe einen Schlüssel versehentlich widerrufen“
Widerrufene Schlüssel lassen sich nicht wiederherstellen. Es gibt kein Rückgängigmachen, weil Dashboardly das Schlüsselgeheimnis dauerhaft ungültig macht.
Was Sie prüfen sollten
- Klicken Sie unter Settings > API Keys auf New API key.
- Wählen Sie Shop, Ablaufdatum und zulässigen Zugriff. Neue MCP-Schlüssel haben standardmäßig Reporting-Zugriff; ein Ersatz übernimmt optionale Berechtigungen nicht automatisch.
- Kopieren Sie das neue Geheimnis bei der Anzeige und aktualisieren Sie Ihren Assistenten.
Der Ersatz hat ein eigenes Geheimnis und einen eigenen Nutzungsverlauf. Prüfen Sie vor Verwendung Shop und Berechtigungen; ein gleicher Name bedeutet nicht den gleichen Zugriff wie beim widerrufenen Schlüssel.
„Unter Connected Apps sehe ich eine unbekannte Verbindung“
Connected Apps am Ende der API-Keys-Seite zeigt KI-Assistenten, die sich mit Ihrem Dashboardly-Konto angemeldet haben. Bei einer unbekannten Verbindung:
Was Sie prüfen sollten
- Klicken Sie neben der Verbindung auf Revoke. Das macht Zugriffs- und Aktualisierungstokens sofort ungültig und verhindert weitere Nutzung.
- Ändern Sie Ihr Dashboardly-Passwort, wenn Sie eine Kompromittierung Ihres Kontos vermuten.
Kennen Sie den Assistenten, benötigen aber einen anderen Shop-Bereich, widerrufen Sie die Verbindung und verbinden Sie ihn erneut aus dem Assistenten heraus.
Wann Sie den Support kontaktieren sollten
Kontaktieren Sie den Support, wenn:
- Die Verbindung trotz der beschriebenen Schritte nicht funktioniert.
- Ein Schlüssel unbekannte Nutzung aufweist.
- API Keys sich anders verhält als beschrieben, etwa ein widerrufener Schlüssel scheinbar noch funktioniert.
- Ein berechtigter Brand- oder Agency-Plan auch nach erneuter Anmeldung keinen API-Keys-Tab zeigt.
Nennen Sie Schlüsselname, Assistentenname, genaue Fehlermeldung und einen passenden Screenshot — nicht das Geheimnis. Schwärzen Sie Tokens, Autorisierungsheader, Cookies und Kundendaten. Bei langsamen Anfragen geben Sie den Zeitpunkt an.
Teilen Sie niemals den vollständigen API-Schlüssel in einer Supportnachricht. Behandeln Sie ihn wie ein Passwort.