Référence
Groupes d’outils et mode lecture seule
Ne chargez que les outils MCP Emailit dont vous avez besoin grâce aux groupes d’outils, ou masquez tous les outils d’écriture avec le mode lecture seule, via des options d’URL ou des en-têtes.
Certains clients chargent un nombre limité d’outils, et des listes d’outils plus courtes rendent les assistants plus rapides et plus précis. Transmettez des options dans l’URL du serveur ou sous forme d’en-têtes pour choisir ce que le serveur expose.
| Option | Paramètre de requête | En-tête | Valeurs |
|---|---|---|---|
| Groupes d’outils | toolsets |
X-MCP-Toolsets |
Noms de groupes d’outils séparés par des virgules, ou all |
| Mode lecture seule | read_only |
X-MCP-Readonly |
true, 1, yes ou on |
Les en-têtes l’emportent sur les paramètres de requête lorsque les deux sont définis.
Exemples
https://api.emailit.com/mcp?toolsets=emails,domains,events
https://api.emailit.com/mcp?read_only=true
https://api.emailit.com/mcp?toolsets=emails,domains&read_only=trueLa dernière URL donne à l’assistant un accès en lecture seule aux e-mails et aux domaines uniquement : il peut consulter les livraisons et les enregistrements DNS, mais ne peut rien envoyer ni modifier.
Groupes d’outils
| Groupe d’outils | Contenu |
|---|---|
emails |
Envoyer, lister, lire, reprogrammer, annuler, relancer et transférer des e-mails |
domains |
Domaines d’envoi et vérification DNS |
dmarc |
Rapports DMARC agrégés et forensiques, et statistiques |
templates |
Modèles, versions et publication |
api_keys |
Clés API |
audiences |
Listes de contacts et leurs abonnés |
contacts |
Contacts, actions en masse et export |
suppressions |
La liste d’adresses bloquées |
webhooks |
Webhooks, tests, secrets et relances |
campaigns |
Campagnes |
automations |
Automatisations, exécutions et statistiques |
forms |
Formulaires d’inscription |
verification |
Vérification d’e-mails et listes de vérification |
events |
Le flux d’événements de l’espace de travail |
Le groupe d’outils workspace (get-current-workspace, list-workspaces, switch-workspace, create-workspace) est toujours inclus. Les noms de groupes d’outils inconnus sont ignorés ; si aucun nom n’est valide, tous les groupes d’outils sont chargés.
Mode lecture seule
Le mode lecture seule conserve les outils de type Lecture et masque tout ce qui crée, met à jour, supprime, envoie ou appelle une URL externe. switch-workspace reste disponible, car il ne modifie que l’espace de travail par défaut de la connexion. Le type de chaque outil figure dans la référence des outils.
Le mode lecture seule est un bon choix par défaut pour les assistants d’analyse et pour essayer un nouveau client.