Guides · Démarrer

Brancher Alpative sur n8n, Make ou un agent serveur avec une clé d'agent

Faire interroger vos données marketing par un scénario n8n ou Make, ou par un agent qui tourne sur un serveur (OpenClaw, Hermes Agent, Claude Code, Cursor…), sans navigateur : créer une clé d'agent, la coller au bon endroit, lancer votre premier rapport automatique.

7 min de lectureMis à jour le 18 août 2026
À la fin de ce guide
  • Savoir quand une clé d'agent est nécessaire (et quand elle ne l'est pas)
  • Créer une clé dans la console et la ranger au bon endroit
  • Configurer le nœud MCP dans n8n et le module MCP Client dans Make
  • Brancher un agent serveur : OpenClaw, Hermes Agent, Claude Code, Cursor ou un cadre maison
  • Lancer un rapport hebdomadaire automatique et dépanner les erreurs courantes

Quand utiliser une clé d'agent

Claude, ChatGPT ou Cursor se connectent tout seuls : vous collez l'adresse Alpative, vous cliquez sur « Autoriser », c'est fini. Sur votre poste, ils n'ont pas besoin de clé.

Une clé d'agent sert uniquement à un programme qui n'a pas de navigateur pour cliquer : un scénario n8n ou Make, un script lancé chaque nuit, un agent qui tourne sur un serveur (OpenClaw, Hermes Agent, Claude Code en SSH, Cursor sur une machine distante, un bot maison). La clé remplace le clic « Autoriser ». Elle donne à ce programme exactement vos droits : vos comptes connectés, votre offre, votre quota, rien de plus.

1. Créer la clé dans la console

01
Ouvrez la carte « Clés d'agent »Dans votre console Alpative (Mon compte), descendez jusqu'à la carte « Clés d'agent ».
02
Nommez la clé d'après son usagePar exemple « n8n rapport lundi » ou « Make alertes budget ». Vous saurez plus tard laquelle révoquer.
03
Donnez-lui une durée de vie si possibleLe champ d'expiration est facultatif, mais une clé qui expire limite les dégâts en cas de fuite. 90 jours est un bon réglage.
04
Copiez-la immédiatementLa clé commence par alp_live_ et n'est affichée qu'une seule fois. Si vous la perdez, révoquez-la et créez-en une autre.

L'adresse à utiliser dans n8n ou Make est celle de votre MCP tout-en-un, la même que pour Claude ou ChatGPT :

Adresse du MCP

https://mcp.alpative.com/marketing

2. Dans n8n

n8n propose un nœud dédié aux serveurs MCP. Le plus simple est de le brancher sur un agent IA : vous écrivez la consigne en français, l'agent choisit les bons outils Alpative et rédige la réponse.

01
Ajoutez un nœud « AI Agent »Reliez-lui un modèle de conversation (OpenAI, Anthropic, Google… avec vos propres identifiants). C'est ce modèle qui lit vos données et rédige.
02
Ajoutez l'outil « MCP Client Tool » sous l'agentDans la sortie « Tool » de l'agent, cherchez « MCP Client Tool ».
03
Renseignez l'adresse et le transportEndpoint : https://mcp.alpative.com/marketing. Server Transport : « HTTP Streamable ». Sur une ancienne version de n8n, le champ s'appelle « SSE Endpoint » : mettez à jour n8n, Alpative ne sert que le transport HTTP Streamable.
04
Choisissez l'authentification « Bearer Auth »Créez un identifiant Bearer Auth et collez votre clé alp_live_ dans le champ Token. La clé est ainsi chiffrée par n8n, jamais écrite en clair dans le workflow.
05
Laissez « Tools to Include » sur « All »L'agent voit tous vos outils Alpative. Vous pourrez restreindre à une sélection plus tard, par exemple Analytics seulement pour un rapport ciblé.
06
TestezOuvrez le chat du nœud AI Agent et posez une première question. Si la liste de vos propriétés revient, tout est branché.
Question de test

Liste mes propriétés Google Analytics accessibles via Alpative MCP.

Exemple : le résumé du lundi matin

Un déclencheur « Schedule Trigger » réglé sur le lundi à 8 h, suivi de l'agent IA avec la consigne ci-dessous, puis d'un nœud Gmail, Slack ou Google Sheets pour envoyer le résultat. Trois nœuds, un rapport qui arrive tout seul.

Consigne de l'agent

Sur ma propriété Analytics [nom de ma propriété], compare les 7 derniers jours à la semaine précédente : sessions, utilisateurs, conversions, principaux canaux d'acquisition. Donne les trois faits marquants et une recommandation, en 10 lignes maximum, via Alpative MCP.

3. Dans Make

Make dispose d'une app « MCP Client » qui charge la liste des outils d'un serveur MCP et les rend utilisables comme n'importe quel module.

01
Ajoutez un module de l'app « MCP Client »Deux modules existent : « Call a tool » (vous choisissez l'outil et remplissez ses champs) et « Execute an action with AI » (vous écrivez une consigne, Make choisit et enchaîne les outils).
02
Créez la connexionDans le champ MCP Server, choisissez « + New MCP Server ». URL : https://mcp.alpative.com/marketing. Dans « API Key / Access token », collez votre clé alp_live_. Make l'envoie comme jeton d'accès à chaque appel.
03
Choisissez l'outilAvec « Call a tool », la liste de vos outils Alpative apparaît (ga4_run_report, gsc_search_analytics, google_ads_run_report…) et les champs se dessinent tout seuls : propriété, dates, métriques.
04
EnchaînezAjoutez un module Email, Slack ou Google Sheets pour envoyer ou archiver le résultat, et un déclencheur planifié pour le lancer chaque semaine.

4. OpenClaw, Hermes Agent et les autres agents

Tout agent qui sait parler à un serveur MCP distant fonctionne de la même façon : l'adresse Alpative, le transport HTTP Streamable, et la clé dans l'en-tête Authorization en jeton Bearer. Trois exemples courants, puis la règle générale.

OpenClaw

OpenClaw (assistant personnel auto-hébergé, piloté depuis WhatsApp, Telegram, Slack…) ajoute un serveur MCP en une commande. Rangez d'abord la clé dans une variable d'environnement, puis :

OpenClaw, en ligne de commande

openclaw mcp add alpative \ --url https://mcp.alpative.com/marketing \ --transport streamable-http \ --header "Authorization: Bearer $ALPATIVE_KEY"

Hermes Agent

Hermes Agent (Nous Research) lit ses serveurs MCP dans ~/.hermes/config.yaml. Mettez la clé dans ~/.hermes/.env sous ALPATIVE_KEY, puis déclarez le serveur ; le transport HTTP Streamable est celui par défaut pour une entrée url :

Hermes Agent, ~/.hermes/config.yaml

mcp_servers: alpative: url: "https://mcp.alpative.com/marketing" headers: Authorization: "Bearer ${env:ALPATIVE_KEY}"

Rechargez ensuite avec /reload-mcp dans Hermes : les outils Alpative apparaissent dans la liste des outils de l'agent.

Claude Code, Cursor et les autres

Sur votre poste, Claude Code et Cursor passent par l'autorisation en 2 clics (ils ouvrent le navigateur). Sur un serveur sans écran, en SSH ou dans une intégration continue, la clé prend le relais. Claude Code, par exemple :

Claude Code (serveur, CI)

claude mcp add --transport http alpative https://mcp.alpative.com/marketing \ --header "Authorization: Bearer $ALPATIVE_KEY"

Pour un cadre d'agent maison ou un autre outil (Cursor, Cline, un SDK MCP), la règle est la même : transport HTTP Streamable, en-tête Authorization: Bearer alp_live_…, en-tête Accept: application/json, text/event-stream. Pas d'initialisation particulière, pas de session à ouvrir.

Vérifier et dépanner

  • Erreur 401 ou « Unauthorized » : la clé est mal collée, révoquée ou expirée. Vérifiez la carte « Clés d'agent » de la console (la date de dernière utilisation vous dit si elle a déjà servi) et créez-en une nouvelle si besoin.
  • L'outil répond que la source n'est pas disponible dans votre offre : le scénario a vos droits, pas plus. Google Ads, Meta ou LinkedIn demandent l'offre Pro, les actions d'écriture l'offre Expert.
  • Réponse vide ou « aucune propriété » : la source n'est pas connectée dans la console. Connectez-la (bouton « Connecter »), vous n'avez rien à changer côté clé.
  • Le quota se décompte comme pour Claude : un appel d'outil = une requête. Un rapport hebdomadaire consomme quelques requêtes par semaine.
  • Test rapide pour un développeur : une requête POST sur l'adresse du MCP avec l'en-tête Authorization: Bearer alp_live_… et l'en-tête Accept: application/json, text/event-stream. La réponse arrive au format text/event-stream (lignes data:).

Garder le contrôle

  • Rangez la clé dans les identifiants chiffrés de n8n ou dans la connexion Make, jamais dans un champ texte du scénario ni dans un message.
  • Une clé par usage : si un scénario est abandonné, révoquez sa clé depuis la console. L'effet est immédiat.
  • Consultez la date de dernière utilisation : une clé qui sert alors que le scénario est arrêté a fuité, révoquez-la.
  • La clé ne gère ni votre abonnement ni vos connexions Google, Meta ou LinkedIn : tout cela reste dans la console.

Prêt à poser ces questions à vos données ?

Connectez vos comptes en deux minutes, avec l'offre gratuite.

Automatiser : n8n, Make, OpenClaw, Hermes · Alpative MCP