Aller au contenu

Utiliser Mail Merge avec des agents IA (MCP)

Mail Merge dispose d’un serveur MCP public, de sorte qu’un agent IA que vous utilisez déjà peut lire vos Google Sheets, écrire des modèles, gérer les contacts et envoyer des campagnes via votre compte Mail Merge. Vous parlez à l’agent en langage naturel, l’agent appelle Mail Merge, et chaque email est toujours envoyé depuis votre propre compte Gmail avec les mêmes quotas, le suivi et la colonne d’état qu’une campagne lancée manuellement.

Le serveur expose les mêmes fonctionnalités que l’application web, regroupées en outils qu’un agent peut appeler: compte et forfait, Google Sheets, modèles, contacts, campagnes, analyses, warm-up et paramètres. L’agent ne voit que le compte avec lequel vous vous connectez, et seulement jusqu’à ce que vous le révoquez. Chaque agent connecté reçoit son propre jeton d’accès, listé sous Paramètres → Agents IA dans l’application web.

https://merge.email/mcp

Le serveur utilise le transport HTTP Streamable et OAuth 2.1. Quand votre assistant se connecte pour la première fois, une fenêtre de navigateur s’ouvre: connectez-vous avec le compte Google que vous utilisez avec Mail Merge, lisez la page de consentement qui nomme l’agent, et approuvez.

Claude (claude.ai)

  1. Ouvrez Paramètres → Connecteurs.
  2. Cliquez sur Ajouter un connecteur personnalisé.
  3. Collez https://merge.email/mcp comme URL et cliquez sur Connecter.
  4. Connectez-vous avec Google dans la fenêtre qui s’ouvre et approuvez l’agent.

Claude Desktop utilise le même chemin: Paramètres → Connecteurs → Ajouter un connecteur personnalisé.

Claude Code

claude mcp add --transport http mailmerge https://merge.email/mcp

Tapez ensuite /mcp dans une session, choisissez mailmerge et suivez le lien de connexion.

  1. Ouvrez Paramètres → Connecteurs.
  2. Choisissez Créer (dans certaines versions, c’est sous Avancé → Mode développeur).
  3. Entrez un nom, collez https://merge.email/mcp comme URL du serveur, choisissez OAuth et enregistrez.
  4. Connectez-vous avec Google quand vous y êtes invité et approuvez l’agent.

Ajoutez le serveur à .cursor/mcp.json dans votre projet (ou au fichier global depuis Paramètres Cursor → MCP):

{
"mcpServers": {
"mailmerge": {
"url": "https://merge.email/mcp"
}
}
}

La liste MCP affiche alors mailmerge avec un lien Connexion requise. Cliquez dessus, connectez-vous avec Google et approuvez l’agent.

N’importe quel client MCP qui supporte les serveurs distants via HTTP Streamable avec OAuth fonctionne de la même manière: pointez-le vers https://merge.email/mcp. Les clients qui recherchent les métadonnées du serveur les trouvent à:

https://merge.email/.well-known/oauth-protected-resource/mcp

L’enregistrement dynamique des clients et PKCE sont supportés, donc aucun ID client ou secret n’a besoin d’être configuré à l’avance.

Compte

Outil Ce qu’il fait
get_account Votre forfait, le quota d’aujourd’hui, les fonctionnalités incluses dans votre forfait (features, avec openTracking, clickTracking, scheduling et le reste marqués par forfait) et vos limits de bibliothèque (templates, contactLists; null signifie illimité).

La facturation, les changements d’abonnement et les sièges d’équipe sont gérés par vous uniquement dans l’application web: aucun outil ne lit les prix, n’ouvre le paiement ou ne déplace les sièges.

Google Sheets

Outil Ce qu’il fait
list_spreadsheets Les feuilles de calcul dans votre Google Drive.
list_sheets Les onglets d’une feuille de calcul.
read_sheet Les en-têtes et lignes d’une feuille, les données qu’une campagne fusionne.

Modèles

Outil Ce qu’il fait
list_templates Vos modèles enregistrés, ou avec scope: "team" ceux partagés par les personnes de votre abonnement d’équipe.
get_template Le sujet et le corps d’un modèle; avec owner, le modèle partagé d’un coéquipier.
create_template Enregistre un nouveau modèle. Sur le forfait Gratuit, jusqu’à 3 modèles enregistrés; au-delà, il répond premium_required.
update_template Change le nom, le sujet ou le corps d’un modèle.
delete_template Supprime un modèle.
duplicate_template Copie un modèle.
generate_template Écrit un modèle avec l’IA à partir d’un résumé, en correspondant optionnellement aux colonnes d’une feuille d’exemple.
import_google_doc Transforme un Google Doc en modèle.

Contacts

Outil Ce qu’il fait
list_contacts Vos contacts, avec des filtres pour les désabonnés et la liste de blocage.
get_contact_segments Comment votre carnet de contacts se divise par secteur, classé par l’IA en arrière-plan à partir de l’adresse de chaque contact et des champs de fusion: comptages par secteur et combien sont encore en attente. Sur Professional, list_contacts peut ensuite être filtré par industry; sur les autres forfaits, les comptages sont informatifs et les étiquettes par contact ne sont pas affichées. Voir Contacts.
add_contact Ajoute un contact.
import_contacts Ajoute plusieurs contacts à la fois.
delete_contacts Supprime des contacts.
block_contacts Place les adresses sur la liste de blocage pour qu’aucune campagne ne les contacte.
unblock_contacts Supprime les adresses de la liste de blocage.
list_contact_lists Vos listes de contacts.
create_contact_list Crée une liste.
rename_contact_list Renomme une liste.
delete_contact_list Supprime une liste (les contacts restent).
add_contacts_to_list Ajoute des contacts à une liste.
remove_contacts_from_list Supprime des contacts d’une liste.

Campagnes

Outil Ce qu’il fait
list_campaigns Vos campagnes actives, planifiées et terminées.
get_campaign Une campagne avec sa progression et ses paramètres.
get_campaign_recipients Les statuts par destinataire d’une campagne.
get_sequence_stats Comment une séquence de suivi fonctionne: par étape, envoyés, ouverts, cliqués, répondus et ignorés, la condition de l’étape, et les résultats du test A/B du sujet du premier email quand il en a exécuté un.
check_quota Combien d’emails vous pouvez encore envoyer aujourd’hui et si une campagne rentre dans le quota.
send_test_email Envoie un rendu de test à votre propre adresse.
send_campaign Lance une campagne à partir d’une feuille, d’une liste de contacts ou d’une liste de destinataires tapée: maintenant, planifiée (scheduleAt, forfaits payants), ou en tant qu’Autopilot (Professional), avec trackClicks pour activer ou désactiver le suivi des clics (Personal et plus; omis, le défaut du forfait s’applique) et un suivi optionnel (followUp.condition: always, notOpened, notClicked, opened ou clicked) ou un test A/B du sujet (abTest.subjects, deux ou trois lignes de sujet, avec autoWinner sur les campagnes de goutte-à-goutte). Supporte skipInvalidRecipients pour exclure les adresses que verify_recipients a trouvées invalides. Chaque destinataire en ligne peut porter fields - des valeurs de fusion indexées par nom de balise, ce qui est aussi comment les valeurs de generate_ai_field se déplacent.
pause_campaign Met en pause une campagne en cours.
resume_campaign Reprend une en pause.
stop_campaign Arrête une campagne définitivement.
reschedule_campaign Change la date d’envoi d’une campagne planifiée (forfaits payants).
update_autopilot Change le volume quotidien et la fenêtre d’une campagne Autopilot.
delete_scheduled_campaign Supprime une campagne planifiée avant qu’elle ne commence.

Analyses

Outil Ce qu’il fait
get_analytics Envois, ouvertures et clics au fil du temps, avec les taux et les meilleurs liens; avec scope: "team", ceux de toute l’équipe (Professional, propriétaire de l’abonnement).
get_activity Qui a ouvert, cliqué et se désabonné, destinataire par destinataire.
get_account_events L’historique de tout ce qui s’est passé sur votre compte.

Warm-up

Outil Ce qu’il fait
get_warmup Le statut et la tendance de réputation de votre warm-up. Le warm-up lui-même est activé par vous dans l’application web, où l’identifiant de la boîte aux lettres est entré: aucun outil ne le demande.
pause_warmup Met en pause le warm-up.
resume_warmup Le reprend.
stop_warmup L’arrête.
update_warmup_settings Change le volume quotidien et la montée en charge.
check_email_reputation Exécute la vérification gratuite de réputation sur une adresse ou un domaine.

Paramètres

Outil Ce qu’il fait
set_throttle Définit la vitesse d’envoi: aussi rapide que possible, un délai fixe, ou un délai aléatoire entre les emails.

Délivrabilité

Outil Ce qu’il fait
verify_recipients Vérifie une liste d’adresses avant un envoi (Professional): valide, risqué ou invalide avec une raison, sans envoyer d’email à personne. Voir Délivrabilité.
get_domain_compliance Le propre verdict de Google sur votre domaine d’envoi à partir de Gmail Postmaster Tools (Professional): le statut de conformité des exigences d’expéditeur et les 30 derniers jours de taux de spam, succès d’authentification et erreurs de livraison. Le domaine doit être enregistré et vérifié dans Postmaster Tools; le premier appel demande une permission supplémentaire. Voir Délivrabilité.
list_postmaster_domains Les domaines enregistrés dans Postmaster Tools sous votre compte Google, vérifiés ou non.
add_postmaster_domain Enregistre un domaine que vous possédez dans Postmaster Tools et retourne l’enregistrement DNS qui prouve la propriété. Ajoutez-le chez votre fournisseur DNS, puis vérifiez.
verify_postmaster_domain Demande à Google de vérifier l’enregistrement DNS. Si Google ne peut pas le voir encore, attendez quelques minutes et réessayez.

Personnalisation par IA

Outil Ce qu’il fait
generate_ai_field Écrit une courte ligne personnalisée par ligne avec l’IA (Professional), à partir des propres colonnes de la ligne - une accroche à partir des colonnes Entreprise et Site Web, par exemple. Rien n’est envoyé ou enregistré: l’agent récupère les valeurs (100 lignes par appel, 2 000 lignes par jour) et les transmet via les fields par destinataire de send_campaign, sous le nom du champ, avec {{Field}} dans le sujet ou le corps. Voir Champs IA.

Une fois connecté, posez des questions à l’agent comme vous le feriez avec un collègue:

  • “Lisez l’onglet Leads de ma feuille de calcul Q4 outreach, écrivez un court email de suivi qui utilise les colonnes prénom et entreprise, et envoyez-moi un test.”
  • “Combien d’emails puis-je encore envoyer aujourd’hui? Si le modèle Webinar invite rentre, planifiez-le à la liste de contacts Webinar pour demain à 9h.”
  • “Quelle campagne du mois dernier a eu le meilleur taux d’ouverture, et qui a cliqué sur le lien de tarification?”
  • “Mettez en pause la campagne Partners et bloquez tous ceux qui ont répondu en demandant à être supprimés.”

Un agent a exactement les permissions de votre forfait. Rien n’est déverrouillé en en connectant un.

Gratuit Personnel Professional
Emails par jour 50 250 500 avec une adresse Gmail, 1 500 avec Google Workspace
Suivi des ouvertures Oui Oui Oui
Suivi des clics (trackClicks) Oui Oui
Planification et replanification (scheduleAt, reschedule_campaign) Oui Oui
Modèles et listes de contacts enregistrés 3 modèles, 1 liste Illimité Illimité
Délais, historique des campagnes Oui Oui
Analyses et activité Oui Oui
Autopilot, séquences de suivi et tests A/B du sujet Oui
Warm-up des emails Oui

Quand un agent appelle un outil que votre forfait n’inclut pas, l’appel n’échoue pas silencieusement: l’outil répond avec un message expliquant quel forfait est nécessaire (premium_required pour une fonctionnalité Personal, professional_plan_required pour une Professional), que l’agent vous montre. Sur le forfait Gratuit, c’est ce que send_campaign avec scheduleAt ou trackClicks, reschedule_campaign, et create_template, duplicate_template, import_google_doc, generate_template ou create_contact_list au-delà de la limite de bibliothèque répondent. La limite s’applique uniquement à la création de nouveaux éléments: rien de déjà enregistré n’est supprimé. get_account rapporte les limits pour que l’agent puisse vérifier avant d’essayer. Les changements de forfait sont faits par vous dans l’application web, jamais via un agent. Le quota quotidien fonctionne de la même manière: check_quota dit à l’agent ce qui rentre aujourd’hui, et une campagne qui ne rentre pas est reportée ou refusée exactement comme elle le serait dans l’application web. Voir Tarification et abonnement et Limites d’envoi quotidien.

  • L’agent confirme avant d’envoyer. Avant send_campaign, l’agent est instruit de vous montrer le nombre de destinataires, le modèle et l’heure d’envoi, et d’attendre votre feu vert. Lisez ce résumé aussi attentivement que vous liriez le bouton d’envoi.
  • Vérification du quota. check_quota vous dit combien du quota d’aujourd’hui une campagne utiliserait, pour qu’une grande liste ne vous surprenne pas.
  • La colonne d’état est toujours là. Une campagne lancée à partir d’une Google Sheet par un agent remplit la même colonne d’état 📮 qu’une lancée à partir de l’add-on, pour que vous puissiez la suivre ligne par ligne dans la feuille de calcul et dans Campagnes.
  • Mettez en pause ou arrêtez à tout moment, à partir de l’agent, de l’application web ou de l’add-on.

Ouvrez merge.email/app → Paramètres → Agents IA. La carte liste chaque agent connecté avec la date de connexion et la dernière utilisation. Cliquez sur Révoquer à côté d’un agent pour couper son accès immédiatement; l’appel suivant qu’il fait est refusé et il doit passer par la connexion à nouveau.

Paramètres des agents IA

Révoquer un agent ne touche pas à votre connexion Google ou à vos autres agents. Pour supprimer aussi l’accès propre de Mail Merge à votre compte Google, allez à myaccount.google.com/connections, ce qui déconnecte tous les agents à la fois et arrête aussi toute campagne en cours (voir Reconnecter votre compte Google).

  • OAuth 2.1 avec PKCE. L’agent ne voit jamais votre mot de passe Google, et vous ne tapez jamais de mot de passe dans l’agent. Vous vous connectez sur la propre page de Google et approuvez sur une page de consentement Mail Merge qui nomme l’agent.
  • Un jeton par agent. Chaque connexion reçoit son propre jeton avec sa propre expiration et rafraîchissement, donc révoquer un agent laisse les autres fonctionner.
  • La révocation est immédiate, depuis Paramètres → Agents IA ou depuis votre compte Google.
  • Les mêmes règles de données que l’application. Un agent lit et écrit exactement ce que l’application web peut, rien de plus, et Mail Merge ne stocke rien de nouveau en son nom. Voir Permissions et données.