Aller au contenu
Docs

Guide

Documentation pour l’IA et les agents

Donnez à ChatGPT, Claude, Cursor, Codex, Grok et aux autres outils d’IA un contexte Emailit exact grâce à llms.txt, aux pages Markdown, au serveur MCP et au plugin Emailit.

Mis à jour le 2 oct. 2026

Les assistants IA répondent mieux aux questions sur Emailit quand ils lisent la documentation à jour au lieu de deviner. Emailit leur fournit trois niveaux d’aide :

Niveau Ce qu’il apporte à l’assistant Point de départ
Documentation en Markdown Chaque page de la documentation et les principales pages d’emailit.com en Markdown brut, plus des index llms.txt. Cette page
Serveur MCP 109 outils qui agissent sur vos espaces de travail : envoyer des e-mails, configurer des domaines, lancer des campagnes, etc. Serveur MCP
Plugin et skills Le savoir-faire Emailit pour Claude Code, Codex, Cursor et Grok Build : parcours de configuration, contrôles de délivrabilité, schémas d’utilisation des SDK et manipulation sûre des clés. Plugins et skills

Utilisez la documentation seule pour répondre à des questions et écrire du code. Ajoutez le serveur MCP quand l’assistant doit aussi effectuer le travail dans votre compte.

Fichiers pour les outils d’IA

Fichier Contenu Utilisation
https://emailit.com/llms.txt Un court résumé d’Emailit : produits, tarifs, crédits par action, serveur MCP et liens clés. Donner à un assistant un aperçu rapide de ce qu’est Emailit.
https://emailit.com/llms-full.txt Les principales pages d’emailit.com en un seul fichier : produits, tarifs, crédits, programmes, réponses et comparatifs. Questions sur les forfaits, les produits, les partenaires, le parrainage et la comparaison d’Emailit avec d’autres services.
https://emailit.com/docs/llms.txt Un index de toutes les pages de la documentation, regroupées par section, avec un résumé d’une ligne et un lien vers leur version Markdown. Il liste aussi des informations clés comme l’URL de base de l’API, les paramètres SMTP et l’URL du serveur MCP. Permettre à un assistant de trouver et de récupérer les pages dont il a besoin.
https://emailit.com/docs/llms-full.txt Le texte intégral de toutes les pages de la documentation en un seul fichier. Charger toute la documentation dans un projet, une base de connaissances ou l’index de documentation d’un éditeur.

Ces fichiers suivent la convention llms.txt et sont régénérés à chaque modification du site ou de la documentation.

Version Markdown de n’importe quelle page

Ajoutez .md à l’URL d’une page, sans la barre oblique finale, pour l’obtenir en Markdown. Cela fonctionne pour la documentation et pour les principales pages d’emailit.com :

Page 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

Chaque page HTML pointe vers sa version Markdown avec <link rel="alternate" type="text/markdown"> : les agents et les robots d’indexation la trouvent sans avoir à deviner l’URL.

Les éléments interactifs d’une page, comme les onglets, les encadrés et les tableaux de forfaits, deviennent du Markdown simple : les exemples de code de tous les langages sont donc inclus. Pour la référence de l’API, chaque ressource dispose aussi d’un fichier combiné avec tous ses endpoints, par exemple https://emailit.com/docs/api-reference/emails.md pour l’API des e-mails.

Actions de page

Chaque page de la documentation a un bouton Copier la page à côté du titre. Sélectionnez-le pour copier la page en Markdown, prête à être collée dans une conversation. La flèche à côté ouvre d’autres options :

Action Effet
Copier en Markdown Copie le Markdown de la page dans votre presse-papiers.
Afficher en Markdown Ouvre la version .md dans un nouvel onglet.
Ouvrir dans ChatGPT Démarre une conversation ChatGPT qui lui demande de lire le Markdown de la page, pour que vous puissiez lui poser des questions à son sujet.
Ouvrir dans Claude Démarre une conversation Claude avec le même prompt.

Utiliser la documentation dans vos outils

  • Assistants conversationnels. Collez une page avec Copier la page, ou demandez à l’assistant de lire une URL .md. Pour des questions générales, indiquez-lui https://emailit.com/docs/llms.txt et laissez-le choisir les pages.
  • Projets et bases de connaissances. Ajoutez https://emailit.com/docs/llms-full.txt comme source dans un projet Claude, un GPT personnalisé ou l’assistant interne de votre équipe. Actualisez-le de temps en temps pour récupérer les modifications.
  • Éditeurs de code. Ajoutez https://emailit.com/docs/llms-full.txt (ou https://emailit.com/docs/) comme source de documentation dans Cursor ou un éditeur similaire, puis faites-y référence quand vous demandez du code Emailit.
  • Agents de code. Installez le plugin Emailit dans Claude Code, Codex, Cursor ou Grok Build. Ses skills ne chargent les consignes Emailit de configuration et d’utilisation des SDK que lorsqu’une tâche en a besoin, et renvoient l’agent vers ces pages Markdown pour les détails.

Pour des questions ciblées, préférez le fichier .md d’une seule page : il est plus petit que le fichier complet et maintient l’assistant sur le sujet.

Combiner la documentation et le serveur MCP

La documentation explique à un assistant comment fonctionne Emailit ; le serveur MCP lui permet d’agir sur votre espace de travail. En combinant les deux, un assistant peut lire les règles, puis effectuer le travail. Par exemple, dans Cursor, Codex ou Claude Code avec le serveur MCP Emailit connecté :

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’assistant lit les règles de signature dans la documentation, appelle create-webhook pour configurer l’endpoint et obtenir le secret de signature, puis écrit le code correspondant.

Conseils

  • Vérifiez la date. Chaque page indique la date de sa dernière mise à jour. Si la réponse d’un assistant contredit une page, fiez-vous à la page.
  • Gardez les secrets hors des prompts. La documentation n’a jamais besoin de votre clé API. Préférez OAuth pour le serveur MCP, et gardez les clés dans votre environnement, pas dans des messages de chat ni dans des fichiers commités.
  • Signalez les lacunes. Si un assistant ne trouve pas une information dans la documentation, elle manque probablement aussi pour les humains. Écrivez-nous à support@emailit.com.

Pour les robots d’indexation et les créateurs d’outils

  • robots.txt autorise les moteurs de recherche et les robots d’indexation d’IA, notamment GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, Claude-User, PerplexityBot et Google-Extended. Seuls les chemins de l’API du tableau de bord et de l’administration sont exclus.
  • Les réponses Markdown utilisent text/markdown, et les fichiers llms.txt text/plain. Ce sont tous des fichiers statiques, mis en cache en périphérie du réseau.
  • Les pages contiennent des données structurées schema.org (TechArticle pour la documentation, plus le fil d’Ariane), une URL canonique et une date de mise à jour.
  • Le serveur MCP décrit chaque outil avec un schéma JSON, un titre et des annotations comme read-only et destructive, et renvoie des résultats structurés. Consultez la référence des outils.
Laissez les assistants agir sur votre espace de travail.
Les conventions communes à toutes les intégrations.
Les skills Emailit pour les agents de code.
Tous les endpoints au même endroit.

Cette page vous a-t-elle été utile ?

Merci pour votre retour.

Merci, nous lisons chaque message.