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, suivi et colonne de statut 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 plan, 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évoquiez. 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. Lors de la première connexion de votre assistant, une fenêtre de navigateur s’ouvre: connectez-vous avec le compte Google que vous utilisez avec Mail Merge, lisez la page de consentement nommant 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

Ensuite, tapez /mcp dans une session, sélectionnez 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, sélectionnez 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.

Tout 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 consultent les métadonnées du serveur les trouvent à:

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

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

Compte

OutilCe qu’il fait
get_accountVotre plan, le quota d’aujourd’hui et les fonctionnalités incluses dans votre plan.
get_pricingLes plans et prix actuels.
get_subscriptionVotre statut d’abonnement, la période de facturation et la date de renouvellement.
get_billing_portal_linkUn lien vers le portail de facturation (factures, mode de paiement, changements de plan).
get_team_seatsLes sièges de votre abonnement d’équipe et qui les occupe.
assign_team_seatAttribue un siège à un collègue.
unassign_team_seatReprend un siège.

Google Sheets

OutilCe qu’il fait
list_spreadsheetsLes feuilles de calcul dans votre Google Drive.
list_sheetsLes onglets d’une feuille de calcul.
read_sheetLes en-têtes et lignes d’une feuille, les données qu’une campagne fusionne.

Modèles

OutilCe qu’il fait
list_templatesVos modèles enregistrés.
get_templateL’objet et le corps d’un modèle.
create_templateEnregistre un nouveau modèle.
update_templateChange le nom, l’objet ou le corps d’un modèle.
delete_templateSupprime un modèle.
duplicate_templateCopie 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 exemple.
import_google_docTransforme un Google Doc en modèle.

Contacts

OutilCe qu’il fait
list_contactsVos contacts, avec des filtres pour les désabonnés et la liste de blocage.
add_contactAjoute un contact.
import_contactsAjoute plusieurs contacts à la fois.
delete_contactsSupprime des contacts.
block_contactsPlace les adresses sur la liste de blocage pour qu’aucune campagne ne les envoie.
unblock_contactsSupprime les adresses de la liste de blocage.
list_contact_listsVos listes de contacts.
create_contact_listCrée une liste.
rename_contact_listRenomme une liste.
delete_contact_listSupprime une liste (les contacts restent).
add_contacts_to_listAjoute des contacts à une liste.
remove_contacts_from_listSupprime des contacts d’une liste.

Campagnes

OutilCe qu’il fait
list_campaignsVos campagnes actives, planifiées et terminées.
get_campaignUne campagne avec sa progression et ses paramètres.
get_campaign_recipientsLes statuts par destinataire d’une campagne.
get_sequence_statsComment une séquence de suivi fonctionne.
check_quotaCombien d’emails vous pouvez encore envoyer aujourd’hui et si une campagne rentre dans le quota.
send_test_emailEnvoie un test rendu à votre propre adresse.
send_campaignLance une campagne à partir d’une feuille, d’une liste de contacts ou d’une liste tapée de destinataires: maintenant, planifiée, ou en Autopilot, avec un suivi optionnel. Supporte un essai à blanc qui rapporte ce qui serait envoyé sans envoyer.
pause_campaignMet en pause une campagne en cours.
resume_campaignReprend une campagne en pause.
stop_campaignArrête une campagne définitivement.
reschedule_campaignChange la date d’envoi d’une campagne planifiée.
update_autopilotChange le volume quotidien et la fenêtre d’une campagne Autopilot.
delete_scheduled_campaignSupprime une campagne planifiée avant qu’elle ne commence.

Analyses

OutilCe qu’il fait
get_analyticsEnvois, ouvertures et clics au fil du temps, avec les taux et les meilleurs liens.
get_activityQui a ouvert, cliqué et se désabonné, destinataire par destinataire.
get_account_eventsL’historique de tout ce qui s’est passé sur votre compte.

Warm-up

OutilCe qu’il fait
get_warmupLe statut et la tendance de réputation de votre warm-up.
enable_warmupCommence à réchauffer votre boîte aux lettres.
pause_warmupMet en pause le warm-up.
resume_warmupLe reprend.
stop_warmupL’arrête.
update_warmup_settingsChange le volume quotidien et la montée en puissance.
check_email_reputationLance la vérification de réputation gratuite sur une adresse ou un domaine.

Paramètres

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

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

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

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

GratuitPersonnelProfessionnel
Emails par jour50250500 avec une adresse Gmail, 1 500 avec Google Workspace
Planification, délais, historique des campagnesOuiOui
Analyses et activitéOuiOui
Autopilot et séquences de suiviOui
Warm-up d’emailOui

Quand un agent appelle un outil que votre plan n’inclut pas, l’appel n’échoue pas silencieusement: l’outil répond avec un message expliquant quel plan est nécessaire et un lien pour mettre à niveau, que l’agent vous montre. Le quota quotidien fonctionne de la même manière: check_quota indique à l’agent ce qui rentre aujourd’hui, et une campagne qui ne rentre pas est reportée ou refusée exactement comme 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 invité à vous montrer le nombre de destinataires, le modèle et l’heure d’envoi, et à attendre votre feu vert. Lisez ce résumé aussi attentivement que vous le feriez pour le bouton d’envoi.
  • Essai à blanc d’abord. Demandez un essai à blanc et l’agent rapporte ce qui serait envoyé (destinataires, objet, champs de fusion) sans rien envoyer.
  • Vérification du quota. check_quota vous indique combien du quota d’aujourd’hui une campagne utiliserait, de sorte qu’une grande liste ne vous surprenne pas.
  • La colonne de statut est toujours là. Une campagne lancée à partir d’une Google Sheet par un agent remplit la même colonne de statut 📮 qu’une lancée depuis l’add-on, de sorte que vous pouvez la suivre ligne par ligne dans la feuille de calcul et dans Campagnes.
  • Mettez en pause ou arrêtez à tout moment, depuis l’agent, depuis l’application web ou depuis 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; le prochain appel qu’il fait est refusé et il doit se reconnecter.

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 sur 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, de sorte que 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.