Elastic Email MCP Server

officiel

Le 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.

Documentation

En implémentant MCP, Elastic Email permet aux agents IA d’accéder et de contrôler vos opérations d’email 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
  • Importer 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 : à la fois transactionnels et en masse
  • Récupérer un contact, des contacts, un contact d’une liste
  • Récupérer les listes
  • Récupérer les modèles
  • Récupérer les segments
  • Est prêt (vérification de santé, vérification 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 des campagnes et des contacts ne sont pas disponibles pour les plans Email API. Voici la liste complète de nos articles disponibles sur les fonctionnalités listé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

Afin de 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 de manière programmatique avec des services externes de façon sécurisée.

Nous avons préparé un exemple de configuration étape par étape utilisant VS Code et les outils Github Copilot.

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.

  • Passez le chat en mode Agent

  • Créez une clé API dans Elastic Email. Les autorisations requises pour afficher et modifier sont les suivantes : Compte, Modèles, Campagnes, Contacts, Fichiers, Envoyer HTTP. En plus de cela, au moins un accès en « affichage » aux Jetons d’accès 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 : Afficher et exécuter des commandes

  • Vous pouvez écrire « MCP » dans le champ de recherche pour affiner les options disponibles et choisir « MCP : Ouvrir la configuration utilisateur ».

  • 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": "votre_clé_api"
}
}
}
}

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 enregistrer les modifications, l’option pour « démarrer » l’intégration n’apparaîtra pas.

  • Vous pouvez maintenant initier la connexion au serveur MCP : cliquez sur Démarrer au-dessus d’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 Démarrer le serveur

À partir de maintenant, vous pouvez utiliser les actions fournies par le serveur MCP Elastic Email 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 afin de vous assurer que l’intégration fonctionne. Vous pouvez saisir l’invite « Is MCP working » par exemple et si tout fonctionne, vous devriez recevoir une confirmation en réponse.

Afin de 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

  1. Les agents IA peuvent rester bloqués en se souvenant de certaines instructions précédentes et en les réessayant. 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 dire qu’il y a eu des changements sur le serveur pour s’assurer qu’il récupère bien les nouvelles données.
  2. 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.
  3. Il est utile de vérifier les requêtes avant de les envoyer, car vous pourriez remarquer des incohérences potentielles dans la manière dont le LLM a traduit votre demande en appels API.