Die API/MCP-Seite in 3Dsellers zeigt alle API- und MCP-Tokens, die für Ihr Unternehmen ausgestellt wurden, jede Anfrage, die mit diesen Tokens gestellt wurde, und wie viel Ihres Rate Limits Sie verbraucht haben. Hier erstellen Sie ein Token, widerrufen eines, dem Sie nicht mehr vertrauen, und finden heraus, warum eine Integration oder ein KI-Agent fehlschlägt, ohne den Support zu kontaktieren. Sie öffnen die Seite über Ihren Namen unten im linken Menü > API/MCP oder direkt unter app.3dsellers.com/api-mcp.
💡 Neu bei der 3Dsellers API oder MCP? Lesen Sie zuerst KI-Agenten per MCP mit 3Dsellers verbinden und verwalten Sie die Verbindung anschließend hier.
Was macht die API/MCP-Seite in 3Dsellers?
Die API/MCP-Seite hat drei Tabs:
Tokens - die Schaltflächen, um Claude zu verbinden, ein API-Token zu erhalten oder MCP zu verbinden, sowie die Liste aller für Ihr Unternehmen ausgestellten Tokens mit Scope, Status, Anzahl der Anfragen, letzter Nutzung und Ablaufdatum.
Requests - ein Protokoll aller REST-API-Aufrufe und MCP-Tool-Aufrufe Ihrer Tokens, mit einer Übersicht der letzten 7 Tage, Filtern und allen Details zu jedem Aufruf.
Rate limits - wie viele Aufrufe Sie in der aktuellen Minute und am aktuellen Tag pro Limit verbraucht haben und wann jeder Zähler zurückgesetzt wird.
Die API/MCP-Seite ändert keine Produkte, Angebote oder Bestellungen. Sie zeigt nur, was Ihre Tokens getan haben, und lässt Sie Tokens erstellen oder widerrufen.
Wo finde ich die API/MCP-Seite?
Melden Sie sich bei 3Dsellers an.
Klicken Sie unten im linken Menü auf Ihren Namen.
Wählen Sie API/MCP.
Sie erreichen die Seite auch über Settings > Profile > API / MCP im Einstellungsmenü oder direkt unter app.3dsellers.com/api-mcp. Die Seite öffnet sich im Tab Tokens.
Tab Tokens: 3Dsellers API-Tokens erstellen, prüfen und widerrufen
Oben im Tab Tokens finden Sie drei Schaltflächen:
Add to Claude - verbindet 3Dsellers mit Claude. Die vollständige Anleitung finden Sie unter KI-Agenten per MCP mit 3Dsellers verbinden.
Get API token - erstellt ein Bearer-Token für Ihre eigene Integration oder Ihr eigenes Skript, das die 3Dsellers REST API aufruft.
Connect MCP - zeigt, wie Sie einen MCP-Client verbinden: Connect in Claude, Copy URL (die Server-URL lautet
https://api.3dsellers.com/mcp) und einen Bereich For developers mit einem Token und einem fertigen Befehl.
Der Tab Tokens der 3Dsellers API/MCP-Seite mit den Schaltflächen Add to Claude, Get API token und Connect MCP
Warum meldet Get API token, dass ich bereits aktive Tokens habe?
Wenn Ihr Unternehmen für dieselbe App bereits aktive Tokens hat, zeigen Get API token und der Entwicklerbereich von Connect MCP zuerst eine Warnung: "You already have N active tokens for this app", zusammen mit der Liste dieser Tokens. Ein neues Token wird erst erstellt, wenn Sie auf Generate new token anyway klicken.
Ein neues Token widerruft die alten nicht: Jedes Token bleibt aktiv, bis es abläuft oder Sie es widerrufen. Wenn Sie ein Token ersetzen, widerrufen Sie das alte anschließend in der Liste Issued tokens.
Was zeigt die Liste Issued tokens?
Unter den Schaltflächen listet Issued tokens alle Tokens auf, die für Ihr 3Dsellers-Unternehmen ausgestellt wurden:
Spalte | Was sie zeigt |
App | Die App oder der Agent, für die das Token ausgestellt wurde |
Token | Die letzten 6 Zeichen des Tokens, zum Beispiel …8ffb6d. Derselbe Kurzcode erscheint im Filter des Tabs Requests, in den Anfragedetails und in der Widerrufsbestätigung, sodass Sie sie mit bloßem Auge zuordnen können. |
Scope | Was das Token tun darf, zum Beispiel |
Status | Active oder Revoked |
Requests | Wie viele Aufrufe mit diesem Token protokolliert wurden |
Last used | Der Zeitpunkt des letzten protokollierten Aufrufs, oder "-", wenn es keinen gibt |
Created / Expires | Wann das Token ausgestellt wurde und wann es nicht mehr funktioniert. Die Tokens in unseren Beispielen laufen etwa sechs Monate nach ihrer Erstellung ab. |
Actions | Requests öffnet den Tab Requests, gefiltert auf dieses Token. Revoke erscheint nur bei aktiven Tokens. |
Die Liste Issued tokens mit Token-Codes, Scopes, Status, Anzahl der Anfragen und den Schaltflächen Requests und Revoke
Wie widerrufe ich ein 3Dsellers API- oder MCP-Token?
Suchen Sie im Tab Tokens das Token unter Issued tokens (anhand der letzten 6 Zeichen).
Klicken Sie in seiner Zeile auf Revoke.
Bestätigen Sie. Die Bestätigung nennt die App und die letzten Zeichen des Tokens.
Die Zeile wechselt zu Revoked. Das Token funktioniert ab der nächsten Anfrage nicht mehr, und die App oder der KI-Agent, der es genutzt hat, muss sich neu verbinden. Ein Widerruf kann nicht rückgängig gemacht werden; erstellen Sie ein neues Token, wenn Sie wieder Zugriff brauchen.
Um alle Integrationen auf einmal zu trennen, klicken Sie über der Liste auf Revoke all. Vorher werden Sie mit "Revoke all N active tokens?" um Bestätigung gebeten.
⚠️ Revoke all trennt gleichzeitig jede App und jeden KI-Agenten, der ein 3Dsellers-Token nutzt, einschließlich Claude und aller eigenen Integrationen. Nutzen Sie es nur, wenn Sie vermuten, dass ein Token in falsche Hände geraten ist.
Tab Requests: das Protokoll aller 3Dsellers API- und MCP-Aufrufe
Der Tab Requests der API/MCP-Seite protokolliert jeden REST-API-Aufruf und jeden MCP-Tool-Aufruf Ihrer Tokens. Oben sehen Sie eine Übersicht der letzten 7 Tage:
Requests (7d) und Errors - Aufrufe insgesamt und wie viele davon fehlgeschlagen sind
REST und MCP - die Aufteilung zwischen direkten API-Aufrufen und Tool-Aufrufen von KI-Agenten
Requests per day - ein Diagramm, Fehler in Rot
Most called - die am häufigsten genutzten Endpunkte und Tools mit ihrer Fehleranzahl
Die 7-Tage-Übersicht im Tab Requests mit Anzahl der Anfragen und Fehler, dem Tagesdiagramm und den meistgenutzten Endpunkten
Unter der Übersicht folgt das eigentliche Protokoll. Filtern Sie es mit dem Suchfeld (Endpunkt- oder Tool-Name), Source (REST oder MCP), Status und einem Zeitraum From / To. Klicken Sie auf Refresh, um neue Aufrufe zu laden. Jede Zeile zeigt:
Spalte | Bedeutung |
Time | Wann der Aufruf erfolgte |
Source | REST für einen API-Aufruf, MCP für einen Tool-Aufruf eines KI-Agenten |
Endpoint / tool | Bei REST die Methode und der Pfad, zum Beispiel |
Status | Der HTTP-Status. 200 bedeutet Erfolg. 200 error bedeutet, dass ein MCP-Tool ausgeführt wurde, aber einen Fehler zurückgegeben hat (MCP-Tools antworten auch bei einem Fehler mit 200). 4xx-Codes bedeuten, dass der Aufruf abgelehnt wurde, zum Beispiel 403, wenn das Token nicht den Scope hat, den der Aufruf braucht. |
Duration | Wie lange 3Dsellers für die Antwort gebraucht hat |
Window | Der Rate-Limit-Zähler, auf den der Aufruf angerechnet wurde, zum Beispiel |
Remaining | Wie viele Aufrufe in diesem Zähler direkt nach diesem Aufruf noch übrig waren |
Seller | Die Seller-ID, für die der Aufruf erfolgte, wenn der Aufruf eine angegeben hat |
Error | Die Fehlermeldung, wenn der Aufruf fehlgeschlagen ist |
Das Protokoll im Tab Requests mit einem hervorgehobenen fehlgeschlagenen MCP-Aufruf, Status 200 error und der Meldung in der Spalte Error
Um nur die Aufrufe eines Tokens zu sehen, klicken Sie im Tab Tokens in der Zeile dieses Tokens auf Requests. Der Tab Requests öffnet sich mit einem Filter-Tag "Token …xxxxxx"; schließen Sie das Tag, um wieder alle Tokens zu sehen.
Wie sehe ich die Details einer 3Dsellers API-Anfrage?
Klicken Sie im Protokoll des Tabs Requests auf eine Zeile, um ihre Details zu öffnen: den Status, die letzten 6 Zeichen des Tokens, was gesendet wurde und, bei REST-Aufrufen, was 3Dsellers geantwortet hat.
Werte, die wie Geheimnisse aussehen (Felder mit Namen wie token, secret, password, API key, credentials oder authorization), werden als [redacted] angezeigt.
Bei MCP-Aufrufen werden die Argumente des Tools gespeichert, sein Ergebnis aber nicht: MCP-Ergebnisse werden direkt an den KI-Agenten gestreamt und nicht gespeichert.
Lange Anfrage- und Antwortinhalte werden gekürzt.
Tab Rate limits: Wie nah bin ich an meinem 3Dsellers API-Limit?
Der Tab Rate limits zeigt jedes Limit, das für Ihr Konto gilt, wie viel davon Sie in der aktuellen Minute und am aktuellen Tag verbraucht haben und wann jeder Zähler zurückgesetzt wird. Das Badge oben zeigt, welche Plan-Limits gelten, zum Beispiel
Paid plan limits.
Minutenzähler werden alle 60 Sekunden zurückgesetzt.
Tageszähler werden um 00:00 UTC zurückgesetzt.
REST- und MCP-Aufrufe teilen sich dieselben Zähler: Ein KI-Agent und Ihre eigene Integration verbrauchen dasselbe Limit.
Klicken Sie auf den Pfeil in einer Zeile, um zu sehen, welche Endpunkte auf dieses Limit angerechnet werden.
In einem bezahlten Plan gelten in unserem Beispiel diese Limits:
Limit | Pro Minute | Pro Tag | Zählt |
All API and MCP calls (general) | 600 | 50.000 | Alle REST-Endpunkte und MCP-Tools zusammen |
Order reads (order-read) | 120 | 5.000 | GET /v1/orders |
Order writes (order-write) | 60 | 2.500 | Bestell-Tags und Sendungsverfolgung |
Product reads (product-read) | 120 | 5.000 | GET /v1/products, Produktdetails und Angebote |
Product writes (product-write) | 60 | 5.000 | Erstellen und Aktualisieren von Produkten, Kategorien, Tags, Vorlagen und Mapping-Regeln |
Weitere Zeilen darunter betreffen andere Vorgänge, zum Beispiel das Erstellen von Aktionen und Import-Zeitplänen. Jeder Aufruf zählt gegen das Limit general und, falls vorhanden, zusätzlich gegen sein eigenes Vorgangs-Limit.
Der Tab Rate limits mit dem Verbrauch pro Minute und pro Tag für jedes Limit und den Zeiten bis zum Zurücksetzen
Beispiel: einen Fehler im 3Dsellers-Anfrageprotokoll lesen
Ein KI-Agent sollte einen CSV-Import-Zeitplan ausführen, und es passierte nichts. Im Tab Requests:
Setzen Sie Status auf Error.
Die Zeile
mcp:run-import-schedulezeigt 200 error.In der Spalte Error steht: "Import schedule 17096 is paused, and the platform only runs active schedules."
Die Lösung: Aktivieren Sie den Zeitplan und führen Sie ihn erneut aus. Eine Zeile mcp:create-import-schedule mit "Unique constraint failed on the fields: (seller_id, file_url)" bedeutet, dass für diesen Seller und diese Datei-URL bereits ein Zeitplan existiert. Der Agent sollte dann den vorhandenen Zeitplan aktualisieren, statt einen neuen zu erstellen.
Was das 3Dsellers-Anfrageprotokoll nicht zeigt
Aufrufe mit fehlendem, falschem oder widerrufenem Token. 3Dsellers kann nicht erkennen, zu welchem Unternehmen sie gehören, daher werden sie nicht protokolliert. Wenn eine Integration fehlschlägt und Sie keine Zeilen sehen, prüfen Sie, ob ihr Token noch Active ist.
Die Ergebnisse von MCP-Tool-Aufrufen (nur ihre Argumente werden gespeichert).
Anmelden und Verbinden. Protokolliert werden nur Aufrufe der API und von MCP-Tools.
Fehlerbehebung
Meine Integration oder mein KI-Agent funktioniert nicht mehr
Prüfen Sie im Tab Tokens den Status und das Datum unter Expires des Tokens. Ein widerrufenes oder abgelaufenes Token muss ersetzt werden: Erstellen Sie ein neues und aktualisieren Sie die Integration, oder verbinden Sie den KI-Agenten neu.
Setzen Sie im Tab Requests den Status auf Error und lesen Sie die Spalte Error für dieses Token.
Prüfen Sie im Tab Rate limits, ob ein Zähler sein Limit erreicht hat und wann er zurückgesetzt wird.
Ich sehe 403 "Insufficient scope" im Anfrageprotokoll
Ein 403 mit "Insufficient scope" bedeutet, dass das Token diesen Aufruf nicht ausführen darf, zum Beispiel ein product:read-Token, das Bestellungen lesen will. Prüfen Sie den Scope des Tokens im Tab Tokens und verbinden Sie sich erneut mit einem Token, das den benötigten Scope hat.
Ein Token zeigt 0 Anfragen, aber meine Integration sagt, dass sie 3Dsellers aufruft
Die Aufrufe nutzen wahrscheinlich nicht dieses Token. Aufrufe mit fehlendem oder ungültigem Token werden gar nicht protokolliert. Vergleichen Sie die letzten 6 Zeichen des Tokens in Ihrer Integration mit der Spalte Token.
FAQ
Widerruft ein neues 3Dsellers API-Token mein altes?
Nein - ein neues Token über Get API token oder Connect MCP widerruft Ihre vorhandenen Tokens nicht. Sie bleiben aktiv, bis sie ablaufen oder Sie sie im Tab Tokens widerrufen.
Was bedeutet "200 error" im 3Dsellers-Anfrageprotokoll?
"200 error" bedeutet, dass ein MCP-Tool erreicht und ausgeführt wurde, aber einen Fehler zurückgegeben hat. MCP-Tools antworten auch bei einem Fehler mit HTTP 200, daher markiert 3Dsellers diese Zeilen als Fehler und zeigt die Meldung des Tools in der Spalte Error.
Wie weit reicht der Tab Requests zurück?
Die Übersicht und das Diagramm im Tab Requests umfassen die letzten 7 Tage. Mit dem Filter From / To sehen Sie im Protokoll einen bestimmten Zeitraum.
Haben REST-API-Aufrufe und MCP-Aufrufe getrennte Rate Limits?
Nein - REST-API-Aufrufe und MCP-Tool-Aufrufe teilen sich dieselben 3Dsellers Rate-Limit-Zähler. Ein KI-Agent und Ihre eigene Integration verbrauchen dieselben Minuten- und Tageslimits.
Wann werden die 3Dsellers API Rate Limits zurückgesetzt?
Minutenlimits werden alle 60 Sekunden zurückgesetzt, Tageslimits um 00:00 UTC. Der Tab Rate limits zeigt die verbleibende Zeit bis zu jedem Zurücksetzen.
Kann ich meinen API-Schlüssel auf der API/MCP-Seite vollständig sehen?
Nein - die API/MCP-Seite zeigt nur die letzten 6 Zeichen jedes Tokens. Kopieren Sie das vollständige Token, wenn Sie es erstellen, und halten Sie es geheim.
Sind meine Daten im Anfrageprotokoll sicher?
Das 3Dsellers-Anfrageprotokoll blendet Werte, die wie Geheimnisse aussehen (Tokens, Passwörter, API-Schlüssel, Zugangsdaten), als [redacted] aus, und nur Personen in Ihrem 3Dsellers-Unternehmen können es sehen.