Qu'est-ce que le serveur MCP Mailjet

Le MCP Mailjet est l'assistant IA Claude Desktop qui lit les données Mailjet de votre compte en utilisant votre clé API. Une fois configuré, vous pouvez demander à Claude les performances des campagnes, les listes de contacts ou les statistiques, et il récupérera les informations via l'API Mailjet.

MCP (Model Context Protocol) est un moyen pour les outils IA de se connecter à des services externes. Le serveur MCP Mailjet est un petit service qui s'exécute sur votre ordinateur et expose les APIs Mailjet à Claude. Cela permet à Claude de répondre aux questions en utilisant des données en temps réel de votre compte Mailjet.

Ce dont vous avez besoin avant de commencer

Cette configuration demande à un utilisateur non technique d'effectuer quelques opérations techniques. Pour faciliter cela, nous vous montrerons les outils nécessaires et comment les installer.

• Mailjet compte avec une clé API et une clé secrète actives
• Claude Desktop installé 
• Git pour télécharger le serveur MCP Mailjet depuis GitHub
• Node.js pour exécuter le serveur MCP
• pnpm pour installer les fichiers du serveur MCP
• Permission pour modifier la configuration de Claude Desktop

Étape 1. Télécharger le projet

Vous allez télécharger le serveur MCP Mailjet depuis le dépôt officiel GitHub et vous déplacer dans ce dossier.

1. Ouvrez le Terminal (Mac) ou l'Invite de commandes (Windows).

2. Exécutez :

   git clone https://github.com/mailgun/mailjet-mcp-server.git
   cd mailjet-mcp-server
   

La première commande télécharge le serveur MCP dans un nouveau dossier. La deuxième commande vous place dans ce dossier pour que les commandes suivantes fonctionnent.

Étape 2. Installer les dépendances

Ensuite, installez les paquets nécessaires au serveur.

pnpm install

Étape 3. Démarrer (allumer) le serveur MCP

Cette étape démarre le programme MCP Mailjet pour que Claude puisse s'y connecter.

1. Assurez-vous d'être toujours dans le dossier mailjet-mcp-server.

2. Exécutez :

   node src/mailjet-mcp.js
   

Cela lance le serveur MCP Mailjet sur votre ordinateur. Vous pouvez voir quelques lignes de texte. Cela signifie qu'il fonctionne.

Étape 4. Connecter Claude Desktop

Claude Desktop utilise un fichier de configuration JSON pour savoir quels serveurs MCP charger. Ajoutez le serveur MCP Mailjet pour que Claude puisse le trouver.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mailjet": {
      "command": "node",
      "args": ["/VOTRE/CHEMIN/mailjet-mcp-server/src/mailjet-mcp.js"],
      "env": {
        "MAILJET_API_KEY": "VOTRE_cle_publique:VOTRE_cle_privee"
      }
    }
  }
}

%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mailjet": {
      "command": "node",
      "args": ["C:\\CHEMIN\\VERS\\mailjet-mcp-server\\src\\mailjet-mcp.js"],
      "env": {
        "MAILJET_API_KEY": "VOTRE_cle_publique:VOTRE_cle_privee"
      }
    }
  }
}

Variables d'environnement

Le serveur MCP Mailjet supporte les variables d'environnement suivantes.

Vous pouvez définir ces variables dans votre système ou directement dans la configuration Claude dans la section env.

Tester la configuration

Le projet inclut une suite de tests locale. Pour l'exécuter :

NODE_ENV=test pnpm test

Si les tests passent sans erreurs, votre installation fonctionne.

Dépannage

• Claude n'affiche pas les outils Mailjet
  Vérifiez que le chemin dans claude_desktop_config.json pointe vers votre vrai fichier mailjet-mcp-server/src/mailjet-mcp.js. Redémarrez Claude.
• Erreur d'authentification
  Assurez-vous que la valeur API utilise le format CLE_PUBLIQUE:CLE_PRIVEE. Si le deux-points manque, l'authentification échoue.
• Le serveur se ferme immédiatement
  Exécutez node src/mailjet-mcp.js depuis l'intérieur du dossier mailjet-mcp-server.
• Compte UE ne se charge pas
  Définissez MAILJET_API_REGION=eu dans votre environnement ou dans la section env de la configuration Claude.

Utilisation du MCP Mailjet dans Claude Desktop

Une fois que le serveur MCP fonctionne et que Claude Desktop a redémarré, vous pouvez commencer à l'utiliser.

1. Ouvrez Claude Desktop.
2. Posez une question liée à Mailjet, par exemple : Quelle est ma liste de contacts avec le plus d'abonnés.
3. Claude détectera qu'il doit contacter Mailjet et affichera une boîte similaire à : Claude souhaite utiliser Get v3 liststatistics de mailjet.

4. Vous verrez des boutons tels que Refuser, Autoriser une fois et Toujours autoriser.

   • Autoriser une fois permet à Claude de faire cette seule requête à Mailjet maintenant.
   • Toujours autoriser indique à Claude qu'il peut utiliser le serveur MCP Mailjet pour les futures requêtes sans redemander.
   • Refuser bloque la requête et Claude n'obtiendra pas de données Mailjet.

   

   1. Choisissez Autoriser une fois si vous voulez juste tester la configuration
   2. Choisissez Toujours autoriser si vous souhaitez permettre à Claude d'exécuter la requête à chaque fois sans avoir à redemander la permission.

5. Après avoir autorisé la requête, Claude appellera le serveur MCP Mailjet, récupérera les données et répondra avec le résultat, par exemple une liste de vos listes de contacts et leur nombre d'abonnés.