> ## Documentation Index
> Fetch the complete documentation index at: https://storekit.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Fehlerbehebung für Ihren KI-Agenten

> Häufige Probleme beim Verbinden von Claude, ChatGPT oder einem MCP-Client mit storekit beheben: Anmeldefehler, Unauthorized, falscher Store und Timeouts.

Arbeiten Sie den Abschnitt durch, der zu dem passt, was Sie sehen. Wenn keiner passt, schreiben Sie an [mcp@storekit.com](mailto: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

> **Die Anmeldeseite sagt 'This connection link is invalid or has expired'**
>
> Der Anmelde-Link, den Ihr Assistent geöffnet hat, wurde bereits verwendet oder hat zu lange gebraucht. Gehen Sie zurück zum Assistenten und starten Sie die Verbindung erneut; laden Sie den storekit-Tab nicht neu.

> **Die Anmeldeseite sagt 'Couldn't complete the connection'**
>
> 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](https://t09czsyu90l.typeform.com/to/G6rIJWNv), oder E-Mail an [mcp@storekit.com](mailto:mcp@storekit.com) mit der E-Mail, mit der Sie sich angemeldet haben.

> **Mein Client sagt 401 oder Unauthorized**
>
> * Ihre Anmeldung ist abgelaufen oder wurde gelöscht. Nutzen Sie die Reconnect-Option des Assistenten (siehe Ihre [Verbindungsanleitung](/docs/de/guides/ai/overview#ihren-assistenten-verbinden)).
> * Manche Clients erfordern, dass Sie den Konnektor auch innerhalb des Chats einschalten, nicht nur hinzufügen. Prüfen Sie das Tools-Menü des Chats.

> **Mein Client kann den Server nicht hinzufügen oder sagt, dass dieser Transport nicht unterstützt wird**
>
> storekit verwendet MCP Streamable HTTP. Ein Client, der nur stdio oder SSE unterstützt, kann sich nicht direkt verbinden; siehe [Andere Clients verbinden](/docs/de/guides/ai/connect/other-clients) für die Optionen.

## Antworten sehen falsch aus

> **Er berichtet über den falschen Store oder über jeden Store**
>
> 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.

> **Summen sind ungefähr hundertmal zu groß**
>
> 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.

> **Gestrige Zahlen passen nicht zum Dashboard**
>
> 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](/docs/de/guides/reports/overview)-Seiten beschreiben, wie das Dashboard zählt, sodass Sie die beiden vergleichen können.

> **Er sagt, der Zeitraum sei zu lang**
>
> Eine Frage kann höchstens 90 Tage abdecken. Fragen Sie in zwei Teilen oder bitten Sie um eine monatliche Aufschlüsselung.

> **Er sagt, die Summe sei eine Schätzung, oder die Zählung ändert sich zwischen Seiten**
>
> 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.

> **Ein Snooze-Report sagt, dass Events abgeschnitten wurden**
>
> 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.

> **Top-Produkte zeigen einen Preis, zu dem wir nicht verkauft haben**
>
> Preise in der Top-Produkt-Antwort sind aktuelle Menüpreise, zur Referenz. Mengen sind historisch; Preise nicht.

## Langsame oder fehlgeschlagene Anfragen

> **Es kam zum Timeout**
>
> 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.

> **Zu viele Anfragen**
>
> 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.

> **Der Assistent hat etwas doppelt erstellt**
>
> 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](mailto:mcp@storekit.com)**
>
> Nennen Sie uns den Assistenten, die Frage und die Uhrzeit.

> **[Merchant-MCP-Referenz](/docs/de/developers/mcp/overview)**
>
> Für Entwickler: das Protokoll, die Tools und die Fehlercodes.


## Related topics

- [Ihren KI-Agenten verbinden](/docs/de/guides/ai/overview.md)
- [Integrationen – Übersicht](/docs/de/guides/integrations/overview.md)
- [Merchant-MCP-Übersicht](/docs/de/developers/mcp/overview.md)
- [Einführung für Entwickler](/docs/de/developers/introduction.md)
- [API & Webhooks](/docs/de/guides/integrations/api-webhooks.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.