Skip to main content
Arbeiten Sie den Abschnitt durch, der zu dem passt, was Sie sehen. Wenn keiner passt, schreiben Sie an mcp@storekit.com mit dem Namen Ihres Assistenten, der gestellten Frage und der Uhrzeit — jede Anfrage trägt eine ID, die wir nachschlagen können.

Verbinden

storekit konnte die Übergabe an Ihren Assistenten nicht abschließen. Versuchen Sie es noch einmal aus dem Assistenten heraus. Wenn es ein zweites Mal scheitert, ist Ihr Konto wahrscheinlich noch nicht für die Beta aktiviert — Zugriff anfragen, oder E-Mail an mcp@storekit.com mit der E-Mail, mit der Sie sich angemeldet haben.
  • Ihre Anmeldung ist abgelaufen oder wurde gelöscht. Nutzen Sie die Reconnect-Option des Assistenten (siehe Ihre Verbindungsanleitung).
  • Manche Clients erfordern, dass Sie den Konnektor auch innerhalb des Chats einschalten, nicht nur hinzufügen. Prüfen Sie das Tools-Menü des Chats.
storekit verwendet MCP Streamable HTTP. Ein Client, der nur stdio oder SSE unterstützt, kann sich nicht direkt verbinden; siehe Andere Clients verbinden für die Optionen.

Antworten sehen falsch aus

Nennen Sie den Store in Ihrer Frage. Wenn Sie das nicht tun, decken Bestelllisten das gesamte Konto ab und Summen werden darüber summiert. Wenn das Konto Stores in verschiedenen Währungen hat, werden kontoweite Summen abgelehnt, und der Assistent bittet Sie, einen auszuwählen.
storekit gibt Geld in Minor Units (Pence, Cents) zurück, und der Assistent hat die Rohzahl angezeigt. Sagen Sie ihm „amounts are in pence, show them in pounds”. Das ist ein Präsentationsversehen des Assistenten, kein Datenfehler; die Währung ist bei jeder Zahl enthalten.
Prüfen Sie drei Dinge:
  1. Welche Uhr. Ein einzelner Store wird in seiner Lokalzeit berichtet. Kontoweite Fragen verwenden UTC, sofern Sie keine Zeitzone nennen.
  2. Welches Datum. Bestellungen werden nach ihrer Fälligkeit (ihrem Slot) aufgelistet, nicht nach der Aufgabe, sofern Sie nicht „placed” oder „created” fragen. Verkaufsstatistiken und Top-Produkte verwenden immer die Aufgabezeit der Bestellung. Rückerstattungen verwenden das Rückerstattungsdatum, sofern Sie nicht nach Bestelldatum fragen.
  3. Welche Bestellungen. Summen schließen abgelehnte und stornierte Bestellungen aus und sind vor Rückerstattungen.
Die Reports-Seiten beschreiben, wie das Dashboard zählt, sodass Sie die beiden vergleichen können.
Eine Frage kann höchstens 90 Tage abdecken. Fragen Sie in zwei Teilen oder bitten Sie um eine monatliche Aufschlüsselung.
Große Bestelllisten melden aus Geschwindigkeitsgründen eine geschätzte Gesamtsumme; die einzelnen Seiten sind exakt. Bestelllisten sind außerdem live, sodass eine Bestellung, die eintrifft, während der Assistent paginiert, die Ergebnisse verschieben kann. Fragen Sie erneut mit einem engeren Zeitraum, wenn Sie eine feste Zahl brauchen.
Events pro Artikel sind in einer Antwort auf 100 begrenzt. Die Zusammenfassung und die Summen sind trotzdem vollständig; nur die einzelnen An/Aus-Events werden gekürzt. Fragen Sie einen kürzeren Zeitraum ab, um sie alle zu sehen.
Preise in der Top-Produkt-Antwort sind aktuelle Menüpreise, zur Referenz. Mengen sind historisch; Preise nicht.

Langsame oder fehlgeschlagene Anfragen

Jede Anfrage hat 30 Sekunden. Lange Zeiträume auf umsatzstarken Stores können das überschreiten — fragen Sie einen kürzeren Zeitraum ab oder einen Store nach dem anderen. Wenn ein Write ins Timeout lief, prüfen Sie das Dashboard, bevor Sie erneut fragen: Der Rabattcode oder Payment Link kann bereits erstellt worden sein.
Anfragen sind pro Benutzer rate-limited. Warten Sie eine Minute und versuchen Sie es erneut. Wenn eine automatisierte Einrichtung das regelmäßig trifft, verteilen Sie ihre Aufrufe.
Das passiert, wenn der Assistent einen Write nach einem Timeout oder einer abgebrochenen Verbindung erneut versucht. Deaktivieren Sie den doppelten Rabattcode oder Payment Link im Dashboard und behalten Sie Write-Freigaben auf „pro Aufruf” statt auf „always allow”.

Immer noch stecken

E-Mail an mcp@storekit.com

Nennen Sie uns den Assistenten, die Frage und die Uhrzeit.

Merchant-MCP-Referenz

Für Entwickler: das Protokoll, die Tools und die Fehlercodes.