Le serveur MCP ActiveTrail permet à un assistant d'IA de lire votre compte : contacts, rapports de campagnes pour tous les canaux et automations. Il est en lecture seule et disponible avec les forfaits Plus et supérieurs. Pour Claude, la méthode la plus rapide est décrite dans Connecter ActiveTrail à Claude.
Avant de commencer
Il vous faut un compte ActiveTrail avec le forfait Plus ou supérieur, et un outil d'IA (client MCP) capable d'envoyer un en-tête de requête personnalisé.
|
Paramètre |
Valeur |
|---|---|
|
URL du serveur |
|
|
Transport |
Streamable HTTP (à distance, rien à installer) |
|
Nom de l'en-tête |
|
|
Valeur de l'en-tête |
Votre clé API telle quelle, sans |
|
Accès |
Lecture seule |
|
Forfait |
Plus et supérieurs |
Le serveur se contente de lire les données. Il ne peut rien créer, modifier, envoyer ni supprimer dans votre compte.
Obtenir votre clé API
Le serveur MCP utilise une clé API ActiveTrail standard.
-
Connectez-vous à ActiveTrail.
-
Allez dans Intégrations → API → Clés API.
-
Créez une nouvelle clé API et copiez-la.
-
Enregistrez-la immédiatement dans un gestionnaire de mots de passe. Elle ne s'affiche qu'une seule fois et ne peut pas être récupérée par la suite.
La clé donne le même accès que l'API : traitez-la comme un mot de passe. Créez une clé distincte pour chaque personne ou chaque outil, afin de pouvoir en révoquer une sans bloquer les autres. Ne la placez jamais dans un fichier de configuration ou un dépôt partagé.
Outils d'IA compatibles
Tout outil qui prend en charge les serveurs Streamable HTTP distants avec un en-tête Authorization personnalisé peut se connecter.
|
Outil |
Méthode |
|---|---|
|
Claude (connecteurs web et bureau) |
Connecteur personnalisé avec en-têtes de requête (recommandé) |
|
Claude Code |
|
|
Claude Desktop |
Passerelle |
|
Cursor |
|
|
VS Code (GitHub Copilot) |
|
|
Gemini CLI |
|
|
OpenAI Codex |
|
|
Windsurf |
|
Configurer votre outil
Remplacez YOUR_ACTIVETRAIL_API_KEY par votre clé. Si l'outil lit les variables d'environnement, définissez la clé une seule fois et laissez-la hors du fichier de configuration :
# macOS / Linux: add to ~/.zshrc or ~/.bashrc
export ACTIVETRAIL_API_KEY="YOUR_ACTIVETRAIL_API_KEY"
# Windows (PowerShell), then restart the tool
setx ACTIVETRAIL_API_KEY "YOUR_ACTIVETRAIL_API_KEY"La valeur de l'en-tête est la clé seule. N'ajoutez pas Bearer.
Claude (connecteurs web et bureau)
La méthode recommandée pour Claude, sur les comptes personnels et les comptes d'organisation.
-
Ouvrez la fenêtre de connecteur personnalisé :
-
Free, Pro, Max : Customize → Connectors → Add custom connector (Personnaliser → Connecteurs → Ajouter un connecteur personnalisé).
-
Team, Enterprise : un Owner (propriétaire) ouvre Organization settings → Connectors → Add → Custom. Les membres se connectent ensuite depuis Customize → Connectors.
-
-
URL du serveur :
https://mcp.activetrail.com/v1 -
Authentification : No sign-in (sans connexion).
-
Sous Request headers (en-têtes de requête), choisissez
authorizationet collez votre clé comme valeur, sansBearer. -
Cliquez sur Add.
Si la fenêtre n'a pas de section Request headers, votre compte Claude ne la propose pas : utilisez la configuration Claude Desktop ci-dessous. Avec Team et Enterprise, l'Owner définit l'en-tête une seule fois : tous les membres partagent alors cette même clé et ses accès.
Claude Code
claude mcp add --transport http --scope user activetrail https://mcp.activetrail.com/v1 --header "Authorization: YOUR_ACTIVETRAIL_API_KEY"Vérifiez avec claude mcp list, ou /mcp dans une session.
Claude Desktop
Nécessite Node.js (pour npx). Ouvrez Settings → Developer → Edit Config (Paramètres → Développeur → Modifier la configuration) et ajoutez :
{
"mcpServers": {
"activetrail": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.activetrail.com/v1",
"--header",
"Authorization:${ACTIVETRAIL_API_KEY}"
],
"env": {
"ACTIVETRAIL_API_KEY": "YOUR_ACTIVETRAIL_API_KEY"
}
}
}
}Gardez Authorization:${ACTIVETRAIL_API_KEY} sans espace après les deux-points : les espaces dans args provoquent une erreur sous Windows. Quittez puis rouvrez Claude Desktop.
Cursor
Modifiez ~/.cursor/mcp.json (tous les projets) ou .cursor/mcp.json (un seul projet) :
{
"mcpServers": {
"activetrail": {
"url": "https://mcp.activetrail.com/v1",
"headers": {
"Authorization": "${env:ACTIVETRAIL_API_KEY}"
}
}
}
}Redémarrez Cursor.
VS Code (GitHub Copilot)
Exécutez MCP: Open User Configuration depuis la palette de commandes et ajoutez :
{
"inputs": [
{
"type": "promptString",
"id": "activetrail-key",
"description": "ActiveTrail API key",
"password": true
}
],
"servers": {
"activetrail": {
"type": "http",
"url": "https://mcp.activetrail.com/v1",
"headers": {
"Authorization": "${input:activetrail-key}"
}
}
}
}VS Code demande la clé la première fois et la stocke de manière sécurisée.
Gemini CLI
Modifiez ~/.gemini/settings.json :
{
"mcpServers": {
"activetrail": {
"httpUrl": "https://mcp.activetrail.com/v1",
"headers": {
"Authorization": "$ACTIVETRAIL_API_KEY"
}
}
}
}Utilisez httpUrl, et non url : Gemini CLI interprète url comme l'ancien transport SSE. Vérifiez avec /mcp.
OpenAI Codex
Modifiez ~/.codex/config.toml :
[mcp_servers.activetrail]
url = "https://mcp.activetrail.com/v1"
env_http_headers = { "Authorization" = "ACTIVETRAIL_API_KEY" }N'utilisez pas bearer_token_env_var : il ajoute un préfixe Bearer, que ce serveur n'attend pas. Vérifiez avec /mcp dans Codex.
Windsurf
Modifiez mcp_config.json :
{
"mcpServers": {
"activetrail": {
"serverUrl": "https://mcp.activetrail.com/v1",
"headers": {
"Authorization": "${env:ACTIVETRAIL_API_KEY}"
}
}
}
}Tout autre outil
URL https://mcp.activetrail.com/v1, transport Streamable HTTP, en-tête Authorization: YOUR_ACTIVETRAIL_API_KEY. Un outil qui ne prend pas en charge les en-têtes personnalisés peut utiliser la passerelle mcp-remote de la configuration Claude Desktop.
Tester la connexion
Votre outil doit afficher 9 outils ActiveTrail. Essayez ensuite une question pour chaque domaine :
-
« Affiche mes campagnes email des 30 derniers jours, avec les taux d'ouverture et de clics. »
-
« Quelles campagnes WhatsApp ai-je envoyées le mois dernier ? »
-
« Liste mes automations publiées, puis affiche les statistiques globales de la plus active. »
-
« Trouve le contact name@example.com et affiche son statut. »
Outils disponibles
|
Outil |
Renvoie |
|---|---|
|
|
Les contacts, filtrés par statut, email ou téléphone, et par dates de changement de statut. Jusqu'à 100 par page. |
|
|
La même chose que |
|
|
Les contacts associés au CRM, avec un External ID et un nom. Filtre uniquement par statut et par dates, sans terme de recherche. |
|
|
Les performances email par campagne : envois, ouvertures, clics, taux, non-livrés, désabonnements et plaintes pour spam. |
|
|
Les performances SMS par campagne, y compris les cliqueurs et le total des clics. Recherche par nom de campagne. |
|
|
Les performances WhatsApp par campagne. Recherche par nom de campagne. |
|
|
Les performances push par campagne. Recherche par nom de campagne. |
|
|
Les automations avec leur ID, leur nom, leur état et leur nombre de déclenchements. |
|
|
Les statistiques globales d'une automation : messages par canal, et contacts entrés et sortis. |
Limites et dépannage
Bon à savoir
-
Sans dates, les rapports de campagnes couvrent les 3 derniers mois. Demandez une période précise pour remonter plus loin.
-
Les résultats sont paginés : jusqu'à 100 par page, 20 par défaut pour les rapports de campagnes et les automations.
-
Les statistiques d'automation sont des totaux globaux, non filtrés par date, et excluent les événements de bot.
-
Lister les automations sans filtre d'état inclut celles qui ont été supprimées. Demandez explicitement les automations publiées.
-
Les rapports email ne peuvent pas être triés par taux. Comparez le volume d'envoi avant de classer les campagnes par taux.
|
Problème |
Cause |
Solution |
|---|---|---|
|
401 ou non autorisé |
Clé incorrecte, ou |
Envoyez la clé seule dans |
|
Aucun outil affiché |
Outil non redémarré, ou JSON non valide |
Redémarrez l'outil. Vérifiez que le fichier de configuration est valide. |
|
|
La fonctionnalité Automations n'est pas activée sur le compte |
Contactez le support ActiveTrail. |
|
|
La fonctionnalité External ID n'est pas activée sur le compte |
Contactez le support ActiveTrail. |
|
Claude Desktop affiche une erreur |
Node.js absent, ou espace après |
Installez Node.js. Supprimez l'espace. |
|
Gemini CLI ne se connecte pas |
|
Passez à |
|
L'assistant propose d'envoyer ou de modifier |
Le serveur est en lecture seule |
Effectuez la modification dans ActiveTrail. |