PlugKit
Obtenir une clé API
Tutoriel · Les agents IA sur les réseaux sociaux

Installer Hermes Agent et le brancher à Instagram, LinkedIn et X en 15 minutes

Par Antoine Blanco··Mis à jour le 28 septembre 2026·7 min de lecture

Hermes Agent demande une commande pour l'installer et une de plus pour brancher PlugKit : hermes mcp add plugkit --url https://api.plugkit.co/mcp --auth header. Ton agent liste ensuite tes comptes, publie sur Instagram, LinkedIn, X, TikTok, YouTube, Facebook, WhatsApp et Telegram, lit la boîte de réception et répond. Toutes les commandes ci-dessous ont tourné sur mon Mac le 4 septembre 2026, sorties réelles incluses.

Ce qu'est Hermes Agent (et pourquoi il lui faut un plug)

Hermes Agent est l'agent open source de Nous Research (licence MIT). Contrairement à une fenêtre de chat, il tourne en permanence : un processus passerelle que tu joins depuis WhatsApp, Telegram, Discord ou Slack, des tâches cron, des compétences qu'il écrit et améliore lui-même, une mémoire qui traverse les sessions, et un client MCP natif. D'origine, il sait naviguer, exécuter du code et lire des fichiers. Il ne sait pas publier sur Instagram, parce qu'Instagram, LinkedIn, X et TikTok ont chacun une API différente, un flux OAuth différent et une revue d'app différente.

C'est le vide que comble un serveur MCP. PlugKit expose tes comptes sociaux connectés comme des outils MCP en Streamable HTTP standard, donc Hermes obtient la publication, la boîte de réception, les commentaires, les analytics et les automatisations commentaire-vers-DM sans que tu touches à une seule API de plateforme.

Étape 1 : installer Hermes Agent

Sur macOS ou Linux (WSL2 marche aussi) :

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
hermes setup

hermes setup, c'est l'assistant : il choisit ton fournisseur de modèle (moi je le fais tourner sur gpt-5.5 via le login OpenAI Codex, Claude et les modèles locaux marchent aussi), définit le répertoire de travail que l'agent a le droit de voir, et configure les canaux de messagerie. Vérifie l'installation :

hermes --version
# Hermes Agent v0.16.0 (2026.6.5) · upstream 85852b71

Si la bannière t'indique que tu es en retard sur l'amont, hermes update te remet à jour. Hermes sort de nouvelles versions plusieurs fois par semaine.

Deux réglages à corriger tout de suite dans ~/.hermes/config.yaml :

Étape 2 : obtenir une clé d'API PlugKit et connecter tes comptes

Crée un compte PlugKit (49 $ par mois pour 5 comptes connectés, résiliable à tout moment), connecte tes comptes sociaux depuis le tableau de bord avec les boutons OAuth habituels, et crée une clé d'API. Instagram, Facebook, WhatsApp, TikTok, Telegram, YouTube, X et LinkedIn sont pris en charge ; la doc MCP liste les capacités actuelles par plateforme.

La clé ressemble à sk_…. Ne la colle jamais dans un chat avec l'agent : elle reste dans l'historique pour toujours. L'étape suivante la stocke proprement.

Étape 3 : ajouter PlugKit comme serveur MCP dans Hermes

hermes mcp add plugkit --url https://api.plugkit.co/mcp --auth header

Hermes pose deux questions :

Does this server require authentication? [Y/n]: Y
API key / Bearer token: sk_…
✓ Saved to ~/.hermes/.env as MCP_PLUGKIT_API_KEY

Connecting to 'plugkit'...
✓ Connected! Found 85 tool(s) from 'plugkit':
  whoami            Entry point: returns the authenticated identity, the profiles...
  list_profiles     List profiles (workspaces grouping social accounts)...
  list_accounts     List connected social accounts, filterable by profile, platform...
  create_post       Create a post and publish it to several accounts at once...
  list_conversations, send_message, reply_to_comment, get_analytics_summary,
  create_comment_automation ...

Cette capture a été faite avec Hermes Agent v0.16.0, qui affichait 85 outils. Le serveur en a ajouté d'autres depuis et en expose plus de 100 aujourd'hui, donc tu en verras davantage chez toi.

Ce qui s'est passé sur le disque : la clé est partie dans ~/.hermes/.env sous MCP_PLUGKIT_API_KEY, et ~/.hermes/config.yaml a gagné ce bloc, qui référence la variable au lieu de la clé en clair :

mcp_servers:
  plugkit:
    url: https://api.plugkit.co/mcp
    headers:
      Authorization: Bearer ${MCP_PLUGKIT_API_KEY}
    enabled: true

Tu peux écrire ce bloc à la main si tu préfères ; hermes mcp add ne fait que le faire pour toi et tester la connexion.

Étape 4 : tester la connexion

hermes mcp test plugkit

Testing 'plugkit'...
Transport: HTTP → https://api.plugkit.co/mcp
  Authorization: Bear***7444
✓ Connected (2529ms)
✓ Tools discovered: 85

Et hermes mcp list affiche le serveur comme activé avec tous ses outils. Dans une session, les outils sont préfixés par le nom du serveur : mcp__plugkit__whoami, mcp__plugkit__list_accounts, mcp__plugkit__create_post, mcp__plugkit__send_message, et ainsi de suite. C'est la forme à double tiret bas qu'utilise Hermes depuis la v0.19.0 ; la v0.16.0, celle du test ci-dessus, les nommait encore mcp_plugkit_whoami. Ils sont injectés dans tous les canaux Hermes (CLI, WhatsApp, Telegram, cron), sans configuration supplémentaire.

Voici ce que whoami et list_accounts ont renvoyé sur mon compte, en version raccourcie :

profiles: Antoine Blanco (6 accounts, 54 posts), Antoine Blanco Business (1 account)

platform   account                    
facebook   Antoine.Blanco
linkedin   Antoine Blanco
youtube    @antoineblancobusiness
youtube    @antoineblanco99
tiktok     Antoine Blanco
x          @AntoineBlanco99
instagram  @antoineblanco99

Sept comptes, un seul plug. Demande à Hermes "quels comptes PlugKit j'ai ?" et ce tableau est la réponse.

La bizarrerie de démarrage qui ressemble à un bug

Si tu testes avec une commande one-shot du genre hermes chat -q "list my PlugKit accounts", la première réponse peut te dire que les outils ne sont pas disponibles. Ce n'est pas la connexion. Hermes découvre les serveurs MCP dans un thread en arrière-plan et ne l'attend que 0,75 seconde avant le premier tour (hermes_cli/mcp_startup.py, wait_for_mcp_discovery(timeout=0.75) en v0.16.0). Le handshake de PlugKit prend environ 2,5 secondes, donc le premier message part avant la liste des outils.

Trois façons de contourner ça :

J'ai perdu vingt minutes là-dessus avant de lire le code source. Toi, tu n'en perdras qu'une.

Ce qu'il faut demander à Hermes une fois qu'il est branché

En lecture seule, sans risque pour un premier essai :

Puis le vrai travail :

Démarre Hermes avec le scope OAuth mcp:read si tu veux une semaine en lecture seule avant de le laisser écrire ; la voie par clé d'API donne un accès complet, alors mets trust: untrusted sur le serveur PlugKit dans config.yaml, ce qui fait attendre ton accord à chaque outil d'écriture, et teste les écritures sur un compte secondaire. approvals.mode ne couvre que les commandes shell dangereuses, pas les outils MCP.

Hermes Agent, OpenClaw ou un simple script ?

Si tu fais déjà tourner OpenClaw, PlugKit se branche de la même façon (il parle le MCP standard en HTTP). C'est Hermes qui gagne du terrain en 2026 : passerelle toujours active, cron, compétences auto-améliorées, et un client MCP natif qui n'a besoin d'aucun pont. Un simple script qui appelle l'API REST PlugKit reste la bonne réponse quand tu veux une publication déterministe sans modèle dans la boucle ; l'agent est là pour la moitié conversationnelle, les réponses, le tri, les décisions.

Pour la comparaison complète, lis Hermes Agent vs OpenClaw pour les réseaux sociaux. Pour la mécanique derrière le serveur MCP, comment donner à un agent IA l'accès aux réseaux sociaux.

FAQ

Est-ce que Hermes Agent supporte les serveurs MCP ?

Oui. Hermes a un client MCP natif depuis début 2026 : les serveurs se déclarent sous mcp_servers dans ~/.hermes/config.yaml (stdio ou HTTP), les outils sont découverts au démarrage et enregistrés sous mcp__<server>__<tool> dans tous les canaux. hermes mcp add, hermes mcp test et hermes mcp list les gèrent depuis le terminal.

Est-ce que Hermes Agent peut publier sur Instagram ?

Pas tout seul. Instagram exige la Graph API avec un compte business ou créateur et une revue d'app. Via le serveur MCP PlugKit, Hermes récupère create_post, publish_post, get_comments, reply_to_comment et les outils de boîte de réception sur ton compte Instagram connecté, donc il peut publier, lire et répondre.

Où Hermes stocke-t-il la clé API PlugKit ?

Dans ~/.hermes/.env, sous MCP_PLUGKIT_API_KEY. config.yaml référence la variable dans l'en-tête Authorization au lieu de contenir la clé. Active security.redact_secrets pour que les clés n'atterrissent jamais dans les logs de session.

Pourquoi Hermes dit-il que les outils PlugKit sont indisponibles au premier message ?

Parce que la découverte MCP tourne en arrière-plan et que le premier tour ne l'attend que 0,75 seconde, alors que le handshake PlugKit prend environ 2,5 secondes. Envoie un deuxième message, ou utilise la gateway, qui s'est connectée au démarrage.

Combien ça coûte ?

Hermes Agent est gratuit et open source ; tu paies ton fournisseur de modèle. PlugKit coûte 49 $ par mois pour 5 comptes connectés ou 97 $ pour 30, tous les outils inclus, résiliable à tout moment. Les appels à l'API X sont la seule refacturation, au tarif de X.

Pour aller plus loin sur les agents IA et les réseaux sociaux

AB
Antoine BlancoFondateur de PlugKit. Gère ses propres comptes Instagram, YouTube et X via l'API et le serveur MCP décrits ici.

Un plug pour chaque plateforme que ton agent touche

49 $ par mois pour 5 comptes connectés, résiliable à tout moment. Toutes les fonctionnalités dans tous les forfaits.

Récupère ta clé API →
Français ▾