Elastic Email MCP
officielLe serveur Elastic Email MCP permet aux agents d'IA comme GitHub Copilot, ChatGPT, Claude et autres assistants compatibles de s'intégrer de manière transparente à votre compte Elastic Email.
Que pouvez-vous faire avec Elastic Email MCP ?
- Ajouter un contact à une liste — Demandez à votre assistant d’ajouter un abonné à une liste de contacts spécifique.
- Créer et gérer des campagnes — Créez, mettez à jour, mettez en pause ou listez des campagnes e-mail à l’aide de
create_campaign,update_campaign,pause_campaignetlist_campaigns. - Envoyer des e-mails en masse et transactionnels — Demandez à l’IA d’envoyer des e-mails directement via votre compte Elastic Email.
- Récupérer les ressources du compte — Récupérez les contacts, listes, segments et modèles existants pour consulter ce qui est déjà configuré.
- Supprimer des contacts — Supprimez un contact d’une liste spécifique ou de l’ensemble du compte.
- Vérifier l’état de la connexion — Vérifiez que le serveur MCP est connecté et opérationnel via un test de santé.
Documentation
En implémentant MCP, Elastic Email permet aux agents IA d'accéder à vos opérations d'email et de les contrôler tout en maintenant la sécurité et une authentification appropriée.
Actions disponibles que notre MCP pourra effectuer pour vous
- Ajouter un contact à une liste
- Téléverser et ajouter des contacts
- Créer une liste
- Créer un segment
- Créer une campagne
- Obtenir les campagnes
- Mettre à jour une campagne
- Mettre en pause une campagne
- Lister les campagnes
- Envoyer des emails : transactionnels et en masse
- Récupérer un contact, des contacts, un contact depuis une liste
- Récupérer les listes
- Récupérer les modèles
- Récupérer les segments
- Vérifier l'état (contrôle de santé, de connexion et de disponibilité)
- Supprimer un contact d'une liste
- Supprimer un contact du compte
Veuillez noter que tous les points de terminaison listés ne sont pas disponibles pour tous les plans tarifaires d'Elastic Email. Par exemple, les points de terminaison de campagnes et de contacts ne sont pas disponibles pour les plans Email API. Voici la liste complète de nos articles disponibles sur les fonctionnalités mentionnées ci-dessus :
https://help.elasticemail.com/en/articles/4984897-contact-lists-and-segments
https://help.elasticemail.com/en/articles/5472509-how-to-send-your-first-campaign
http://help.elasticemail.com/en/articles/2300606-how-to-manage-templates
Configuration
Pour vous connecter à notre serveur MCP, vous pouvez utiliser n'importe quel agent IA prenant en charge MCP. L'exigence clé pour toute configuration est la prise en charge du « mode agent », qui permet à l'agent IA d'interagir programmatiquement avec des services externes en toute sécurité.
Nous avons préparé un exemple de configuration étape par étape utilisant VS Code et les outils Github Copilot.
- https://github.com vous devrez créer un compte gratuit sur Github
- https://code.visualstudio.com/ téléchargez VS Code depuis ce site web
Ensuite, vous devrez connecter votre compte Github à VS Code
-
Installez et exécutez VS Code
-
Ouvrez les extensions dans le menu de gauche et installez les extensions Github Copilot et Github Copilot Chat
-
Connectez-vous à Github en utilisant le compte que vous avez créé à l'étape précédente
-
Autorisez Visual Studio Code dans Github Copilot
-
Autorisez l'exécution de VS Code à l'étape suivante
-
Pour afficher la fenêtre de chat, allez dans Affichage → Chat dans le menu supérieur de VS Code. Le chat devrait s'afficher sur le côté droit.
-
Basculez le chat en mode Agent
-
Créez une clé API dans Elastic Email. Les autorisations requises pour visualiser et modifier sont les suivantes : Account, Templates, Campaigns, Contacts, Files, Send HTTP. En plus de cela, au moins un accès « view » aux Access Tokens est requis. N'oubliez pas de ne jamais partager votre clé API avec des tiers non autorisés !
-
Dans la barre supérieure de VS Code, utilisez la fonction de recherche pour trouver : Show and run commands
-
Vous pouvez écrire « MCP » dans le champ de recherche pour réduire les options disponibles et choisir « MCP: Open user configuration ».
-
Collez le texte de configuration comme ci-dessous (si vous avez déjà des serveurs, seules les données elasticemail.mcp suffiront)
{
"servers": {
"elasticemail.mcp": {
"url": "https://mcp.elasticemail.com",
"headers": {
"X-Auth-Token": "your_api_key"
}
}
}
}
Veuillez noter que l'étape la plus importante ici est de saisir votre clé API réelle avec les autorisations mentionnées ci-dessus. Assurez-vous également qu'après avoir modifié ce champ, vous enregistrez les modifications avant de continuer. Sans l'enregistrement des modifications, l'option permettant de « démarrer » l'intégration n'apparaîtra pas.
-
Vous pouvez maintenant initier la connexion au serveur MCP : cliquez sur Start au-dessus de elasticemail.mcp dans le fichier de configuration.
-
Méthode alternative : Choisissez Extensions dans le menu de gauche, sélectionnez le serveur dans MCP SERVERS INSTALLED en bas, faites un clic droit et choisissez Start server
À partir de maintenant, vous pouvez utiliser les actions fournies par le serveur Elastic Email MCP dans la fenêtre de chat. Ces actions ont été décrites au début de cet article.
Vous pouvez essayer votre première commande pour vous assurer que l'intégration fonctionne. Vous pouvez saisir la commande « Is MCP working » comme exemple et si tout fonctionne, vous devriez recevoir une confirmation en réponse.
Pour mieux comprendre comment ce type d'intégration fonctionne du côté d'Elastic Email, n'hésitez pas à consulter également notre documentation API :
https://elasticemail.com/developers/api-documentation/rest-api
Conseils
- Les agents IA peuvent rester bloqués sur des instructions précédentes et les réessayer. Il est utile de démarrer une nouvelle session de chat pour résoudre ces problèmes. Vous pouvez également demander à l'agent de récupérer à nouveau les outils et lui indiquer qu'il y a eu des changements sur le serveur pour garantir qu'il récupère réellement les nouvelles données.
- Plus l'invite est précise, moins vous laissez de place à l'interprétation pour le LLM, réduisant ainsi les problèmes liés aux hallucinations.
- Il est utile de vérifier les requêtes avant de les envoyer, car vous pourriez remarquer des incohérences potentielles dans la façon dont le LLM a traduit votre demande en appels API.