# 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 **Account → Connected apps**, ricollegati e approva l’accesso completo. Con una chiave API, usa una [chiave con accesso completo](/it/docs/developers/api-keys/).

## 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 **Account → Connected 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](/it/docs/workspaces/members-and-roles/).

## 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](/it/docs/mcp/toolsets/).

## Un’email viene rifiutata

Il mittente deve usare un [dominio di invio verificato](/it/docs/domains/verification/). 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](/it/docs/workspaces/production-access/), 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](/it/docs/email-api/retry-and-forward/).

## 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](/it/docs/mcp/local-server/) 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](https://discord.emailit.com) o scrivi a [support@emailit.com](mailto:support@emailit.com) indicando il nome del client, lo strumento che non ha funzionato e il testo dell’errore.

---
Fonte: https://emailit.com/it/docs/mcp/troubleshooting/