# 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.

Il plugin Emailit contiene tutto ciò che serve a un assistente AI per lavorare con Emailit: una connessione al [server MCP ospitato](/it/docs/mcp/), 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](https://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

**ChatGPT**

  Apri **Plugins**, cerca **Emailit** e scegli **Connect**. Accedi, scegli i workspace da consentire e approva l’accesso. Vedi [ChatGPT](/it/docs/mcp/chatgpt/).

**Codex**

```bash
codex plugin marketplace add emailit/emailit-plugins
```

  Apri `/plugins`, installa **Emailit** e accedi quando ti viene chiesto. Vedi [Codex](/it/docs/mcp/codex/).

**Claude Code**

```bash
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](/it/docs/mcp/claude/).

**Cursor**

  Installa **Emailit** dal Cursor Marketplace o con `/add-plugin emailit`, poi scegli **Connect** accanto a **emailit** in **Settings > MCP**. Vedi [Cursor](/it/docs/mcp/cursor/).

**Grok**

```bash
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](/it/docs/mcp/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 **Account → Connected 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](/it/docs/mcp/tools/) di questa documentazione, quindi i nomi degli strumenti nelle skill esistono sempre sul server.

---
Fonte: https://emailit.com/it/docs/mcp/plugins-and-skills/