PlugKit
API-Key holen
Tutorial · KI-Agenten in Social Media

Hermes Agent einrichten: Installation und Verbindung mit Instagram, LinkedIn und X in 15 Minuten

Von Antoine Blanco··Aktualisiert am 28. September 2026·7 Min. Lesezeit

Hermes Agent installierst du mit einem Befehl und verbindest PlugKit mit einem weiteren: hermes mcp add plugkit --url https://api.plugkit.co/mcp --auth header. Dein Agent listet danach deine Accounts auf, veröffentlicht auf Instagram, LinkedIn, X, TikTok, YouTube, Facebook, WhatsApp und Telegram, liest den Posteingang und antwortet. Jeder Befehl hier unten lief am 4. September 2026 auf meinem Mac, echte Ausgabe inklusive.

Was Hermes Agent ist (und warum es einen Plug braucht)

Hermes Agent ist der Open-Source-Agent von Nous Research (MIT-Lizenz). Anders als ein Chatfenster läuft er permanent: ein Gateway-Prozess, den du über WhatsApp, Telegram, Discord oder Slack erreichst, Cronjobs, Skills, die er selbst schreibt und verbessert, Erinnerung über Sessions hinweg und ein nativer MCP-Client. Ab Werk kann er browsen, Code ausführen und Dateien lesen. Auf Instagram posten kann er nicht, denn Instagram, LinkedIn, X und TikTok haben jeweils eine andere API, einen anderen OAuth-Flow und ein anderes App Review.

Genau diese Lücke füllt ein MCP-Server. PlugKit stellt deine verbundenen Social-Accounts als MCP-Tools über einfaches Streamable HTTP bereit, damit Hermes Publishing, Posteingang, Kommentare, Analytics und Comment-to-DM-Automationen bekommt, ohne dass du eine einzige Plattform-API anfassen musst.

Schritt 1: Hermes Agent installieren

Unter macOS oder Linux (WSL2 geht auch):

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

hermes setup ist der Assistent: Er wählt deinen Model-Provider aus (ich fahre ihn auf gpt-5.5 über den OpenAI-Codex-Login, Claude und lokale Modelle gehen genauso), legt das Arbeitsverzeichnis fest, das der Agent sehen darf, und konfiguriert die Messaging-Kanäle. Prüf die Installation:

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

Wenn das Banner meldet, dass du hinter Upstream liegst, bringt dich hermes update auf Stand. Hermes veröffentlicht mehrmals pro Woche neue Versionen.

Zwei Einstellungen, die du in ~/.hermes/config.yaml gleich geraderücken solltest:

Schritt 2: PlugKit-API-Key holen und Accounts verbinden

Leg dir einen PlugKit-Account an ($49 pro Monat für 5 verbundene Accounts, jederzeit kündbar), verbinde deine Social-Accounts im Dashboard über die normalen OAuth-Buttons und erstelle einen API-Key. Unterstützt werden Instagram, Facebook, WhatsApp, TikTok, Telegram, YouTube, X und LinkedIn; welche Funktionen pro Plattform aktuell drin sind, steht in den MCP-Docs.

Der Key sieht aus wie sk_…. Fügst du ihn nie in einen Chat mit dem Agenten ein: Dort bleibt er für immer in der History. Der nächste Schritt legt ihn sauber ab.

Schritt 3: PlugKit als MCP-Server in Hermes eintragen

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

Hermes stellt zwei Fragen:

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

Dieser Durchlauf wurde mit Hermes Agent v0.16.0 aufgezeichnet und hat 85 Tools gemeldet. Seitdem sind auf dem Server laufend neue dazugekommen, heute sind es über 100. Bei dir werden es also mehr sein.

Was auf der Platte passiert ist: Der Key ging nach ~/.hermes/.env als MCP_PLUGKIT_API_KEY, und ~/.hermes/config.yaml hat diesen Block bekommen, der auf die Variable verweist statt auf den Key selbst:

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

Du kannst diesen Block auch von Hand schreiben, wenn dir das lieber ist; hermes mcp add erledigt es nur für dich und testet die Verbindung.

Schritt 4: Verbindung testen

hermes mcp test plugkit

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

Und hermes mcp list zeigt den Server als aktiviert an, mit allen Tools. Innerhalb einer Session tragen die Tools den Servernamen als Präfix: mcp__plugkit__whoami, mcp__plugkit__list_accounts, mcp__plugkit__create_post, mcp__plugkit__send_message und so weiter. Das ist die Form mit doppeltem Unterstrich, die Hermes seit v0.19.0 verwendet; v0.16.0, die Version des Durchlaufs oben, nannte sie noch mcp_plugkit_whoami. Sie werden in jeden Hermes-Kanal eingespielt (CLI, WhatsApp, Telegram, Cron), ohne zusätzliche Konfiguration.

Das haben whoami und list_accounts auf meinem Account zurückgegeben, gekürzt:

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

Sieben Accounts, ein Plug. Frag Hermes "welche PlugKit-Accounts habe ich?" und diese Tabelle ist die Antwort.

Die Startup-Eigenart, die wie ein Fehler aussieht

Wenn du mit einem One-Shot-Befehl wie hermes chat -q "list my PlugKit accounts" testest, sagt die erste Antwort womöglich, die Tools seien nicht verfügbar. Das liegt nicht an der Verbindung. Hermes entdeckt MCP-Server in einem Hintergrund-Thread und wartet vor dem ersten Turn nur 0,75 Sekunden darauf (hermes_cli/mcp_startup.py, wait_for_mcp_discovery(timeout=0.75) in v0.16.0). Der Handshake von PlugKit dauert rund 2,5 Sekunden, die erste Nachricht ist der Tool-Liste also voraus.

Drei Wege drumherum:

Ich habe damit zwanzig Minuten verschwendet, bevor ich den Quellcode gelesen habe. Du brauchst jetzt eine Minute.

Was du Hermes fragen kannst, sobald es eingestöpselt ist

Nur lesend, sicher zum ersten Ausprobieren:

Dann die eigentliche Arbeit:

Starte Hermes mit dem OAuth-Scope mcp:read, wenn du ihn eine Woche lang nur lesen lassen willst, bevor er schreiben darf; über den API-Key hat er vollen Zugriff, also setze trust: untrusted für den PlugKit-Server in config.yaml, damit jedes schreibende Tool auf deine Freigabe wartet, und teste Schreibzugriffe auf einem Zweitaccount. approvals.mode deckt nur gefährliche Shell-Befehle ab, keine MCP-Tools.

Hermes Agent, OpenClaw oder ein simples Skript?

Wenn bei dir schon OpenClaw läuft: PlugKit verbindet sich genauso (es spricht Standard-MCP über HTTP). Hermes ist der, der 2026 an Boden gewinnt: permanent laufendes Gateway, Cron, Skills, die sich selbst verbessern, und ein nativer MCP-Client, der keine Bridge braucht. Ein schlichtes Skript gegen die PlugKit REST API bleibt die richtige Antwort, wenn du deterministisch veröffentlichen willst, ohne Modell dazwischen; der Agent ist für die dialogische Hälfte da, Antworten, Triage, Entscheidungen.

Den kompletten Vergleich findest du in Hermes Agent vs. OpenClaw für Social Media. Zur Mechanik hinter dem MCP-Server: So gibst du einem KI-Agenten Zugriff auf Social Media.

FAQ

Unterstützt Hermes Agent MCP-Server?

Ja. Hermes hat seit Anfang 2026 einen nativen MCP-Client: Server kommen unter mcp_servers in ~/.hermes/config.yaml (stdio oder HTTP), Tools werden beim Start entdeckt und in jedem Kanal als mcp__<server>__<tool> registriert. Verwaltet werden sie im Terminal mit hermes mcp add, hermes mcp test und hermes mcp list.

Kann Hermes Agent auf Instagram posten?

Allein nicht. Instagram verlangt die Graph API mit einem Business- oder Creator-Account und ein App Review. Über den PlugKit-MCP-Server bekommt Hermes create_post, publish_post, get_comments, reply_to_comment und die Inbox-Tools auf deinem verbundenen Instagram-Account, kann also veröffentlichen, lesen und antworten.

Wo speichert Hermes den PlugKit-API-Key?

In ~/.hermes/.env als MCP_PLUGKIT_API_KEY. config.yaml verweist im Authorization-Header auf die Variable, statt den Key selbst zu enthalten. Schalt security.redact_secrets ein, damit Keys nie in den Session-Logs landen.

Warum sagt Hermes bei der ersten Nachricht, die PlugKit-Tools seien nicht verfügbar?

Weil die MCP-Erkennung im Hintergrund läuft und der erste Turn nur 0,75 Sekunden darauf wartet, während der PlugKit-Handshake rund 2,5 Sekunden braucht. Schick eine zweite Nachricht, oder nutz das Gateway, das beim Start verbunden hat.

Was kostet das?

Hermes Agent ist kostenlos und Open Source; du zahlst nur deinen Modellanbieter. PlugKit kostet 49 $ im Monat für 5 verbundene Accounts oder 97 $ für 30, alle Tools inklusive, jederzeit kündbar. Einzige Ausnahme sind X-API-Aufrufe, die zum Tarif von X durchgereicht werden.

Mehr zu KI-Agenten in Social Media

AB
Antoine BlancoGründer von PlugKit. Betreibt seine eigenen Instagram-, YouTube- und X-Accounts über die hier beschriebene API und den MCP-Server.

Ein Plug für jede Plattform, die dein Agent anfasst

49 $ im Monat für 5 verbundene Accounts, jederzeit kündbar. Jede Funktion in jedem Tarif.

Hol dir deinen API-Key →
Deutsch ▾