In breve
Se un assistente AI non riesce a leggere i dati di Dashboardly, le cause possono essere una connessione OAuth revocata, una chiave API mancante o revocata, l'ambito negozi errato, una versione dell'assistente che non supporta il Model Context Protocol o un negozio scollegato su TikTok. Di seguito trovi i controlli per ciascun caso.
Questa guida tratta sia l'accesso con l'account Dashboardly (OAuth) sia le connessioni con chiave API. Se non hai ancora collegato un assistente, inizia da «Collegare gli assistenti AI a Dashboardly».
«Non vedo la scheda API Keys nelle impostazioni»
Le chiavi API MCP sono incluse in Brand Growing, Pro ed Enterprise e in tutti i piani Agency. Brand Free e Starter non includono questa funzione. L'accesso Developer REST è una capacità separata: l'idoneità MCP non lo concede.
Cosa verificare
- Controlla il piano attuale in Settings > Subscriptions.
- Se usi Brand Free o Starter, confronta i piani idonei prima di decidere se fare un upgrade.
- Dopo un cambio di piano, ricarica Settings e controlla API Keys.
Se hai un piano Brand o Agency idoneo ma la scheda non compare, esci e accedi di nuovo per aggiornare la sessione. Se continua a mancare, contatta l'assistenza.
Compare «Failed to load API keys»
Il browser ha raggiunto Dashboardly, ma non è riuscito a caricare l'elenco delle chiavi.
Cosa verificare
- Ricarica la pagina. Un problema temporaneo di rete o un rilascio recente può causare l'errore; ricaricare può risolverlo.
- Esci e accedi di nuovo. La sessione potrebbe essere scaduta. Poi apri di nuovo Settings > API Keys.
- Controlla la connessione TikTok Shop. Alcuni tipi di account richiedono un negozio attivo. In Settings > Shops, verifica che almeno un negozio risulti «Active» o «Connected».
- Prova un altro browser o una finestra in incognito. Le estensioni possono interferire con le richieste sicure.
Se l'errore persiste in due browser dopo un nuovo accesso, invia all'assistenza l'errore e uno screenshot. Prima di condividere immagini o estratti della console, rimuovi chiavi API, header di autorizzazione, cookie, token e dati dei clienti.
«L'assistente AI dice che non riesce a collegarsi a Dashboardly»
Le cause più comuni sono:
L'URL dell'endpoint è errato
Usa l'endpoint del tuo tipo di connessione: MCP non è l'API Developer REST. ChatGPT e Claude Desktop usano l'accesso all'account Dashboardly (OAuth), senza una chiave API segreta. Claude Code e Cursor possono usare l'endpoint MCP HTTP remoto con una chiave Bearer.
Cosa verificare
Leggi le istruzioni pubbliche: non serve creare una chiave temporanea per trovare l'URL. Per MCP usa https://mcp.dashboardly.io/mcp, incluso /mcp. Developer REST usa https://api.dashboardly.io/api/developer/v1 dal tuo server, non dal browser o da un'app mobile. Non scambiare i due endpoint.
La versione dell'assistente non supporta MCP
Verifica che l'assistente supporti la connessione MCP desiderata e che sia abilitata per il tuo account o workspace. Aggiornare l'app non abilita da solo un'integrazione disattivata.
Cosa verificare
Aggiorna l'assistente AI all'ultima versione:
- Claude Desktop: Controlla gli aggiornamenti e segui le istruzioni OAuth di Dashboardly.
- Claude sul web: Controlla le integrazioni attualmente disponibili per account o workspace.
- ChatGPT: Le connessioni personalizzate dipendono dalle impostazioni di account e workspace; consulta la guida ufficiale.
- Cursor: Aggiorna l'app e segui le istruzioni MCP.
Dopo l'aggiornamento, riavvia l'app e riprova la connessione.
«Authentication failed» o «Invalid API key»
L'assistente raggiunge Dashboardly, ma la chiave viene rifiutata.
Cosa verificare
- Controlla che la chiave sia attiva. In Settings > API Keys, una chiave revocata non è riutilizzabile: creane una sostitutiva se necessario.
- Controlla la scadenza. Una chiave scaduta non può autenticarsi; sostituiscila se necessario.
- Rimuovi gli spazi involontari. Non inserire spazi o ritorni a capo prima o dopo la chiave.
- Copia il segreto completo. Inizia con
dk_live_. Dashboardly lo mostra solo alla creazione o rotazione. Se lo perdi, usa l'azione di rotazione disponibile o crea una sostituzione, poi aggiorna l'assistente. - Controlla l'account. La chiave deve appartenere all'account Dashboardly dei dati che vuoi leggere.
Se una nuova chiave viene rifiutata subito, controlla endpoint, metodo di autenticazione, scadenza e account. Se il problema continua, contatta l'assistenza; non creare ripetutamente altre chiavi soltanto per fare diagnosi.
«L'assistente non restituisce dati» o «Non trovo ordini»
La connessione funziona, ma l'assistente non trova dati per la domanda.
Cosa verificare
- Controlla negozio e tipo di accesso. Verifica Shop in API Keys e sostituisci una chiave con ambito errato con una per il negozio desiderato. Solo proprietari/amministratori idonei possono scegliere All shops per MCP. Le chiavi Collaborator e Developer REST sono limitate a un negozio. Le nuove chiavi MCP usano Reporting & reconciliation per impostazione predefinita, senza contatti, indirizzi o tracking degli acquirenti. Full orders & fulfilment richiede la scelta esplicita di un proprietario/amministratore idoneo.
- Controlla il periodo. Un negozio poco attivo può non avere ordini la settimana scorsa; prova questo mese o quest'anno.
- Controlla lo stesso periodo in Dashboardly. Se manca anche lì la metrica, verifica connessione e stato dell'importazione; vedi «Perché i dati sono in ritardo?».
- Controlla l'attività pertinente. Le metriche di annunci o dirette richiedono dati corrispondenti. Senza annunci, ROAS zero o assente non implica un errore di connessione.
«L'assistente vede un solo negozio, ma ne ho diversi»
La soluzione dipende dall'accesso con account Dashboardly oppure tramite chiave API.
Cosa verificare
Per una connessione OAuth di ChatGPT o Claude Desktop:
- Apri Settings > API Keys e cerca l'assistente in Connected Apps.
- Se compare Current shop only, ricollega solo se devi cambiare l'ambito negozi. Revocare rimuove l'accesso attuale.
- Nel nuovo consenso scegli Selected shops only per negozi specifici, oppure All shops I can access soltanto se vuoi autorizzare tutti i negozi accessibili.
Una connessione può così usare i negozi autorizzati. Dashboardly rimuove automaticamente quelli scollegati o non più accessibili. Le connessioni OAuth create prima della selezione multi-negozio mantengono l'ambito originario di un solo negozio finché non le revochi e ricolleghi.
Per una chiave API MCP, le opzioni dipendono dal ruolo dell'account:
- Una chiave per negozio. Usa nomi come «Claude Code — US Shop» o «Claude Code — UK Shop» e scegli la chiave desiderata nell'assistente.
- Una chiave MCP per tutti i negozi. I proprietari/amministratori idonei possono scegliere esplicitamente All shops in Shop per domande trasversali. Le chiavi Collaborator restano singolo-negozio; Developer REST richiede anch'esso un negozio selezionato. Una chiave MCP per tutti i negozi non concede Developer REST né permessi di scrittura facoltativi.
Non puoi modificare il negozio associato dopo la creazione. Per passare a un altro negozio, revoca la chiave e creane una nuova.
«Alcune domande richiedono molto tempo»
Il tempo dipende da assistente, rete, periodo e complessità della richiesta. Non è garantito un tempo di risposta per tutte le domande. Possono richiedere più tempo:
- Profitti e perdite su periodi lunghi. Il dettaglio di un anno può richiedere più elaborazione.
- Prodotti migliori di più negozi. Confrontare vari negozi aggiunge lavoro.
- Valore del cliente nel tempo. L'analisi degli acquisti ripetuti può richiedere più dati.
Se le domande semplici superano regolarmente 30 secondi, comunica all'assistenza l'orario della richiesta lenta per consentire il controllo dei log.
«Ho revocato una chiave per errore»
Le chiavi revocate non sono ripristinabili. Non esiste un annullamento perché il segreto viene invalidato permanentemente in Dashboardly.
Cosa verificare
- In Settings > API Keys, clicca New API key.
- Scegli negozio, scadenza e accesso consentito. Le nuove chiavi MCP partono dall'accesso di reporting: non presumere che una sostituzione erediti permessi facoltativi.
- Copia il nuovo segreto quando viene mostrato e aggiorna l'assistente.
La sostituzione ha un proprio segreto e una propria cronologia d'uso. Verifica negozio e permessi prima dell'utilizzo: il nome uguale non rende l'accesso identico alla chiave revocata.
«Vedo una connessione sconosciuta in Connected Apps»
Connected Apps, in fondo alla pagina API Keys, elenca gli assistenti che hanno effettuato l'accesso con l'account Dashboardly. Se non riconosci una connessione:
Cosa verificare
- Clicca Revoke accanto alla connessione. I token di accesso e refresh vengono subito invalidati, impedendone l'uso futuro.
- Cambia la password Dashboardly se sospetti che l'account sia compromesso.
Se riconosci l'assistente ma serve un altro ambito negozi, revoca la connessione e ricollega dall'assistente.
Quando contattare l'assistenza
Contatta l'assistenza se:
- Hai seguito i controlli senza riuscire a collegarti.
- Una chiave mostra attività che non riconosci.
- API Keys si comporta diversamente dalla guida, ad esempio una chiave revocata sembra ancora funzionare.
- Un piano Brand o Agency idoneo non mostra API Keys anche dopo un nuovo accesso.
Indica nome della chiave, nome dell'assistente, errore esatto e screenshot pertinente, non il segreto. Oscura token, header di autorizzazione, cookie e dati dei clienti. Per richieste lente, aggiungi l'orario.
Non condividere mai la chiave API completa nei messaggi all'assistenza. Trattala come una password.