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

https://mcp.activetrail.com/v1

Transport

Streamable HTTP (à distance, rien à installer)

Nom de l'en-tête

Authorization

Valeur de l'en-tête

Votre clé API telle quelle, sans Bearer

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.

  1. Connectez-vous à ActiveTrail.

  2. Allez dans Intégrations → API → Clés API.

  3. Créez une nouvelle clé API et copiez-la.

  4. 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 mcp add avec --header

Claude Desktop

Passerelle mcp-remote dans le fichier de configuration

Cursor

url + headers dans mcp.json

VS Code (GitHub Copilot)

type: http + headers dans mcp.json

Gemini CLI

httpUrl + headers dans settings.json

OpenAI Codex

url + env_http_headers dans config.toml

Windsurf

serverUrl + headers dans mcp_config.json

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.

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

  2. URL du serveur : https://mcp.activetrail.com/v1

  3. Authentification : No sign-in (sans connexion).

  4. Sous Request headers (en-têtes de requête), choisissez authorization et collez votre clé comme valeur, sans Bearer.

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

search_contacts

Les contacts, filtrés par statut, email ou téléphone, et par dates de changement de statut. Jusqu'à 100 par page.

search_contacts_with_sms_state

La même chose que search_contacts, avec en plus le statut d'abonnement SMS.

search_external_contacts

Les contacts associés au CRM, avec un External ID et un nom. Filtre uniquement par statut et par dates, sans terme de recherche.

list_email_campaign_reports

Les performances email par campagne : envois, ouvertures, clics, taux, non-livrés, désabonnements et plaintes pour spam.

list_sms_campaign_reports

Les performances SMS par campagne, y compris les cliqueurs et le total des clics. Recherche par nom de campagne.

list_whatsapp_campaign_reports

Les performances WhatsApp par campagne. Recherche par nom de campagne.

list_push_campaign_reports

Les performances push par campagne. Recherche par nom de campagne.

list_automations

Les automations avec leur ID, leur nom, leur état et leur nombre de déclenchements.

get_automation_overview

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 Bearer ajouté devant

Envoyez la clé seule dans Authorization. Vérifiez qu'il n'y a pas d'espaces en trop ni de guillemets typographiques.

Aucun outil affiché

Outil non redémarré, ou JSON non valide

Redémarrez l'outil. Vérifiez que le fichier de configuration est valide.

list_automations renvoie 403

La fonctionnalité Automations n'est pas activée sur le compte

Contactez le support ActiveTrail.

search_external_contacts renvoie 405

La fonctionnalité External ID n'est pas activée sur le compte

Contactez le support ActiveTrail.

Claude Desktop affiche une erreur mcp-remote

Node.js absent, ou espace après Authorization:

Installez Node.js. Supprimez l'espace.

Gemini CLI ne se connecte pas

url utilisé au lieu de httpUrl

Passez à httpUrl.

L'assistant propose d'envoyer ou de modifier

Le serveur est en lecture seule

Effectuez la modification dans ActiveTrail.