Come collegare Postmark a Cursor via MCP

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

Postmark + Cursor

Email transazionali e broadcast con Postmark per un server: invio di email singole, in batch e da modello, gestione dei modelli, ricerca dei messaggi inviati e ricevuti con aperture, clic e bounce, statistiche di invio e gestione di soppressioni, message stream e webhook. Con un token account facoltativo legge anche server, domini e firme mittente.

Prerequisiti

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

POSTMARK_SERVER_TOKEN (facoltativo: POSTMARK_ACCOUNT_TOKEN)

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. Ti serve un account Postmark con un server.

1. In Postmark apri il server, poi API Tokens, e copia un Server API token in POSTMARK_SERVER_TOKEN. Viene inviato nell'header X-Postmark-Server-Token e raggiunge solo quel server.
2. Facoltativo: per gli strumenti dell'account (postmark_list_servers, postmark_get_server_by_id, postmark_list_domains, postmark_get_domain, postmark_verify_domain_dkim, postmark_verify_domain_return_path, postmark_list_sender_signatures, postmark_get_sender_signature) un proprietario o amministratore dell'account copia l'Account API token da Account, API Tokens in POSTMARK_ACCOUNT_TOKEN. Viene inviato come X-Postmark-Account-Token solo su quegli strumenti. Senza di esso rispondono 401; tutti gli altri strumenti funzionano.
3. Installa il connettore ed esegui postmark_get_server: mostra le impostazioni del server e conferma il token.

Entrambi i token hanno la forma di un UUID (8-4-4-4-12 caratteri esadecimali).

Invio: postmark_send_email invia un'email a un massimo di 50 destinatari con oggetto, corpo HTML e/o testo, tag, metadati, tracciamento e allegati. postmark_send_batch invia fino a 500 email diverse in una chiamata. postmark_send_email_with_template e postmark_send_batch_with_templates usano un modello salvato (TemplateId o TemplateAlias) con un TemplateModel di variabili. From deve essere una firma mittente confermata o un indirizzo su un dominio verificato. I nuovi account restano in modalità test finché Postmark non li approva e possono inviare solo a indirizzi del proprio dominio. Le email transazionali passano dallo stream outbound (quello predefinito); le email massive o di marketing devono usare uno stream Broadcasts (MessageStream), che gestisce la disiscrizione. Ogni invio arriva in caselle reali, quindi l'AI ti mostra destinatari, oggetto e contenuto e aspetta il tuo sì. Le chiamate batch rispondono 200 anche quando singoli messaggi falliscono: l'AI controlla ErrorCode (0 = accettato) e Message di ogni risultato.

Modelli: postmark_list_templates, postmark_get_template, postmark_validate_template (controlla la sintassi e genera un'anteprima con un modello di prova, senza salvare), postmark_create_template e postmark_update_template. Le variabili usano Mustachio, ad esempio {{name}}; un Layout racchiude i modelli standard con {{{@content}}}.

Capire cosa è successo a un'email:

• Cerca la posta inviata con postmark_search_outbound_messages per destinatario, mittente, tag, oggetto, stato, stream, data o un campo di metadati, e quella ricevuta con postmark_search_inbound_messages. postmark_retry_inbound_message reinvia al webhook inbound un messaggio in arrivo non riuscito.
• postmark_get_outbound_message o postmark_get_inbound_message mostra i dettagli e, per la posta inviata, la cronologia MessageEvents (Delivered, Bounced, Opened, LinkClicked, SubscriptionChanged).
• Aperture e clic: postmark_list_message_opens, postmark_get_message_opens, postmark_list_message_clicks, postmark_get_message_clicks, con client email, browser, sistema operativo, piattaforma e posizione.
• Bounce: postmark_get_delivery_stats, postmark_list_bounces, postmark_get_bounce e postmark_get_bounce_dump (la risposta SMTP grezza, conservata 30 giorni). postmark_activate_bounce riattiva un indirizzo quando CanActivate è true.
• Soppressioni per stream: postmark_list_suppressions e postmark_create_suppressions (fino a 50 indirizzi per chiamata).

Statistiche: postmark_get_outbound_overview dà totali e tassi per un periodo (inviate, bounce, segnalazioni di spam, aperture, aperture uniche, email tracciate, clic sui link). postmark_get_outbound_stats con metric dà i conteggi giornalieri di invii, bounce, spam, tracciate, aperture, clic, piattaforme, client email, browser o posizioni.

Configurazione del server: postmark_get_server; message stream con postmark_list_message_streams, postmark_get_message_stream, postmark_create_message_stream (al massimo 10 stream per server, di cui uno Inbound), postmark_update_message_stream e postmark_unarchive_message_stream; webhook con postmark_list_webhooks, postmark_get_webhook, postmark_create_webhook e postmark_update_webhook. Con il token account l'AI elenca anche server, domini e firme mittente, mostra i record DNS di cui ha bisogno un dominio e chiede a Postmark di verificare DKIM e Return-Path dopo che li hai aggiunti.

Disattivati all'installazione: postmark_delete_template, postmark_delete_suppressions (che permette agli indirizzi soppressi di ricevere di nuovo email), postmark_delete_webhook e postmark_archive_message_stream (uno stream archiviato smette di inviare e viene eliminato con i suoi dati dopo 45 giorni se non viene ripristinato). Un amministratore del workspace li attiva quando servono al team.

Formati dei dati: i nomi dei campi sono in PascalCase (MessageID, SubmittedAt, TotalCount). Le date di ricerca (fromdate, todate) sono nell'ora della costa est degli Stati Uniti (US Eastern); i timestamp restituiti riportano il loro offset. Le date delle statistiche sono YYYY-MM-DD. Messaggi ed eventi sono conservati per il periodo di retention del server, 45 giorni di default.

Paginazione: gli strumenti di elenco e ricerca accettano count (predefinito 50, al massimo 500) e offset; count più offset non può superare 10.000. Per andare più indietro, l'AI restringe l'intervallo di date. Confrontando TotalCount con le righe ricevute si capisce se ci sono altre pagine.

Errori comuni: 401 indica un token mancante o errato, oppure il token del server su uno strumento dell'account. 422 indica una richiesta non valida; ErrorCode e Message dicono perché: 300 validazione dell'invio (ad esempio un indirizzo non valido o un corpo mancante), 406 un destinatario inattivo o soppresso, 410 più di 500 messaggi in un batch, 412 destinatari fuori dal dominio del From mentre l'account attende l'approvazione, 1101 modello non trovato, 1235 message stream sconosciuto. 429 indica troppe richieste; 500 è un problema di Postmark, riprova più tardi.

Il connettore non crea server, domini o firme mittente, non rimuove soppressioni dovute a segnalazioni di spam e non elimina messaggi inviati.

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 Cursor

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.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di Postmark.

Tool disponibili

Esempi di prompt

• "La nostra email di reset della password a [email protected] è arrivata ieri? Mostrami i suoi eventi di consegna."
• "Quante email abbiamo inviato la settimana scorsa e quali sono stati i tassi di bounce e di segnalazioni di spam?"
• "Elenca gli hard bounce degli ultimi 7 giorni con destinatario e risposta del server ricevente."
• "Invia il modello di benvenuto a [email protected] con il nome Tom. Mostrami l'email generata prima di inviarla."
• "Il record DKIM del nostro dominio di invio è già verificato? Se no, mostrami il record DNS da aggiungere."

FAQ

Cursor supporta server MCP personalizzati nel piano gratuito? Sì, MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

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