Guida

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.

Aggiornato il 2 ott 2026

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

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

Server MCP

Permetti agli assistenti di agire sul tuo workspace.

Panoramica per sviluppatori

Le convenzioni comuni a ogni integrazione.

Plugin e skill

Skill di Emailit per gli agenti di programmazione.

Riferimento API

Tutti gli endpoint in un unico posto.