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/mcpDans Claude Code
/mcpagentsmail, 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/mcpCodex · autorisation
codex mcp login agentsmail/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.
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, puislist_lists. Vérifiez l’organisation indiquée et retrouvez une liste que vous connaissez avant de demander une modification.
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, get_contact, list_tags, list_templates, list_campaigns, get_campaign, get_campaign_stats, list_sequences, list_media, list_custom_fields |
Gestion (mcp:manage) | create_list, upsert_contact, update_contact, create_template, create_campaign, update_campaign, upload_media, delete_media, create_custom_field, rename_custom_field, delete_custom_field |
Envoi de campagnes (mcp:send) | send_campaign, schedule_campaign, unschedule_campaign |
Rester connecté (offline_access) | Maintient la connexion quand un jeton d’accès de courte durée expire. |
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. update_campaign modifie un brouillon avec les mêmes champs que l’API : un champ omis reste inchangé, null retire une valeur, et une campagne qui n’est plus un brouillon est refusée. upload_media accepte l’adresse https publique d’une image (url), téléchargée par AgentsMail et vérifiée sur son contenu, ou une petite image en base64, jamais les deux.
Ajouter un contact peut déclencher vos emails de confirmation et vos automatisations configurées. La suppression d’un média est définitive. Supprimer un champ personnalisé efface sa valeur sur tous les contacts :
delete_custom_field exige confirmation: true, transmis seulement après votre accord pour ce champ. 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 transmettreconfirmation: true à send_campaign. L’accord donné pour une campagne ne vaut pas pour les suivantes.
La programmation suit la même règle : schedule_campaign réserve un envoi réel à l’heure que vous approuvez, et exige aussi confirmation: true. Il programme un brouillon ou déplace une campagne déjà programmée. send_campaign envoie immédiatement ; unschedule_campaign remet une campagne programmée ou en pause en brouillon, sans rien envoyer.
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 |
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. |