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
L'adresse à utiliser dans n8n ou Make est celle de votre MCP tout-en-un, la même que pour Claude ou ChatGPT :
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.
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.
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.
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 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 :
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 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.
