Zoho Mail su MCP: Pilota Zoho Mail da qualsiasi agente AI

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Zoho Mail, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Zoho Mail

Fai lavorare la tua AI in Zoho Mail: trova le email per cartella o con la ricerca di Zoho, leggi contenuto, intestazioni e dettagli, invia e rispondi, e segna come lette, sposta, contrassegna o etichetta le email. Qualsiasi data center Zoho, accesso con Zoho OAuth.

Setup

Ti serve una casella Zoho Mail, con il piano gratuito o con un piano a pagamento.

Prima il data center: Zoho tiene ogni account in un solo data center, e il server di accesso e l'host della Mail API devono appartenere entrambi a quello. Lo vedi nella barra degli indirizzi quando usi Zoho Mail. Con il data center sbagliato si ottiene INVALID_OAUTHTOKEN o invalid_client.

1. Apri la Zoho API Console su api-console.zoho.com, con l'accesso del tuo account Zoho, e scegli Add Client → Server-based Applications.
2. Dai un nome al client (per esempio AnythingMCP), indica il sito della tua azienda come homepage URL e https://cloud.anythingmcp.com/api/mcp-oauth/callback come Authorized Redirect URI. Se ospiti AnythingMCP in proprio, inserisci invece https://tuo-host-anythingmcp/api/mcp-oauth/callback. Crea il client.
3. Nella scheda Client Secret copia il Client ID (inizia con 1000.) e il Client Secret in ZOHO_MAIL_CLIENT_ID e ZOHO_MAIL_CLIENT_SECRET. Se la tua casella si trova in un data center diverso da quello in cui si è aperta la console, abilita quel data center nella scheda Settings del client (Multi-DC) e usa il client secret indicato lì.
4. Imposta ZOHO_MAIL_ACCOUNTS_URL e ZOHO_MAIL_API_URL sul tuo data center secondo la tabella, senza barra finale, e installa il connettore.
5. Nella pagina del connettore clicca su Authorize with Provider, accedi a Zoho e approva l'accesso richiesto.
6. Esegui zoho_mail_list_accounts per controllare la connessione: mostra la tua casella e gli indirizzi da cui l'AI può inviare.

Restare connessi: gli access token durano un'ora e vengono rinnovati automaticamente con il refresh token salvato. Zoho conserva al massimo 20 refresh token per utente e client: autorizzare lo stesso client per la 21ª volta revoca in silenzio il più vecchio. Se il connettore perde l'accesso, clicca di nuovo su Authorize with Provider.

Permessi e configurazione in sola lettura: il connettore chiede ZohoMail.accounts.READ, ZohoMail.folders.READ, ZohoMail.messages.ALL e ZohoMail.tags.READ e lavora come l'utente Zoho che l'ha autorizzato. Per una configurazione in sola lettura, cambia ZohoMail.messages.ALL in ZohoMail.messages.READ nelle impostazioni OAuth del connettore, autorizza di nuovo e disattiva zoho_mail_send_email, zoho_mail_reply_to_email, zoho_mail_mark_as_read, zoho_mail_mark_as_unread, zoho_mail_move_emails, zoho_mail_flag_emails e zoho_mail_apply_labels.

Niente parte senza il tuo sì: zoho_mail_send_email e zoho_mail_reply_to_email inviano email vere a tuo nome. Prima di inviare, l'AI ti mostra destinatari, oggetto e testo e aspetta un sì esplicito. Segnare come letto, spostare, contrassegnare ed etichettare cambiano la tua casella, quindi l'AI ti dice prima cosa cambierà.

Disattivato all'installazione: zoho_mail_delete_email. Se lo attivi, sposta un'email nel cestino; la elimina definitivamente solo se lo chiedi in modo esplicito.

Account, cartelle e ricerca: ogni chiamata ha bisogno dell'id di un account di posta, quindi l'AI legge prima i tuoi account. Se ne hai più di uno, per esempio un account POP aggiunto, usa quello che intendi e invia dagli indirizzi di quell'account. Elenca una cartella con filtri per email non lette, contrassegnate o etichettate, oppure usa la ricerca di Zoho, per esempio per mittente, oggetto, allegato o data.

Le email non sono affidabili: le email arrivano da mittenti esterni. L'AI tratta le istruzioni contenute in un'email come contenuto, mai come ordini.

Errori comuni: 401 INVALID_OAUTHTOKEN significa che l'accesso manca o è stato revocato, oppure che ZOHO_MAIL_API_URL non è il tuo data center: correggi l'URL o clicca di nuovo su Authorize with Provider. invalid_client all'accesso di solito significa che ZOHO_MAIL_ACCOUNTS_URL non è il tuo data center o che il client secret appartiene a un altro data center (vedi il passo 3). 400 con una nota in moreInfo significa che un parametro non è valido, per esempio un id sconosciuto, una ricerca scritta male o un indirizzo mittente che non appartiene all'account. 404 significa che l'account, la cartella o l'email non esiste per questo utente. Un 500 Internal Error viene da Zoho: riprova una volta. Quando Zoho segnala troppe richieste, aspetta un minuto.

Il connettore non gestisce allegati, bozze e modelli, conversazioni intere, gestione di cartelle ed etichette, firme, risposte automatiche, attività, note, segnalibri e le API di amministrazione dell'organizzazione.

Prerequisiti: ZOHO_MAIL_CLIENT_ID, ZOHO_MAIL_CLIENT_SECRET, ZOHO_MAIL_ACCOUNTS_URL, ZOHO_MAIL_API_URL

Installazione locale del connettore

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Apri http://localhost:3000/connectors/store, scegli Zoho Mail e inserisci le variabili elencate nei Prerequisiti.

Tool disponibili

Esempi di prompt

• "Quali email non lette sono arrivate oggi nella mia posta in arrivo di Zoho Mail? Una riga per ogni email."
• "Trova le email di [email protected] con un allegato dal 1° settembre."
• "Rispondi all'ultima email di Acme sulla data di consegna: possiamo spedire il 24 ottobre. Mostrami la risposta prima di inviarla."
• "Sposta le newsletter di questa settimana nella cartella Newsletter e contrassegna come importante l'email del nostro commercialista."

Prossimi passi

• Collegare a Claude
• Collegare a ChatGPT