Skip to main content
Lavora sulla sezione che corrisponde a ciò che vedi. Se nessuna si adatta, scrivi a mcp@storekit.com con il nome del tuo assistente, la domanda che hai fatto e l’ora in cui l’hai fatta: ogni richiesta porta un ID che possiamo cercare.

Collegamento

storekit non è riuscito a completare il passaggio al tuo assistente. Riprova dall’assistente. Se fallisce una seconda volta, il tuo account probabilmente non è ancora abilitato per la beta: richiedi l’accesso, oppure scrivi a mcp@storekit.com citando l’email con cui hai effettuato l’accesso.
  • Il tuo sign-in è scaduto o è stato cancellato. Usa l’opzione di riconnessione dell’assistente (consulta la tua guida di collegamento).
  • Alcuni client richiedono di attivare il connector anche all’interno della chat oltre che aggiungerlo. Verifica il menu strumenti della chat.
storekit usa MCP Streamable HTTP. Un client che supporta solo stdio o SSE non può collegarsi direttamente; consulta Collega altri client per le opzioni.

Le risposte sembrano sbagliate

Nomina il negozio nella tua domanda. Quando non lo fai, gli elenchi di ordini coprono l’intero account e i totali vengono sommati su di esso. Se l’account ha negozi in valute diverse, i totali a livello di account vengono rifiutati e l’assistente ti chiede di sceglierne uno.
storekit restituisce il denaro in unità minori (pence, cent) e l’assistente ha mostrato il numero grezzo. Digli “gli importi sono in pence, mostrali in sterline”. Questo è un errore di presentazione dell’assistente, non un errore di dati; la valuta è inclusa con ogni cifra.
Verifica tre cose:
  1. Quale orologio. Un singolo negozio viene riportato nel suo orario locale. Le domande a livello di account usano UTC a meno che tu non nomini un fuso orario.
  2. Quale data. Gli ordini vengono elencati per quando sono dovuti (il loro slot), non per quando sono stati effettuati, a meno che tu non chieda “placed” o “created”. Le statistiche di vendita e i top product usano sempre quando è stato effettuato l’ordine. I rimborsi usano la data del rimborso a meno che tu non chieda per data dell’ordine.
  3. Quali ordini. I totali escludono gli ordini rifiutati e cancellati e sono al lordo dei rimborsi.
Le pagine dei Report descrivono come conta la dashboard, così puoi allineare i due.
Una singola domanda può coprire al massimo 90 giorni. Chiedi in due parti, o chiedi un breakdown mensile.
Le grandi liste di ordini riportano un totale stimato per velocità; le singole pagine sono esatte. Gli elenchi di ordini sono anche live, quindi un ordine che arriva mentre l’assistente sta paginando può spostare i risultati. Chiedi di nuovo con un periodo più stretto se ti serve un conteggio preciso.
Gli eventi per articolo sono limitati a 100 in una risposta. Il riepilogo e i totali sono comunque completi; solo i singoli eventi on/off vengono tagliati. Chiedi un periodo più breve per vederli tutti.
I prezzi nella risposta sui top product sono i prezzi correnti del menu, per riferimento. Le quantità sono storiche; i prezzi no.

Richieste lente o fallite

Ogni richiesta ha 30 secondi. Periodi lunghi su negozi affollati possono superarli: chiedi un periodo più breve o un negozio alla volta. Se una scrittura è andata in timeout, verifica la dashboard prima di richiedere di nuovo: il codice sconto o il payment link potrebbero essere già stati creati.
Le richieste sono rate-limited per utente. Aspetta un minuto e riprova. Se un setup automatizzato lo raggiunge regolarmente, distanzia le sue chiamate.
Questo accade quando l’assistente riprova una scrittura dopo un timeout o una connessione interrotta. Disattiva il codice sconto o il payment link duplicato nella dashboard, e mantieni le approvazioni delle scritture impostate su per singola chiamata anziché su “always allow”.

Ancora bloccato

Scrivi a mcp@storekit.com

Dicci l’assistente, la domanda e l’ora.

Riferimento del merchant MCP

Per gli sviluppatori: il protocollo, gli strumenti e i codici di errore.