Presentazione del Server MCP Emailit

Stiamo rilasciando il Server MCP di Emailit, un server open-source del Model Context Protocol che fornisce agli assistenti AI come Claude, Cursor e qualsiasi altro client compatibile con MCP accesso completo alla piattaforma Emailit. Invia email, gestisci contatti, configura domini, crea template, tutto attraverso il linguaggio naturale.

Cosa sblocca

Invece di passare continuamente tra il tuo assistente AI e la dashboard di Emailit, ora puoi fare tutto da una singola conversazione:

• “Invia un’email di benvenuto a sarah@example.com usando il template di onboarding” — l’AI sceglie il template giusto, compila le variabili e la invia.
• “Mostrami tutte le email che sono rimbalzate questa settimana” — elenca e ispeziona le email senza uscire dal tuo editor.
• “Aggiungi mail.example.com come dominio di invio e mostrami i record DNS” — crea il dominio e ottieni i record esatti che devi configurare.
• “Programma un promemoria per il team domani alle 9” — il server accetta programmazioni in linguaggio naturale come “domani alle 9” o “lunedì prossimo alle 14”.

Il Server MCP espone 47 strumenti in 8 categorie: email, domini, chiavi API, audience, contatti, template, soppressioni e webhook. Copre l’intera API di Emailit.

Come funziona

Il Model Context Protocol è uno standard aperto che permette agli assistenti AI di connettersi a servizi esterni attraverso un’interfaccia strutturata di strumenti. Il Server MCP di Emailit implementa questo protocollo, così qualsiasi client compatibile può scoprire e chiamare automaticamente le operazioni di Emailit.

Ci sono due modi per connettersi:

1. Stdio — Il client avvia il server come sottoprocesso e comunica tramite stdin/stdout. È la configurazione più semplice e funziona con Claude Code, Cursor e Claude Desktop.
2. HTTP — Il server funziona come servizio HTTP standalone con trasporto HTTP Streamable. Utile per configurazioni remote, ambienti condivisi o client web.

Come iniziare

Tutto quello che ti serve è un account Emailit, una chiave API e Node.js 18+.

Claude Code

claude mcp add emailit -e EMAILIT_API_KEY=la_tua_chiave_api -- npx -y @emailit/emailit-mcp

Cursor

Apri Impostazioni Cursor → MCP → Aggiungi nuovo server MCP globale e incolla:

{
  "mcpServers": {
    "emailit": {
      "command": "npx",
      "args": ["-y", "@emailit/emailit-mcp"],
      "env": {
        "EMAILIT_API_KEY": "la_tua_chiave_api"
      }
    }
  }
}

Claude Desktop

Apri Impostazioni → Sviluppatore → Modifica Configurazione e incolla lo stesso blocco JSON qui sopra.

Ecco fatto. Una volta connesso, l’AI scoprirà automaticamente tutti i 47 strumenti e potrai iniziare a usarli subito.

Esempi

Ecco alcune cose che puoi fare fin da subito:

Invia email con template e variabili

“Invia il template welcome-email a john@example.com con il suo nome come John”

L’AI risolve il template tramite alias, sostituisce la variabile {{name}} e invia:

{
  "template": "welcome-email",
  "to": "john@example.com",
  "variables": { "name": "John" }
}

Allega file da un URL

“Invia la fattura mensile a accounting@company.com con il PDF dal nostro bucket S3”

{
  "to": "accounting@company.com",
  "subject": "Fattura Mensile",
  "attachments": [
    {
      "filename": "fattura-2026-05.pdf",
      "url": "https://mybucket.s3.amazonaws.com/invoices/2026-05.pdf"
    }
  ]
}

Gestisci l’intera infrastruttura di invio

“Crea una nuova audience chiamata ‘Utenti Beta’, aggiungi jane@example.com e poi crea un webhook che mi mandi gli eventi di consegna”

L’AI concatena più strumenti insieme — create-audience, create-contact e create-webhook — in una singola conversazione.

Sopprimi e riattiva indirizzi

“Sopprimi bounced@example.com per troppi rimbalzi definitivi, impostalo per scadere tra 30 giorni”

{
  "email": "bounced@example.com",
  "type": "bounce",
  "reason": "troppi rimbalzi definitivi",
  "keep_until": "2026-06-18T00:00:00Z"
}

Suggerimenti

• Imposta un mittente predefinito. Passa --sender tu@tuodominio.com o imposta la variabile d’ambiente SENDER_EMAIL_ADDRESS così l’AI non chiederà un indirizzo mittente ogni volta.
• Usa i template per email ripetute. Crea template con {{variabili}} e referenziali tramite alias, è più veloce e coerente che scrivere HTML nella chat.
• La programmazione in linguaggio naturale funziona. Puoi dire “domani alle 9”, “venerdì prossimo a mezzogiorno”, o passare un timestamp ISO 8601, il server gestisce entrambi.
• Le operazioni distruttive sono protette. Gli strumenti di eliminazione istruiscono l’AI a confermare con te prima di procedere, così non cancellerai accidentalmente un dominio o contatto.
• Modalità HTTP per configurazioni condivise. Se più membri del team o servizi hanno bisogno di accesso, esegui il server in modalità HTTP e ogni client si autentica con la propria chiave API tramite Bearer token.

Open source

Il Server MCP di Emailit è sotto licenza MIT e disponibile su GitHub. È puro JavaScript (ESM), non ha fase di build e dipende solo da quattro pacchetti: @modelcontextprotocol/sdk, fastify, minimist e zod.

Contributi e feedback sono benvenuti, apri un issue o invia una PR.

Documentazione completa

Abbiamo pubblicato una guida completa di configurazione e riferimento:

• Guida al Server MCP di Emailit — Installazione, configurazione, tutti i 47 strumenti, esempi d’uso e risoluzione problemi

Inizia subito

Installa il server MCP con un singolo comando:

npx -y @emailit/emailit-mcp

Leggi la guida completa o dai un’occhiata al repository GitHub per iniziare.