Aller au contenu
Docs

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.

Mis à jour le 2 oct. 2026

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

Text
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=true

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

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

Merci pour votre retour.

Merci, nous lisons chaque message.