Skip to main content
Für wen das ist: ein Entwickler, der einen KI-Client oder Agenten an das eigene storekit-Konto eines Merchants anschließt. Für die kundenseitigen Oberflächen — ein Agent, der ein öffentliches Menü liest und einen Warenkorb baut — siehe Bestell-Agenten. Für die nicht-technischen Einrichtungsanleitungen siehe Ihren KI-Agenten verbinden.
Beta-Funktion - Das Merchant MCP befindet sich in der Beta, und Konten werden von einer Warteliste aus aktiviert. Zugriff anfragen, oder eine E-Mail an mcp@storekit.com.

​
Endpoint

Jede Anfrage erzeugt einen frischen MCP-Server, gebunden an das authentifizierte Konto, verarbeitet eine Nachricht und schließt. Zwischen Aufrufen wird nichts gespeichert; eine Konversation trägt Filial-IDs und Bestell-IDs selbst.

​
Tools

Achtzehn Tools, alle auf das authentifizierte Konto beschränkt. Sechzehn sind read-only (readOnlyHint: true); create-discount-code und create-payment-link sind Writes. Die vollständige Input-Referenz steht auf Tools. Es gibt keine Tools, die Bestellungen, Menüs, Filialen, Benutzer oder Einstellungen verändern.

​
Vertrag im Kurzüberblick

  • Jeder Erfolg ist ein { data, meta }-Envelope, zurückgegeben sowohl als structuredContent als auch als JSON im ersten Text-Block. Jedes Tool veröffentlicht ein outputSchema dafür. Siehe Response-Format.
  • Fehler sind ausschließlich als Text vorliegende isError: true-Ergebnisse, die einen { error }-Envelope mit einem stabilen code tragen. Siehe Fehler.
  • Geld ist in Minor Units mit explizitem Währungscode. Datumsangaben sind striktes ISO. Filialbezogene Anfragen verwenden standardmäßig die Zeitzone der Filiale, kontoweite Anfragen UTC.
  • Paginierung beginnt bei Seite 1, ist auf 100 Zeilen begrenzt und meldet hasMore/nextPage über einen Ein-Zeilen-Lookahead statt über Gesamtsummen.

​
Limits

​
Referenz

Authentifizierung

OAuth-Discovery und Anmeldung, wie das Konto gewählt wird.

Tools

Jedes Tool mit seinen Inputs, Defaults und Datumsbasis.

Response-Format

Der Envelope, Paginierung, Datumsangaben, Zeitzonen und Geld.

Fehler

Fehlercodes, Retry-Regeln und die Formen, die Clients behandeln müssen.