> ## 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. # Risoluzione dei problemi del tuo agente AI > Risolvi i problemi comuni nel collegare Claude, ChatGPT o un altro client MCP a storekit: errori di accesso, non autorizzato, negozio sbagliato e timeout. Lavora sulla sezione che corrisponde a ciò che vedi. Se nessuna si adatta, scrivi a [mcp@storekit.com](mailto: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 > **La pagina di accesso dice 'This connection link is invalid or has expired'** > > Il link di sign-in che il tuo assistente ha aperto è stato già usato o ha impiegato troppo tempo. Torna all'assistente e avvia di nuovo la connessione; non ricaricare la scheda di storekit. > **La pagina di accesso dice 'Couldn't complete the connection'** > > 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](https://t09czsyu90l.typeform.com/to/G6rIJWNv), oppure scrivi a [mcp@storekit.com](mailto:mcp@storekit.com) citando l'email con cui hai effettuato l'accesso. > **Il mio client dice 401 o Unauthorised** > > * Il tuo sign-in è scaduto o è stato cancellato. Usa l'opzione di riconnessione dell'assistente (consulta la tua [guida di collegamento](/docs/it/guides/ai/overview#collega-il-tuo-assistente)). > * Alcuni client richiedono di attivare il connector anche all'interno della chat oltre che aggiungerlo. Verifica il menu strumenti della chat. > **Il mio client non riesce ad aggiungere il server o dice che non supporta questo transport** > > storekit usa MCP Streamable HTTP. Un client che supporta solo stdio o SSE non può collegarsi direttamente; consulta [Collega altri client](/docs/it/guides/ai/connect/other-clients) per le opzioni. ## Le risposte sembrano sbagliate > **Riporta il negozio sbagliato, o ogni negozio** > > 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. > **I totali sono circa cento volte troppo grandi** > > 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. > **I numeri di ieri non corrispondono alla dashboard** > > 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](/docs/it/guides/reports/overview) descrivono come conta la dashboard, così puoi allineare i due. > **Dice che il periodo è troppo lungo** > > Una singola domanda può coprire al massimo 90 giorni. Chiedi in due parti, o chiedi un breakdown mensile. > **Dice che il totale è una stima, o il conteggio è cambiato tra pagine** > > 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. > **Un report di snooze dice che gli eventi sono stati troncati** > > 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 top product mostrano un prezzo che non è quello a cui abbiamo venduto** > > 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 > **È andata in timeout** > > 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. > **Troppe richieste** > > Le richieste sono rate-limited per utente. Aspetta un minuto e riprova. Se un setup automatizzato lo raggiunge regolarmente, distanzia le sue chiamate. > **L'assistente ha creato qualcosa due volte** > > 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](mailto:mcp@storekit.com)** > > Dicci l'assistente, la domanda e l'ora. > **[Riferimento del merchant MCP](/docs/it/developers/mcp/overview)** > > Per gli sviluppatori: il protocollo, gli strumenti e i codici di errore. ## Related topics - [Collega il tuo agente AI](/docs/it/guides/ai/overview.md) - [Risoluzione dei problemi con i webhook](/docs/it/developers/webhooks/troubleshooting.md) - [Risoluzione dei problemi](/docs/it/guides/integrations/pos/comtrex/troubleshooting.md) - [Risoluzione dei problemi Lightspeed](/docs/it/guides/integrations/pos/lightspeed/troubleshooting.md) - [Risoluzione dei problemi Deliverect](/docs/it/guides/integrations/pos/deliverect/troubleshooting.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.