Riferimento

Plugin e skill di Emailit

Il plugin ufficiale di Emailit per ChatGPT, Codex, Claude Code, Cursor e Grok riunisce il server MCP ospitato, una serie di skill e una regola che tiene i secret fuori dal codice.

Aggiornato il 2 ott 2026

Il plugin Emailit contiene tutto ciò che serve a un assistente AI per lavorare con Emailit: una connessione al server MCP ospitato, skill che insegnano all’assistente come funziona Emailit e una regola di Cursor per gestire i secret in modo sicuro. È open source su github.com/emailit/emailit-plugins (MIT).

Accedi con il tuo account Emailit tramite OAuth e scegli i workspace che il plugin può usare: tutti, o solo quelli che selezioni. Nel plugin non viene salvata nessuna chiave API.

Cosa include

Componente	Cosa fa
Server MCP	`https://api.emailit.com/mcp` con 109 strumenti per email, domini, DMARC, template, liste, contatti, soppressioni, campagne, automazioni, moduli, verifica, webhook, eventi, chiavi API e workspace
Skill `emailit`	Scelta tra strumenti MCP e API REST, invio sicuro, ID, paginazione, errori ed elenco completo degli strumenti
Skill `emailit-get-started`	Collegarsi, confermare il workspace, controllare un dominio e inviare una prima email di prova
Skill `emailit-domain-setup`	Aggiungere un dominio, pubblicare i record DNS presso qualsiasi provider, verificarli e correggere quelli non riusciti
Skill `emailit-deliverability`	Bounce, arrivo nella cartella spam, soppressioni, report DMARC e verifica delle liste, con risposte basate sui dati del tuo account
Skill `emailit-campaigns`	Liste, contatti, campagne, automazioni e moduli di iscrizione, con invio sicuro
Skill `emailit-webhooks`	Eventi, filtri, verifica delle firme, payload in batch, nuovi tentativi e debug
Skill `emailit-sdk`	Codice di produzione per gli SDK Node.js, Python, PHP, Laravel, Go, Ruby, Java, .NET e Rust, più SMTP
Regola di Cursor	Tiene le chiavi API di Emailit (`secret_…`) e i secret dei webhook (`whsec_…`) fuori dal codice sorgente e li legge da `EMAILIT_API_KEY` e `EMAILIT_WEBHOOK_SECRET`

Le skill vengono caricate quando servono: l’assistente legge una skill quando la tua richiesta vi corrisponde, ad esempio «perché la mia email è rimbalzata» carica emailit-deliverability.

Installa

Apri Plugins, cerca Emailit e scegli Connect. Accedi, scegli i workspace da consentire e approva l’accesso. Vedi ChatGPT.

Terminal

codex plugin marketplace add emailit/emailit-plugins

Apri /plugins, installa Emailit e accedi quando ti viene chiesto. Vedi Codex.

Terminal

claude plugin marketplace add emailit/emailit-plugins
claude plugin install emailit@emailit-plugins

Esegui /mcp, seleziona emailit e scegli Authenticate. Su claude.ai, Claude Desktop e mobile, usa invece il connettore Emailit. Vedi Claude.

Installa Emailit dal Cursor Marketplace o con /add-plugin emailit, poi scegli Connect accanto a emailit in Settings > MCP. Vedi Cursor.

Terminal

grok plugin marketplace add emailit/emailit-plugins
grok plugin install emailit --trust

Su grok.com, aggiungi un connettore personalizzato con https://api.emailit.com/mcp. Vedi Grok.

Accesso e sicurezza

OAuth 2.1 con PKCE. L’assistente non vede mai la tua password. Approvi l’accesso sending (inviare e gestire le email inviate) o full (tutto), e scegli i workspace.
Conferma prima di agire. Gli strumenti che inviano email, eliminano dati o chiamano URL esterni sono contrassegnati in modo che il client ti chieda prima conferma, e le skill dicono all’assistente di confermare.
Revoca in qualsiasi momento in AccountConnected apps.
I client headless, come l’API di xAI e i job di CI, possono inviare allo stesso server una chiave API di Emailit come Authorization: Bearer <key>. Quando puoi, usa una chiave di solo invio.

Endpoint usati dal plugin

Il plugin comunica solo con Emailit:

Endpoint	Scopo
`https://api.emailit.com/mcp`	Server MCP ospitato (Streamable HTTP)
`https://api.emailit.com/.well-known/oauth-protected-resource/mcp`	Metadati della risorsa protetta OAuth
`https://api.emailit.com/.well-known/oauth-authorization-server`	Metadati del server di autorizzazione OAuth
`https://api.emailit.com/oauth/register`	Registrazione dinamica del client
`https://api.emailit.com/oauth/authorize`	Accesso e consenso
`https://api.emailit.com/oauth/token`	Scambio e aggiornamento dei token
`https://api.emailit.com/oauth/revoke`	Revoca dei token
`https://api.emailit.com/v2`	API REST, usata dal codice che la skill SDK scrive nel tuo progetto
`smtp.emailit.com:587`	SMTP, solo se il tuo progetto è configurato per usarlo

Manifest

Il repository contiene un manifest per ogni client:

File	Letto da
`plugin.json`, `mcp.json`	ChatGPT, Codex e altri client Agent Plugins
`.cursor-plugin/`	Cursor
`.claude-plugin/`, `.mcp.json`	Claude Code, la directory di Claude e Grok
`.grok-plugin/plugin.json`	Grok
`.agents/plugins/marketplace.json`	Il marketplace di Codex

Il riferimento degli strumenti delle skill viene generato dal catalogo degli strumenti del server MCP, la stessa fonte del riferimento degli strumenti di questa documentazione, quindi i nomi degli strumenti nelle skill esistono sempre sul server.