Se connecter avec MCP | AgentsMail.io Documentation

MCP permet à un agent compatible de lire vos listes, préparer une campagne ou suivre ses résultats dans AgentsMail. Vous autorisez la connexion dans votre navigateur et choisissez l’organisation dans laquelle il peut agir, sans clé API à copier.

Activez le son dans le lecteur pour écouter les explications.

Commandes à copier

Claude Code

Dans votre terminal, ajoutez AgentsMail à votre configuration personnelle. L’option --scope user rend cette connexion disponible dans vos projets.

Claude Code · terminal

claude mcp add --transport http --scope user agentsmail https://www.agentsmail.io/api/mcp

Ouvrez ou relancez Claude Code. Dans sa conversation, saisissez :

Dans Claude Code

/mcp

Choisissez agentsmail, puis lancez l’authentification. Le navigateur ouvre AgentsMail pour vous demander votre accord.

Codex

Dans votre terminal, ajoutez le serveur :

Codex · terminal

codex mcp add agentsmail --url https://www.agentsmail.io/api/mcp

Si l’autorisation ne s’est pas ouverte automatiquement, ou pour vous reconnecter, lancez :

Codex · autorisation

codex mcp login agentsmail

Après le consentement, ouvrez ou relancez Codex. La commande /mcp dans Codex permet de vérifier les outils actifs.

Les commandes du terminal configurent la connexion. L’accès à vos données demande ensuite votre autorisation dans le navigateur, où vous choisissez l’organisation. Aucune clé API à copier.

Pour les réglages propres à votre client, consultez les guides officiels Claude Code et Codex.

Autoriser l’accès dans le navigateur

Après avoir lancé l’authentification depuis votre client, connectez-vous à AgentsMail avec votre compte habituel. Si vous utilisez la double authentification, terminez cette étape aussi.
Vérifiez le nom de l’application, l’adresse de retour et les droits demandés. Une application qui s’enregistre elle-même porte la mention Application non vérifiée : son nom est déclaré par l’application, pas vérifié par AgentsMail.
Dans Organisation, sélectionnez celle dans laquelle l’agent doit travailler. Seules les organisations auxquelles vous appartenez sont proposées. Si la liste est vide, rejoignez ou créez une organisation avant de continuer.
Choisissez Autoriser, ou Refuser pour revenir sans accorder d’accès. Changer de compte permet de vous connecter à un autre compte avant de décider.
Demandez à votre agent d’appeler get_account, puis list_lists. Vérifiez l’organisation indiquée et retrouvez une liste que vous connaissez avant de demander une modification.

Chaque réponse d’outil nomme l’organisation autorisée. Changer d’organisation dans l’application web ne déplace pas la connexion de l’agent ; son renouvellement conserve aussi ce choix. Pour travailler ailleurs, reconnectez l’agent et choisissez l’autre organisation. Si vous quittez l’organisation, l’agent perd cet accès.

Ce que vous autorisez à la connexion

Les autorisations demandées par l’application, aussi appelées scopes, déterminent les familles d’outils accessibles à cette connexion.

Droit	Outils
Lecture (`mcp:read`)	`get_account`, `list_lists`, `list_contacts`, `list_tags`, `list_templates`, `list_campaigns`, `get_campaign`, `get_campaign_stats`, `list_sequences`, `list_media`
Gestion (`mcp:manage`)	`create_list`, `upsert_contact`, `create_template`, `create_campaign`, `upload_media`, `delete_media`
Envoi de campagnes (`mcp:send`)	`send_campaign`
Rester connecté (`offline_access`)	Maintient la connexion quand un jeton d’accès de courte durée expire.

Ces droits n’augmentent jamais ceux de votre compte. Les membres d’une organisation peuvent lire ; la gestion exige un administrateur ou propriétaire de l’organisation. Le lancement de campagnes exige aussi le droit d’envoi disponible sur votre compte. Les limites du forfait et les unités d’envoi disponibles continuent de s’appliquer. Vous pouvez ensuite retirer une famille d’actions dans Droits du MCP, sans reconnecter l’agent. À l’inverse, activer Gestion sur cette page ne donne pas de nouveaux outils à une connexion qui n’a demandé que la lecture : reconnectez l’application avec les autorisations nécessaires. list_contacts attend un listId : trouvez-le avec list_lists. Les outils paginés acceptent page et limit (100 maximum). create_template accepte du HTML et signale les balises de fusion non prises en charge. create_campaign crée un brouillon et peut copier un template de la même organisation.

Ajouter un contact peut déclencher vos emails de confirmation et vos automatisations configurées. La suppression d’un média est définitive. Demandez à votre agent d’expliquer ces effets avant de modifier vos données.

Approuver chaque envoi

Autoriser la connexion ne vaut pas accord pour envoyer des campagnes. Vérifiez la cible et le contenu, puis approuvez cette campagne précise. L’agent doit transmettre confirmation: true à send_campaign. L’accord donné pour une campagne ne vaut pas pour les suivantes. Le résultat send_requested signifie qu’AgentsMail a accepté la demande, pas que tous les emails sont arrivés. Suivez la progression avec get_campaign et les résultats avec get_campaign_stats.

Modifier les droits sans reconnecter l’agent

Ouvrez le menu à votre nom dans la barre latérale, choisissez Compte, puis l’onglet Droits du MCP. Vous y retrouvez trois interrupteurs : Lecture, Gestion et Envoi de campagnes. Modifiez vos choix puis cliquez sur Enregistrer les droits. Ils s’appliquent dès la prochaine demande, même pour un agent déjà connecté. Ces réglages sont personnels : couper la lecture la coupe pour toutes vos applications MCP, dans toutes les organisations auxquelles elles ont accès.

Fixer un plafond journalier

Sur la même page, renseignez Unités d’envoi par jour, puis cliquez sur Enregistrer les droits.

Valeur	Effet
Champ vide	Aucun plafond MCP journalier
`0`	Aucun envoi payant de campagne demandé par MCP
Entier positif	Maximum journalier dans les unités d’envoi habituelles

Le compteur est commun à vos applications et suit le fuseau horaire de votre compte. Il compte les unités réservées par les demandes d’envoi ; les demandes déjà prises en charge restent comptées même si l’envoi échoue. Avant de réessayer, vérifiez le compteur et le plafond. Le solde et les règles d’envoi de l’organisation continuent de s’appliquer.

Ce plafond couvre les campagnes demandées par MCP. Il ne plafonne pas les confirmations et automatisations déjà configurées que l’ajout d’un contact peut déclencher.

Révoquer une application

Applications connectées affiche chaque application, son adresse de retour, ses droits et les organisations autorisées. Révoquer bloque cette application dès sa prochaine demande dans toutes ces organisations et empêche le renouvellement de l’accès. Les demandes déjà en cours peuvent se terminer. Pour couper une famille d’actions pour toutes vos applications, désactivez le droit correspondant. Confirmez la révocation dans la fenêtre qui s’ouvre, ou choisissez Annuler pour garder la connexion. Pour autoriser à nouveau l’application, recommencez la connexion et vérifiez son organisation et ses droits.

Si la connexion échoue

Situation	Que faire
La page d’autorisation a expiré	Relancez la connexion depuis l’agent.
Une famille d’actions est désactivée	Réactivez le droit voulu dans Droits du MCP, puis enregistrez.
L’application n’a jamais demandé ce droit	Reconnectez-la avec les autorisations nécessaires.
Une liste ou une campagne est introuvable	Vérifiez l’organisation avec `get_account` et votre appartenance à celle-ci.
Le plafond d’envoi est atteint	Vérifiez le compteur ; ajustez le plafond ou attendez le jour suivant.
L’application a été révoquée	Reconnectez-la pour accorder un nouvel accès.

Un compte suspendu ne peut plus utiliser sa connexion. Si l’audience d’une campagne change après la demande d’envoi, celle-ci peut aussi être refusée : vérifiez sa cible et les unités disponibles avant de recommencer.

Voir aussi

Le skill AgentsMail complète ces outils avec les règles de rédaction et d’utilisation du produit. MCP expose les outils ci-dessus ; la référence API décrit l’API plus étendue.