Come collegare Mailtrap a Gemini via MCP

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

Mailtrap + Gemini

Lavora con un account Mailtrap da qualsiasi agente AI: invia email transazionali, bulk e in batch, testale in Email Sandbox con report di spam e HTML, gestisci domini di invio, soppressioni e modelli, segui ogni messaggio inviato nei log, leggi le statistiche di invio e gestisci contatti, liste e campagne di Email Marketing. Un solo token API; le eliminazioni irreversibili sono disattivate all'installazione.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

MAILTRAP_API_TOKEN

Step 1 — Ottieni le credenziali

La configurazione richiede circa 3 minuti. Ti serve un account Mailtrap.

1. In Mailtrap apri Settings, API Tokens (https://mailtrap.io/api-tokens) e crea un token. Dagli accesso ai domini di invio (per invio, statistiche, log e soppressioni), alle sandbox o ai progetti (per Email Sandbox) e, se lo usi, a Email Marketing. Per modificare le soppressioni serve l'accesso admin.
2. Incollalo in MAILTRAP_API_TOKEN. Viene inviato come Authorization: Bearer <token> e non scade finché non lo reimposti.
3. Installa il connettore ed esegui mailtrap_list_accounts: mostra l'account con il tuo livello di accesso (1000 owner, 100 admin, 10 viewer) e conferma il token. Un token appartiene a un solo account e ogni chiamata lavora su quell'account, quindi non serve un id account.
4. L'invio reale richiede un dominio di invio verificato (mailtrap_list_sending_domains); Email Sandbox funziona anche senza.

Mailtrap serve le sue aree da host diversi e il connettore sceglie quello giusto per ogni strumento: https://mailtrap.io per gestione e report, https://send.api.mailtrap.io per l'invio transazionale, https://bulk.api.mailtrap.io per lo stream Bulk e https://sandbox.api.mailtrap.io per gli invii di prova in una sandbox.

Invio: mailtrap_send_email invia un'email transazionale fino a 1000 destinatari, mailtrap_send_batch_emails fino a 500 email diverse in una chiamata (al massimo 50 MB). Le email marketing e gli altri invii massivi passano dallo stream Bulk con mailtrap_send_bulk_email e mailtrap_send_bulk_batch_emails, che tiene il traffico promozionale separato da quello transazionale. Il contenuto è text, html o entrambi, oppure un modello salvato: template_uuid (l'uuid di mailtrap_list_templates, non l'id numerico) con template_variables, senza subject, text, html e category. from_email deve stare su un dominio di invio verificato; to, cc e bcc sono liste di {"email", "name"}; gli allegati vanno in Base64 in content. Ogni invio arriva in caselle reali, quindi l'AI ti mostra destinatari, mittente, oggetto e contenuto e aspetta il tuo sì. Un invio restituisce message_ids, uno per destinatario. Le chiamate batch rispondono 200 anche quando singoli messaggi falliscono: l'AI controlla success ed errors di ogni voce in responses.

Email Sandbox: mailtrap_send_sandbox_email invia un'email di prova che viene catturata in una sandbox e mai consegnata, il modo sicuro per provare un modello o un contenuto nuovo. Poi l'AI legge i messaggi catturati (mailtrap_list_sandbox_messages, mailtrap_get_sandbox_message), il corpo come testo, HTML di anteprima, sorgente HTML o MIME grezzo, gli header, gli allegati, il report SpamAssassin con punteggio e regole scattate e il controllo HTML che indica quali elementi e proprietà CSS non sono supportati da quali client email. Elenca anche progetti e sandbox e crea sandbox; le credenziali SMTP non compaiono in nessuna risposta.

Domini e recapito: elenca e legge i domini di invio con i record DNS da pubblicare (SPF, DKIM, DMARC, return path) e la loro verifica, aggiunge un dominio e manda per email le istruzioni DNS a chi gestisce il DNS. Gli indirizzi soppressi (hard bounce, disiscrizione, segnalazione di spam, importazione manuale) sono elencati con il messaggio che li ha causati; mailtrap_create_suppression blocca gli invii a un indirizzo. Per una singola email, mailtrap_list_email_logs filtra per destinatario, stato, eventi, categoria e ora di invio, e mailtrap_get_email_log mostra gli eventi di consegna, apertura, clic e bounce con la risposta del provider. mailtrap_get_sending_stats dà i totali di un periodo, mailtrap_get_sending_stats_grouped li divide per dominio, categoria, provider della casella o giorno, e mailtrap_get_billing_usage mostra i consumi rispetto al piano.

Modelli: elenca, legge, crea e aggiorna i modelli. Le variabili usano Handlebars, per esempio {{user_name}}; le email inviate dopo una modifica usano la nuova versione.

Email Marketing: contatti con stato, liste e campi (creazione, lettura e modifica per id o email; eventi personalizzati come purchase per automazioni e segmenti; importazioni fino a 50.000 contatti abbinati per email, seguite con mailtrap_get_contact_import), liste di contatti e campi dei contatti (i merge tag usati come chiavi in fields). Campagne: mailtrap_create_campaign crea sempre una bozza, mailtrap_update_campaign modifica una bozza, mailtrap_schedule_campaign fissa un orario al massimo un mese avanti, mailtrap_start_campaign invia subito, mailtrap_cancel_campaign riporta a bozza una campagna pianificata e mailtrap_get_campaign_stats mostra i risultati. Pianificare e avviare scrivono a tutto il pubblico: l'AI conferma prima con te campagna, pubblico e orario. Aggiungi solo contatti che hanno accettato di ricevere email, e per smettere di scrivere a qualcuno disiscrivilo (unsubscribed: true) invece di eliminarlo.

Disattivati all'installazione: mailtrap_delete_suppression (l'indirizzo torna a ricevere email), mailtrap_clean_sandbox (elimina tutti i messaggi di una sandbox) e mailtrap_delete_contact. Sono irreversibili, quindi un admin del workspace li attiva quando servono al team.

Formati dei dati: gli id di domini, sandbox, messaggi, modelli, liste e campagne sono interi; contatti, soppressioni e messaggi dei log usano UUID. Gli orari sono ISO 8601 in UTC. I tassi delle statistiche sono frazioni (0.25 = 25%) e le date delle statistiche sono YYYY-MM-DD.

Paginazione: i contatti passano pagination.next_token come token finché è null; le campagne usano token come numero di pagina preso da pagination.next_token. I log passano next_page_cursor come search_after. Le soppressioni arrivano 1000 per pagina, con l'id dell'ultimo elemento come last_id. I messaggi della sandbox arrivano 30 per pagina, con page o l'id dell'ultimo messaggio come last_id.

Limiti: 150 richieste ogni 10 secondi per token; Contatti 200 al minuto, Statistiche e Soppressioni 10 al minuto, elenco dei log 60 al minuto per account.

Errori comuni: 401 Incorrect API token indica un token errato o senza accesso a quel dominio o sandbox. 403 è un permesso mancante: modifica il token in Settings, API Tokens. 404 è un id sconosciuto. 422 è un input non valido con il motivo in errors, per esempio un mittente fuori da un dominio verificato o una campagna che non è più una bozza. 429 è il limite di frequenza: aspetta e riprova.

Il connettore non elimina domini di invio, sandbox, modelli o campagne e non restituisce le credenziali SMTP delle sandbox.

Step 2 — Installa l'adapter

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

Step 3 — Aggiungi il connettore in Gemini

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di Mailtrap.

Tool disponibili

Esempi di prompt

• "La conferma d'ordine a [email protected] è stata consegnata stamattina? Mostrami i suoi eventi."
• "Manda questo nuovo modello di benvenuto nella nostra sandbox di test e dimmi il punteggio spam e quali client email hanno problemi con l'HTML."
• "Quali sono stati la settimana scorsa i nostri tassi di consegna, bounce e spam, divisi per provider della casella?"
• "Quali record DNS del nostro dominio di invio non sono ancora verificati?"
• "Crea una bozza di campagna per la lista Clienti con il modello Newsletter novembre e mostrami il pubblico prima di pianificarla."

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Meta Muse
• Collegare a Microsoft Copilot