Überblick
Mit API-Schlüsseln können Sie Dashboardly mit einem KI-Assistenten wie ChatGPT, Claude oder Cursor verbinden, sodass der Assistent Fragen zu Ihren TikTok-Shop-Daten in einfacher Sprache beantworten kann. Sie fragen „Wie hoch war mein Net Profit letzte Woche?" oder „Welche SKU hat sich gestern in meinem UK-Shop am besten verkauft?", und der Assistent ruft die Antwort direkt aus Ihren aktuellen Dashboardly-Daten ab.
Die Verbindung nutzt einen offenen Standard namens Model Context Protocol (MCP), den jeder moderne KI-Assistent beherrscht. Sie erstellen einen API-Schlüssel pro Assistent (oder einen pro Shop), fügen ihn in die Einstellungen des Assistenten ein, und schon ist die Unterhaltung mit Ihren Daten verbunden.
API-Schlüssel sind schreibgeschützt. Ein KI-Assistent kann jede Kennzahl lesen, die Sie in Dashboardly sehen, aber er kann keine Bestellungen anlegen, keine Produktkosten ändern, keine Einstellungen bearbeiten, keine Erstattungen veranlassen und nichts in Ihrem TikTok Shop oder Ihrem Dashboardly-Konto verändern.
Sie verwalten alle Schlüssel auf der Seite Einstellungen > API-Schlüssel.
Plananforderungen
API-Schlüssel sind Teil der KI-Integrationsfunktion von Dashboardly und in den folgenden Plänen verfügbar:
| Plan | Enthaltene API-Schlüssel |
|---|---|
| Brand Starter | Nicht verfügbar |
| Brand Growth | Verfügbar |
| Brand Pro | Verfügbar |
| Brand Elite | Verfügbar |
Wenn Sie Brand Starter nutzen, zeigt der Tab „API-Schlüssel" in den Einstellungen eine Upgrade-Aufforderung an. Führen Sie auf der Seite Einstellungen > Abonnements ein Upgrade Ihres Abonnements durch, um die Funktion freizuschalten.
Es fällt keine Gebühr pro Schlüssel an. Sie können in einem berechtigten Plan beliebig viele Schlüssel erstellen, ohne dass für die Abfragen Ihres KI-Assistenten zusätzliche Kosten entstehen.
So funktioniert es
Wenn Sie in Dashboardly einen API-Schlüssel erstellen, geschehen zwei Dinge:
- Der Schlüssel wird generiert. Er sieht aus wie
dk_live_..., gefolgt von einer langen zufälligen Zeichenfolge. Sie sehen den vollständigen Schlüssel genau einmal, im Moment der Erstellung. Danach speichert Dashboardly nur einen Fingerabdruck davon, sodass selbst unser Support-Team den vollständigen Schlüssel später nicht abrufen kann. - Der Schlüssel ist an Ihr Konto gebunden. Jeder Schlüssel ist mit Ihrem Dashboardly-Login und optional mit einem einzelnen TikTok Shop verknüpft. Wenn ein KI-Assistent den Schlüssel verwendet, um Daten anzufordern, erhält er genau das zurück, was Sie sehen würden, wenn Sie diesen Shop in Ihrem Browser öffnen.
Ihr KI-Assistent verbindet sich mit einem Dashboardly-Endpunkt (dem MCP-Server) und übergibt den Schlüssel. Der Endpunkt überprüft den Schlüssel, ermittelt, welchen Shop der Schlüssel lesen darf, und gibt die angeforderten Daten zurück. Jede Anfrage wird protokolliert, sodass Sie sehen können, wie oft Ihr Assistent den Schlüssel verwendet und welche Fragen er stellt.
Da der Schlüssel schreibgeschützt ist, hat der Assistent keine Möglichkeit, etwas zu ändern. Die „destruktivste" Aktion, die er ausführen kann, ist das Lesen einer Kennzahl.
Schritt für Schritt: Ihren ersten API-Schlüssel erstellen
Schritt 1: Die Seite „API-Schlüssel" öffnen
Navigieren Sie in der linken Seitenleiste zu Einstellungen > API-Schlüssel. Falls Sie den Tab nicht sehen, prüfen Sie, ob Ihr Abonnement Brand Growth oder höher ist.
Schritt 2: Auf „Neuer API-Schlüssel" klicken
Klicken Sie oben rechts auf der Seite auf die Schaltfläche + Neuer API-Schlüssel. Ein kleines Formular öffnet sich.
Schritt 3: Die Details ausfüllen
- Name -- Eine Bezeichnung, damit Sie den Schlüssel später wiedererkennen. Verwenden Sie etwas Aussagekräftiges wie „Claude Desktop -- US-Shop" oder „ChatGPT für John". Namen sind nur für Sie sichtbar.
- Shop -- Wählen Sie einen einzelnen Shop oder belassen Sie das Feld auf „Alle Shops", um dem Schlüssel Zugriff auf jeden Ihrer verbundenen Shops zu geben. Die meisten Nutzer bevorzugen einen Schlüssel pro Shop, sodass jede KI-Unterhaltung automatisch auf die richtigen Daten beschränkt ist.
- Läuft ab in -- Nach wie vielen Tagen der Schlüssel automatisch nicht mehr funktioniert. Der Standardwert beträgt 365 Tage. Kürzere Ablaufzeiten sind sicherer; längere bedeuten, dass Sie den Schlüssel seltener wechseln müssen. Sie können einen Schlüssel jederzeit unabhängig von seiner Ablaufzeit widerrufen.
Schritt 4: Auf „Schlüssel erstellen" klicken
Dashboardly generiert den Schlüssel und zeigt ihn in einem Bestätigungsfenster an. Der Schlüssel wird nur dieses eine Mal vollständig angezeigt.
Schritt 5: Den Schlüssel sofort kopieren
Klicken Sie auf die Schaltfläche Kopieren, um den Schlüssel in die Zwischenablage zu legen. Fügen Sie ihn an einem sicheren Ort ein (in der Konfigurationsdatei Ihres Assistenten, in einem Passwortmanager oder in einer sicheren Notiz). Wenn Sie das Fenster schließen, ohne zu kopieren, müssen Sie den Schlüssel widerrufen und einen neuen erstellen -- es gibt keine Möglichkeit, ihn erneut abzurufen.
Schritt 6: Ihren KI-Assistenten verbinden
Öffnen Sie die Einstellungen Ihres KI-Assistenten und fügen Sie Dashboardly als Verbindung hinzu (der genaue Pfad variiert je nach Assistent; Hinweise zu den einzelnen Assistenten finden Sie im nächsten Abschnitt).
Schritt 7: Die Verbindung bestätigen
Stellen Sie Ihrem Assistenten eine einfache Frage wie „Wie hoch war mein Net Profit letzte Woche?". Wenn alles korrekt eingerichtet ist, antwortet der Assistent mit der aus Ihren aktuellen Dashboardly-Daten abgerufenen Antwort. Falls Sie einen Fehler sehen, lesen Sie Warum funktioniert mein KI-Assistent nicht?.
Einen KI-Assistenten verbinden
Die genaue Einrichtung hängt davon ab, welchen Assistenten Sie verwenden. Nachdem Sie den Schlüssel in Dashboardly erstellt haben, zeigt das Bestätigungsfenster fertige Konfigurations-Snippets zum Einfügen für die gängigsten Tools an.
Claude (Desktop und Web)
Suchen Sie in den Einstellungen von Claude nach einem Bereich namens Connectors, Integrationen oder MCP-Server. Fügen Sie eine neue Verbindung hinzu, indem Sie die Dashboardly-Endpunkt-URL und Ihren API-Schlüssel einfügen. Nach dem Speichern zeigt Claude Dashboardly in jeder Unterhaltung als verfügbare Verbindung an.
Wenn Sie Claude Desktop verwenden, wird die Verbindung zu einer Konfigurationsdatei hinzugefügt, die beim Start von Claude geladen wird. Das Bestätigungsfenster in Dashboardly zeigt den genauen Text zum Einfügen an.
ChatGPT
Öffnen Sie in ChatGPT das Menü Apps & Connectors und fügen Sie Dashboardly als benutzerdefinierten Connector hinzu. Fügen Sie auf Aufforderung die Endpunkt-URL und den API-Schlüssel ein. ChatGPT merkt sich die Verbindung über all Ihre Unterhaltungen hinweg.
Cursor
Öffnen Sie in Cursor Einstellungen > MCP, klicken Sie auf Neuen MCP-Server hinzufügen und fügen Sie den Dashboardly-Endpunkt und den Schlüssel ein. Cursor nutzt die Verbindung, während Sie programmieren, sodass Sie Fragen stellen können wie „Was ist diesen Monat meine meistverkaufte SKU?", ohne Ihren Editor zu verlassen.
Andere KI-Assistenten
Jeder Assistent, der das Model Context Protocol beherrscht, kann sich verbinden. Stellen Sie dem Assistenten die Dashboardly-MCP-Endpunkt-URL und den API-Schlüssel bereit (behandeln Sie ihn wie ein Passwort). Der Assistent sollte automatisch erkennen, welche Daten verfügbar sind.
Was Ihr KI-Assistent kann
Nach der Verbindung kann Ihr Assistent Fragen zu allen wichtigen Bereichen Ihrer Shop-Daten beantworten. Sie stellen Fragen in einfacher Sprache (oder in jeder Sprache, die Ihr Assistent unterstützt), und der Assistent entscheidet, welche Daten er abrufen muss.
| Thema | Beispielfragen |
|---|---|
| Konto & Shops | „Welche Shops sind verbunden?" „Wie lautet meine Konto-E-Mail?" |
| Dashboard-Übersicht | „Gib mir einen kurzen Überblick über letzte Woche." „Wie entwickeln sich die Verkäufe im Vergleich zum letzten Monat?" |
| Profit & Loss | „Wie hoch war mein Net Profit im März?" „Schlüssle meine P&L für das letzte Quartal nach Wochen auf." |
| Bestellungen | „Wie viele Bestellungen habe ich gestern erhalten?" „Zeig mir die stornierten Bestellungen der letzten 7 Tage." |
| Top-Produkte | „Welche SKUs haben sich letzten Monat am besten verkauft?" „Was waren meine Top-10-Produkte nach Umsatz in diesem Quartal?" |
| Erstattungen | „Wie viel habe ich letzte Woche erstattet?" „Welche Produkte haben die höchste Rücksendequote?" |
| Kunden | „Wie viele Stammkunden habe ich?" „Wie hoch ist der Lifetime Value meines durchschnittlichen Kunden?" |
| Marketing & Anzeigen | „Wie hoch war mein ROAS bei TikTok Ads letzte Woche?" „Wie performen meine Werbekampagnen?" |
| Live-Streams & Aktionen | „Welche Live-Streams haben letzten Monat die meisten Verkäufe gebracht?" „Wie viel habe ich im April durch Plattform-Subventionen gespart?" |
| Lagerbestand | „Bei welchen SKUs wird der Bestand knapp?" „Wie hoch ist mein aktueller Lagerwert?" |
| Geografische Aufschlüsselung | „Woher kommen die meisten meiner Bestellungen?" „Wie laufen die Verkäufe diesen Monat in Deutschland?" |
| Stündliche Kennzahlen | „Zu welcher Tageszeit gehen die meisten Bestellungen ein?" „Zeig mir die Verkäufe von gestern Stunde für Stunde." |
Der Assistent kann keine Aktionen in Ihrem TikTok Shop oder in Dashboardly ausführen. Er kann nur lesen.
Ihre Schlüssel verwalten
Schlüssel ansehen
Die Seite Einstellungen > API-Schlüssel listet jeden von Ihnen erstellten Schlüssel mit seinem Namen, den ersten Zeichen des Schlüssels (damit Sie ihn wiedererkennen), dem Shop, an den er gebunden ist, dem Erstellungszeitpunkt, dem Zeitpunkt der letzten Verwendung und dem Ablaufdatum auf.
Nutzung einsehen
Klicken Sie auf einen beliebigen aktiven Schlüssel, um ein Nutzungsfenster aufzuklappen, das Folgendes anzeigt:
- Gesamtzahl der Aufrufe in den letzten 30 Tagen
- Erfolgsquote (Aufrufe, die erfolgreich Daten zurückgegeben haben)
- Durchschnittliche Antwortzeit, damit Sie wissen, dass die Verbindung schnell ist
- Ein Diagramm der täglichen Aktivität der letzten 7 Tage
- Die am häufigsten genutzten Daten-Tools, damit Sie sehen können, wonach der Assistent am meisten fragt
Das ist nützlich, um zu bestätigen, dass ein Schlüssel verwendet wird, ungewöhnliche Aktivitäten zu erkennen oder zu sehen, worauf sich Ihr Assistent tendenziell konzentriert.
Einen Schlüssel widerrufen
Wenn ein Schlüssel verloren geht, offengelegt wurde oder nicht mehr benötigt wird, klicken Sie auf das Symbol Widerrufen daneben. Dashboardly blockiert sofort alle weiteren Anfragen mit diesem Schlüssel. KI-Assistenten, die mit dem widerrufenen Schlüssel verbunden sind, sehen bei ihrer nächsten Frage einen Fehler.
Das Widerrufen erfolgt sofort. Es gibt keine Übergangsfrist.
Ablauf von Schlüsseln
Jeder Schlüssel hat ein Ablaufdatum, das bei der Erstellung festgelegt wird. Dashboardly zeigt auf der Seite „API-Schlüssel" ein Warnabzeichen an, wenn ein Schlüssel noch 14 Tage oder weniger gültig ist. Abgelaufene Schlüssel funktionieren automatisch nicht mehr -- Sie müssen sie nicht widerrufen.
Um einen Schlüssel regelmäßig zu wechseln, erstellen Sie einen neuen Schlüssel, aktualisieren Sie Ihren KI-Assistenten so, dass er ihn verwendet, und widerrufen Sie dann den alten.
Verbundene Apps
Einige KI-Assistenten (insbesondere ChatGPT) verbinden sich über einen Ein-Klick-Anmeldevorgang, anstatt dass Sie einen API-Schlüssel kopieren müssen. Wenn Sie Dashboardly einem dieser Assistenten Zugriff gewähren, erscheint er im Abschnitt Verbundene Apps am Ende der Seite „API-Schlüssel".
Für jede verbundene App können Sie ihren Namen, den Zeitpunkt der ersten Verbindung, den Zeitpunkt der letzten Aktivität und zwei Möglichkeiten zum Trennen einsehen:
- Widerrufen -- Blockiert neue Anmeldungen von diesem Assistenten. Aktive Sitzungen bleiben bis zu einer Stunde gültig und laufen dann ab.
- Jetzt abmelden -- Trennt den Assistenten sofort vollständig und beendet jede aktive Sitzung. Verwenden Sie dies, wenn Sie vermuten, dass die Verbindung missbraucht wird.
Sicherheit & Datenschutz
API-Schlüssel sind vertraulich. Behandeln Sie jeden Schlüssel wie ein Passwort.
- Übertragen Sie einen Schlüssel niemals in ein öffentliches Code-Repository. Falls Sie es versehentlich tun, widerrufen Sie ihn in Dashboardly und erstellen Sie einen neuen.
- Teilen Sie einen Schlüssel niemals in einer Chat-Nachricht, E-Mail oder einem Screenshot. Jeder mit dem Schlüssel kann Ihre Daten lesen, bis Sie ihn widerrufen.
- Verwenden Sie einen Schlüssel pro Assistent oder pro Gerät. Falls ein Schlüssel auf einem Gerät kompromittiert wird, können Sie so nur diesen Schlüssel widerrufen, ohne Ihre anderen Verbindungen zu stören.
- Legen Sie eine sinnvolle Ablaufzeit fest. Ein Schlüssel, der nach 90 Tagen abläuft, ist sicherer als einer, der ewig gilt. Sie können jederzeit einen neuen erstellen.
Dashboardly zeigt den vollständigen Schlüssel nach der Erstellung nie wieder an. Der einzige Ort, an dem Sie ihn finden, ist dort, wo Sie ihn bei der Erstellung gespeichert haben.
Alle Anfragen von KI-Assistenten erfolgen über HTTPS. Jede Anfrage wird mit einem Zeitstempel und dem abgefragten Datenbereich protokolliert. Sie können diesen Verlauf pro Schlüssel im oben beschriebenen Nutzungsfenster prüfen.
Schreibgeschützt bedeutet schreibgeschützt: Selbst wenn ein Schlüssel kompromittiert würde, könnte ein Angreifer Ihre Daten sehen, aber er könnte keine einzige Produktkosten ändern, keine Erstattung veranlassen und Ihren TikTok Shop in keiner Weise beeinflussen.
Häufige Fragen
Sieht mein KI-Assistent mein gesamtes Dashboardly-Konto oder nur einen Shop?
Das hängt davon ab, wie Sie den Schlüssel konfiguriert haben. Wenn Sie den Schlüssel an einen einzelnen Shop gebunden haben, sieht der Assistent nur diesen Shop. Wenn Sie „Alle Shops" ausgewählt gelassen haben, kann der Assistent Daten aus jedem Shop Ihres Kontos lesen. Die meisten Nutzer bevorzugen aus Gründen der Klarheit einen Schlüssel pro Shop.
Kann ich verschiedene Schlüssel für verschiedene Teammitglieder erstellen?
Ja. Erstellen Sie einen benannten Schlüssel pro Person („Claude -- Maria", „ChatGPT -- John") und teilen Sie jeden Schlüssel nur mit der Person, die ihn benötigt. Wenn jemand das Team verlässt, widerrufen Sie seinen Schlüssel, ohne jemand anderen zu beeinträchtigen.
Kostet mich die Nutzung eines KI-Assistenten extra?
Nein. Es fällt keine Gebühr pro Abfrage von Dashboardly an. Ihr KI-Assistenten-Anbieter (OpenAI, Anthropic usw.) berechnet Ihnen den Assistenten selbst separat nach seinen eigenen Preisen.
Wie aktuell sind die Daten, die mein Assistent sieht?
Genauso aktuell wie das, was Sie in Dashboardly sehen. Wenn das Dashboard eine Kennzahl anzeigt, die vor 2 Minuten aktualisiert wurde, ist das genau das, was der Assistent erhält. Abrechnungsbasierte Zahlen (Gebühren, Steuern) können für ganz aktuelle Bestellungen geschätzt sein -- die ganze Geschichte finden Sie unter Warum sind meine Daten verzögert?.
Kann mein KI-Assistent Änderungen an meinem Shop vornehmen?
Nein. Jeder API-Schlüssel ist schreibgeschützt. Es gibt keinen „Schreib"-Modus und keinen Plan, einen hinzuzufügen. Das Maximum, das ein Assistent tun kann, ist, die von ihm gelesenen Zahlen zusammenzufassen.
Was passiert mit meinen alten Schlüsseln, wenn ich meinen Plan herabstufe?
Wenn Sie auf Brand Starter herabstufen, funktionieren alle vorhandenen API-Schlüssel sofort nicht mehr. Führen Sie ein erneutes Upgrade auf Brand Growth oder höher durch, um sie zu reaktivieren, oder erstellen Sie nach dem Upgrade neue Schlüssel.
Kann ich sehen, was mein KI-Assistent gefragt hat?
Ja. Das Nutzungsfenster für jeden Schlüssel zeigt die am häufigsten genutzten Datenbereiche (Bestellungen, P&L, Top-Produkte usw.) und ein Aktivitätsdiagramm der letzten 7 Tage. Wir protokollieren nicht die natürlichsprachlichen Fragen, die der Nutzer eingegeben hat -- nur, welche Daten-Tools der Assistent aufgerufen hat.