Risoluzione dei problemi
Risoluzione dei problemi MCP
Risolvi i problemi più comuni con il server MCP di Emailit, dall’accesso e dai permessi mancanti ai workspace sbagliati, agli strumenti riservati agli Admin e ai client che caricano troppi strumenti.
Inizia chiedendo all’assistente «A quale workspace Emailit sono collegato?». L’assistente chiama get-current-workspace e ti indica il workspace, il tuo ruolo e l’accesso concesso, cosa che spiega la maggior parte dei problemi seguenti.
La pagina di accesso dice che il client è sconosciuto
La registrazione del client non è più valida. Rimuovi il server Emailit dallo strumento AI e aggiungilo di nuovo, così registra un nuovo client.
Uno strumento dice che gli serve l’accesso completo
La connessione è stata approvata solo con il permesso (scope) sending. I client che supportano l’autorizzazione step-up, come ChatGPT, mostrano di nuovo la schermata di approvazione: approva l’accesso full. Con gli altri client, revoca la connessione in AccountConnected apps, ricollegati e approva l’accesso completo. Con una chiave API, usa una chiave con accesso completo.
Le modifiche avvengono nel workspace sbagliato
Indica il workspace nella richiesta, ad esempio «In Marketing, elenca i domini», oppure chiedi all’assistente di cambiare workspace: «Passa al mio workspace Marketing». Le chiavi API agiscono sempre sul workspace a cui appartengono.
Manca un workspace
La connessione copre solo i workspace che hai consentito. Apri AccountConnected apps, scegli Edit access e aggiungilo, oppure scegli All workspaces. Se sei stato rimosso dal workspace, chiedi a un amministratore di invitarti di nuovo.
Uno strumento dice che serve il ruolo Admin
L’errore admin_role_required significa che in quel workspace hai il ruolo Member e lo strumento gestisce chiavi API o elimina un dominio. Chiedi a un amministratore del workspace di farlo al posto tuo o di cambiare il tuo ruolo.
Il client mostra troppi strumenti o non riesce a caricarli
Alcuni client limitano il numero di strumenti. Carica solo quelli che ti servono con ?toolsets= nell’URL del server o con l’header X-MCP-Toolsets, ad esempio https://api.emailit.com/mcp?toolsets=emails,domains. Vedi Toolset e modalità di sola lettura.
Un’email viene rifiutata
Il mittente deve usare un dominio di invio verificato. Chiedi all’assistente di controllare il dominio con get-domain, pubblicare i record mancanti ed eseguire verify-domain. Finché il workspace non ha l’accesso alla produzione, puoi inviare solo agli indirizzi email degli account dei membri del workspace.
Il nuovo tentativo non riesce
Si possono ritentare solo le email rimbalzate, non riuscite, soppresse o trattenute, entro 30 giorni e finché il loro contenuto è ancora conservato. Vedi Ritenta e inoltra le email.
Il client mostra «Method not allowed»
Il server è stateless e accetta solo richieste POST. Aggiorna il client a una versione che supporti il trasporto Streamable HTTP, oppure usa il server locale via stdio.
Il client continua a chiederti di accedere
Il token di aggiornamento è scaduto dopo 60 giorni di inutilizzo, è stato riutilizzato, oppure la connessione è stata revocata. Accedi di nuovo dal client. Se succede ripetutamente, assicurati che la connessione sia usata da una sola copia del client alla volta.
Serve ancora aiuto?
Chiedi su Discord o scrivi a support@emailit.com indicando il nome del client, lo strumento che non ha funzionato e il testo dell’errore.