Verbinden
De aanmeldpagina zegt 'This connection link is invalid or has expired'
De aanmeldpagina zegt 'This connection link is invalid or has expired'
De aanmeldlink die je assistent opende, is al gebruikt of duurde te lang. Ga terug naar de assistent en start de verbinding opnieuw; laad het storekit-tabblad niet opnieuw.
De aanmeldpagina zegt 'Couldn't complete the connection'
De aanmeldpagina zegt 'Couldn't complete the connection'
storekit kon de overdracht naar je assistent niet voltooien. Probeer het nog eens vanuit de assistent. Mislukt het een tweede keer, dan is je account waarschijnlijk nog niet ingeschakeld voor de bèta: vraag toegang aan, of mail mcp@storekit.com onder vermelding van het e-mailadres waarmee je bent aangemeld.
Mijn client kan de server niet toevoegen of zegt dat hij dit transport niet ondersteunt
Mijn client kan de server niet toevoegen of zegt dat hij dit transport niet ondersteunt
storekit gebruikt MCP Streamable HTTP. Een client die alleen stdio of SSE ondersteunt, kan niet rechtstreeks verbinding maken; zie Verbind andere clients voor de opties.
Antwoorden zien er verkeerd uit
Het rapporteert over de verkeerde store, of over elke store
Het rapporteert over de verkeerde store, of over elke store
Noem de store in je vraag. Doe je dat niet, dan bestrijken orderlijsten het hele account en worden totalen daarover opgeteld. Als het account stores in verschillende valuta heeft, worden account-brede totalen geweigerd en vraagt de assistent je er een te kiezen.
Totalen zijn ongeveer honderd keer te groot
Totalen zijn ongeveer honderd keer te groot
storekit geeft geld terug in minor units (pence, cents) en de assistent heeft het ruwe getal getoond. Zeg tegen hem “amounts are in pence, show them in pounds”. Dit is een presentatieslip van de assistent, geen datafout; de valuta zit bij elk cijfer.
De cijfers van gisteren komen niet overeen met het dashboard
De cijfers van gisteren komen niet overeen met het dashboard
Check drie dingen:
- Welke klok. Eén store wordt gerapporteerd in zijn lokale tijd. Account-brede vragen gebruiken UTC tenzij je een tijdzone noemt.
- Welke datum. Bestellingen worden gelijst op wanneer ze verwacht worden (hun slot), niet wanneer ze zijn geplaatst, tenzij je om “placed” of “created” vraagt. Verkoopstatistieken en top producten gebruiken altijd het moment waarop de bestelling werd geplaatst. Refunds gebruiken de refund-datum tenzij je op orderdatum vraagt.
- Welke bestellingen. Totalen sluiten geweigerde en geannuleerde bestellingen uit en zijn bruto van refunds.
Het zegt dat de periode te lang is
Het zegt dat de periode te lang is
Eén vraag kan hoogstens 90 dagen bestrijken. Vraag in twee delen, of vraag om een maandelijkse uitsplitsing.
Het zegt dat het totaal een schatting is, of het aantal veranderde tussen pagina's
Het zegt dat het totaal een schatting is, of het aantal veranderde tussen pagina's
Grote orderlijsten rapporteren een geschat totaal voor snelheid; de individuele pagina’s zijn exact. Orderlijsten zijn ook live, dus een bestelling die binnenkomt terwijl de assistent aan het pagineren is, kan de resultaten verschuiven. Vraag opnieuw met een smallere periode als je een vast getal nodig hebt.
Een snooze-rapport zegt dat events zijn afgekapt
Een snooze-rapport zegt dat events zijn afgekapt
Events per item zijn in één antwoord begrensd op 100. De samenvatting en totalen zijn nog steeds volledig; alleen de individuele aan/uit-events worden geknipt. Vraag om een kortere periode om ze allemaal te zien.
Top producten tonen een prijs die niet is waarvoor we verkochten
Top producten tonen een prijs die niet is waarvoor we verkochten
Prijzen in het top-producten-antwoord zijn de huidige menuprijzen, ter referentie. Hoeveelheden zijn historisch; prijzen niet.
Trage of falende verzoeken
Het gaf een timeout
Het gaf een timeout
Elk verzoek heeft 30 seconden. Lange periodes op drukke stores kunnen dat overschrijden: vraag om een kortere periode of één store tegelijk. Als een write een timeout gaf, check dan het dashboard voordat je opnieuw vraagt: de kortingscode of payment link is mogelijk al aangemaakt.
Te veel verzoeken
Te veel verzoeken
Verzoeken zijn rate-limited per gebruiker. Wacht een minuut en probeer het opnieuw. Als een geautomatiseerde opstelling dit regelmatig raakt, spreid dan de calls.
De assistent heeft iets tweemaal gemaakt
De assistent heeft iets tweemaal gemaakt
Dit gebeurt wanneer de assistent een write opnieuw probeert na een timeout of een verbroken verbinding. Deactiveer de dubbele kortingscode of payment link in het dashboard, en houd write-goedkeuringen op per call in plaats van “always allow”.
Nog steeds vast
Mail mcp@storekit.com
Vertel ons de assistent, de vraag en het tijdstip.
Merchant MCP-referentie
Voor ontwikkelaars: het protocol, de tools en errorcodes.