Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi Mailtrap con un clic, poi punta il tuo client AI (Claude, ChatGPT, Copilot o Cursor) all'endpoint MCP generato. Niente Docker, niente git clone, nessuna esperienza di sviluppo richiesta.
In breve
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.
Prova a chiedere
Prompt di esempio per Mailtrap
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 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 + ChatGPT
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.
- 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.
- Incollalo in
MAILTRAP_API_TOKEN. Viene inviato comeAuthorization: Bearer <token>e non scade finché non lo reimposti. - 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. - 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 ChatGPT
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 mostraYOUR_SERVER_ID.
ChatGPT aggiunge i server MCP come plugin dalla pagina Plugins, sul web e nei piani a pagamento. La modalità sviluppatore non serve più. In un workspace Business possono farlo solo admin e owner; in Enterprise ed Edu un amministratore può concedere il permesso Create plugins with MCPs.
- Vai su chatgpt.com/plugins, clicca + e poi Add custom MCP server.
- Inserisci un nome, ad esempio Name:
Mailtrap. - In Connection inserisci come Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDe lascia Authentication su OAuth. - Seleziona I understand and want to continue, poi Create as a plugin. Quando ChatGPT lo chiede, accedi ad AnythingMCP e consenti l'accesso.
- Installa il nuovo plugin dai tuoi plugin personali, poi digita @ in una chat e selezionalo.
Tool disponibili
| Tool | What it does |
|---|---|
mailtrap_list_accounts | Mailtrap accounts the API token can reach, with id, name and access_levels (1000 owner, 100 admin, 10 viewer) |
mailtrap_get_billing_usage | Usage of the current billing cycle: plan names and sent or stored message counts against their limits for Email Sending, Email Sandbox and… |
mailtrap_send_email | Send one transactional email through the Email API (send.api.mailtrap.io): to up to 1000 recipients, with text and/or HTML, or from a… |
mailtrap_send_batch_emails | Send up to 500 different transactional emails in one call (send.api.mailtrap.io/api/batch): shared fields in base, one entry per message in… |
mailtrap_send_bulk_email | Send one marketing or bulk email through the Bulk stream (bulk.api.mailtrap.io), which keeps promotional traffic apart from transactional… |
mailtrap_send_bulk_batch_emails | Send up to 500 different bulk (marketing) emails in one call through the Bulk stream (bulk.api.mailtrap.io/api/batch) |
mailtrap_list_sending_domains | Sending domains of the account with their id, DNS verification and compliance status and tracking settings |
mailtrap_get_sending_domain | One sending domain with the DNS records to publish (SPF, DKIM, DMARC, return path) and whether each is verified, plus compliance status and… |
mailtrap_create_sending_domain | Add a sending domain |
mailtrap_send_domain_setup_instructions | Email the DNS setup instructions of a sending domain to someone, e.g. the person who manages DNS |
mailtrap_list_suppressions | Addresses Mailtrap no longer sends to (hard bounce, unsubscription, spam complaint, manual import), up to 1000 per call, with the message… |
mailtrap_create_suppression | Stop sending to an address on one domain and stream |
mailtrap_delete_suppression | Remove a suppression so the address receives email again |
mailtrap_get_sending_stats | Sending totals for a date range: delivery, bounce, open, click and spam counts and rates, optionally limited to domains, streams… |
mailtrap_get_sending_stats_grouped | The same sending stats split by sending domain, category, recipient mailbox provider or day |
mailtrap_list_email_logs | Sent messages of the account, newest first, with status, recipient, subject, category, opens and clicks |
mailtrap_get_email_log | One sent message with its delivery events (delivery, open, click, bounce with the provider response), custom variables, template and a link… |
mailtrap_list_sandbox_projects | Email Sandbox projects with the sandboxes (test inboxes) in each |
mailtrap_list_sandboxes | All sandboxes (test inboxes) with id, name, project, message and unread counts and the sandbox email address |
mailtrap_get_sandbox | One sandbox: name, project, message counts, size limits, SMTP host and ports and its email address |
mailtrap_list_sandbox_messages | Messages caught in a sandbox, newest first, 30 per page: id, subject, sender, recipient, sent time, size and read state (SMTP details and… |
mailtrap_get_sandbox_message | One sandbox message: sender, recipient, subject, size, SMTP details and blacklist report summary |
mailtrap_get_sandbox_message_body | The body of a sandbox message: txt (plain text), html (sanitized for preview), htmlsource (the HTML as sent) or raw (the whole MIME message) |
mailtrap_get_sandbox_message_headers | The mail headers of a sandbox message (From, To, Subject, Message-ID, List-Unsubscribe, ...) |
mailtrap_get_sandbox_spam_report | SpamAssassin report of a sandbox message: total score, threshold and the rules that matched |
mailtrap_get_sandbox_html_analysis | HTML check of a sandbox message: which elements and CSS properties are unsupported by which email clients, with an overall support score |
mailtrap_list_sandbox_attachments | Attachments of a sandbox message with filename, content type, size and download path |
mailtrap_send_sandbox_email | Send a test email into a sandbox (sandbox.api.mailtrap.io): it is caught there and never reaches the recipients, so it is safe for trying… |
mailtrap_create_sandbox | Create a sandbox (test inbox) in a project; the answer carries its id and email address, SMTP credentials left out |
mailtrap_clean_sandbox | Delete every message in a sandbox |
mailtrap_list_contacts | Email Marketing contacts, 25 per page by default (at most 50), with id, email, status, list ids and fields |
mailtrap_get_contact | One contact by id or email: status, lists, fields and timestamps |
mailtrap_create_contact | Add a contact, optionally with fields (by merge tag) and lists |
mailtrap_update_contact | Change a contact: email, fields, list membership or subscription status |
mailtrap_delete_contact | Delete a contact for good, e.g. on an erasure request |
mailtrap_create_contact_event | Record a custom event for a contact (e.g. purchase, trial_started) with parameters, for automations and segments |
mailtrap_list_contact_lists | Contact lists with id and name; search filters by the start of the name |
mailtrap_create_contact_list | Create an Email Marketing contact list; add contacts with list_ids or list_ids_included afterwards |
mailtrap_list_contact_fields | Contact fields with id, name, data type and the merge tag used in contact fields and templates |
mailtrap_import_contacts | Create or update up to 50,000 contacts in one asynchronous import, matched by email |
mailtrap_get_contact_import | Status of a contact import (created, started, finished, failed) with the counts of created and updated contacts and those over the plan… |
mailtrap_list_templates | Email templates of the account with id, uuid (used to send), name, category and subject |
mailtrap_get_template | One email template with subject, HTML and text body (Handlebars variables such as {{user_name}}) |
mailtrap_create_template | Create an email template |
mailtrap_update_template | Change an email template; only the fields you pass change |
mailtrap_list_campaigns | Email Marketing campaigns, newest first, with id, name, state and schedule |
mailtrap_get_campaign | One campaign: state, sender, audience lists and segments, delivery mode, template and schedule |
mailtrap_get_campaign_stats | Results of a campaign: delivered, opened, clicked, bounced, spam and unsubscribed counts and rates, optionally for a date window |
mailtrap_create_campaign | Create a campaign as a draft: sender, audience, subject and design |
mailtrap_update_campaign | Change a draft campaign; only the fields you pass change |
mailtrap_schedule_campaign | Schedule a draft campaign to go out at a set time, at most one month ahead |
mailtrap_start_campaign | Start sending a draft campaign now to its whole audience |
mailtrap_cancel_campaign | Cancel a scheduled campaign before it goes out; it goes back to draft and can be edited again |
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
Il piano free di ChatGPT funziona con i server MCP personalizzati? OpenAI documenta i server MCP personalizzati solo per i piani a pagamento; il piano Free non è nell'elenco.
Prossimi passi
- Landing del connettore
- Collegare a Claude
- Collegare a Cursor
- Collegare a Gemini
- Collegare a Meta Muse
- Collegare a Microsoft Copilot
Questa guida ti è stata utile?