# Documentazione per l’AI e gli agenti

> Dai a ChatGPT, Claude, Cursor, Codex, Grok e altri strumenti AI un contesto accurato su Emailit con llms.txt, le pagine in Markdown, il server MCP e il plugin Emailit.

Gli assistenti AI danno risposte migliori su Emailit quando leggono la documentazione aggiornata invece di tirare a indovinare. Emailit li aiuta su tre livelli:

| Livello | Cosa offre all’assistente | Inizia da qui |
| --- | --- | --- |
| **Documentazione in Markdown** | Ogni pagina della documentazione e le pagine principali di emailit.com in semplice Markdown, più gli indici llms.txt. | Questa pagina |
| **Server MCP** | 109 strumenti che agiscono sui tuoi workspace: inviare email, configurare domini, gestire campagne e altro. | [Server MCP](/it/docs/mcp/) |
| **Plugin e skill** | Il know-how di Emailit per Claude Code, Codex, Cursor e Grok Build: flussi di configurazione, controlli di deliverability, pattern degli SDK e gestione sicura delle chiavi. | [Plugin e skill](/it/docs/mcp/plugins-and-skills/) |

Usa solo la documentazione per rispondere a domande e scrivere codice. Aggiungi il server MCP quando l’assistente deve anche svolgere il lavoro nel tuo account.

## File per gli strumenti AI

| File | Cosa contiene | A cosa serve |
| --- | --- | --- |
| [`https://emailit.com/llms.txt`](https://emailit.com/llms.txt) | Un breve riepilogo di Emailit: prodotti, prezzi, crediti per azione, il server MCP e i link principali. | Dare a un assistente una rapida panoramica di cos’è Emailit. |
| [`https://emailit.com/llms-full.txt`](https://emailit.com/llms-full.txt) | Le pagine principali di emailit.com in un unico file: prodotti, prezzi, crediti, programmi, risposte e confronti. | Domande su piani, prodotti, partner, referral e sul confronto tra Emailit e altri servizi. |
| [`https://emailit.com/docs/llms.txt`](https://emailit.com/docs/llms.txt) | Un indice di ogni pagina della documentazione, raggruppato per sezione, con un riepilogo di una riga e un link alla versione Markdown. Elenca anche i dati principali, come l’URL di base dell’API, le impostazioni SMTP e l’URL del server MCP. | Permettere a un assistente di trovare e scaricare le pagine che gli servono. |
| [`https://emailit.com/docs/llms-full.txt`](https://emailit.com/docs/llms-full.txt) | Il testo completo di ogni pagina della documentazione in un unico file. | Caricare tutta la documentazione in un progetto, in una knowledge base o nell’indice della documentazione di un editor. |

Questi file seguono la convenzione [llms.txt](https://llmstxt.org) e vengono rigenerati ogni volta che il sito o la documentazione cambiano.

## Versione Markdown di qualsiasi pagina

Aggiungi `.md` all’URL di una pagina, senza la barra finale, per ottenerla in Markdown. Funziona per la documentazione e per le pagine principali di emailit.com:

| Pagina | Markdown |
| --- | --- |
| `https://emailit.com/docs/quickstart/api/` | `https://emailit.com/docs/quickstart/api.md` |
| `https://emailit.com/docs/webhooks/request-signature/` | `https://emailit.com/docs/webhooks/request-signature.md` |
| `https://emailit.com/docs/mcp/tools/` | `https://emailit.com/docs/mcp/tools.md` |
| `https://emailit.com/pricing/` | `https://emailit.com/pricing.md` |
| `https://emailit.com/products/email-api/` | `https://emailit.com/products/email-api.md` |
| `https://emailit.com/vs/sendgrid/` | `https://emailit.com/vs/sendgrid.md` |
| `https://emailit.com/` | `https://emailit.com/index.md` |

Ogni pagina HTML rimanda alla sua versione Markdown con `<link rel="alternate" type="text/markdown">`, così agenti e crawler possono trovarla senza indovinare l’URL.

Le parti interattive di una pagina, come schede, callout e tabelle dei piani, diventano semplice Markdown, quindi sono inclusi gli esempi di codice per ogni linguaggio. Per il riferimento API, ogni risorsa ha anche un unico file che riunisce tutti i suoi endpoint, ad esempio `https://emailit.com/docs/api-reference/emails.md` per l’API delle email.

## Azioni sulla pagina

Ogni pagina della documentazione ha un pulsante **Copia la pagina** accanto al titolo. Selezionalo per copiare la pagina in Markdown, pronta da incollare in una chat. La freccia accanto apre altre opzioni:

| Azione | Cosa fa |
| --- | --- |
| **Copia come Markdown** | Copia il Markdown della pagina negli appunti. |
| **Visualizza in Markdown** | Apre la versione `.md` in una nuova scheda. |
| **Apri in ChatGPT** | Avvia una conversazione in ChatGPT che gli chiede di leggere il Markdown della pagina, così puoi fargli domande al riguardo. |
| **Apri in Claude** | Avvia una conversazione in Claude con lo stesso prompt. |

## Usa la documentazione nei tuoi strumenti

- **Assistenti in chat.** Incolla una pagina con **Copia la pagina**, oppure chiedi all’assistente di leggere un URL `.md`. Per domande di ampio respiro, indicagli `https://emailit.com/docs/llms.txt` e lascia che scelga le pagine.
- **Progetti e knowledge base.** Aggiungi `https://emailit.com/docs/llms-full.txt` come fonte in un progetto Claude, in un GPT personalizzato o nell’assistente interno del tuo team. Aggiornalo di tanto in tanto per includere le modifiche.
- **Editor di codice.** Aggiungi `https://emailit.com/docs/llms-full.txt` (o `https://emailit.com/docs/`) come fonte di documentazione in Cursor o in un editor simile, poi richiamala quando chiedi codice per Emailit.
- **Agenti di programmazione.** Installa il [plugin Emailit](/it/docs/mcp/plugins-and-skills/) in Claude Code, Codex, Cursor o Grok Build. Le sue skill caricano le indicazioni su configurazione e SDK di Emailit solo quando un compito ne ha bisogno, e rimandano l’agente a queste pagine Markdown per i dettagli.

Per domande mirate preferisci il file `.md` di una singola pagina: è più piccolo del file completo e mantiene l’assistente sull’argomento.

## Combina la documentazione con il server MCP

La documentazione spiega a un assistente come funziona Emailit; il [server MCP](/it/docs/mcp/) gli permette di agire sul tuo workspace. Usandoli insieme, un assistente può leggere le regole e poi svolgere il lavoro. Ad esempio, in Cursor, Codex o Claude Code con il server MCP di Emailit collegato:

```text
Read https://emailit.com/docs/webhooks/request-signature.md and
https://emailit.com/docs/webhooks/event-types.md.

Then create an Emailit webhook named "Bounces" that sends email.bounced
and email.complained events to https://acme.com/webhooks/emailit, and
add an Express route at /webhooks/emailit that verifies the signature
with the webhook's secret and marks bounced addresses in our users table.
```

L’assistente legge le regole di firma nella documentazione, chiama `create-webhook` per configurare l’endpoint e ottenere il secret di firma, e scrive codice coerente.

## Suggerimenti

- **Controlla la data.** Ogni pagina mostra quando è stata aggiornata l’ultima volta. Se la risposta di un assistente contraddice una pagina, fidati della pagina.
- **Tieni i secret fuori dai prompt.** La documentazione non ha mai bisogno della tua chiave API. Per il server MCP preferisci OAuth, e tieni le chiavi nell’ambiente, non nei messaggi in chat o nei file sottoposti a commit.
- **Segnala le lacune.** Se un assistente non trova qualcosa nella documentazione, probabilmente manca anche per le persone. Scrivici a support@emailit.com.

## Per crawler e sviluppatori di strumenti

- `robots.txt` consente l’accesso ai motori di ricerca e ai crawler AI, tra cui GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, Claude-User, PerplexityBot e Google-Extended. Sono esclusi solo l’API del pannello e i percorsi di amministrazione.
- Le risposte in Markdown usano `text/markdown` e i file llms.txt usano `text/plain`. Sono tutti file statici, in cache sull’edge.
- Le pagine contengono dati strutturati schema.org (`TechArticle` per la documentazione, più i breadcrumb), un URL canonico e una data di aggiornamento.
- Il [server MCP](/it/docs/mcp/) descrive ogni strumento con uno schema JSON, un titolo e annotazioni come sola lettura e distruttivo, e restituisce risultati strutturati. Vedi il [riferimento degli strumenti](/it/docs/mcp/tools/).

## Vedi anche

  - [Server MCP](/it/docs/mcp/): Permetti agli assistenti di agire sul tuo workspace.
  - [Panoramica per sviluppatori](/it/docs/developers/): Le convenzioni comuni a ogni integrazione.
  - [Plugin e skill](/it/docs/mcp/plugins-and-skills/): Skill di Emailit per gli agenti di programmazione.
  - [Riferimento API](/it/docs/api-reference/): Tutti gli endpoint in un unico posto.

---
Fonte: https://emailit.com/it/docs/developers/llms-txt/