Hermoso aus jedem MCP-Client nutzen

Der Hermoso-Server ist ein einfacher Model-Context-Protocol-Server. Deshalb geht es bei „Welcher Client?“ vor allem um die Konfigurationssyntax und kaum um die Funktionen. Es gibt zwei Wege hinein, und beide führen zu denselben über 922 Tools.

Die zwei Transportwege

• Gehostet, streamable HTTP: https://app.hermoso.ai/mcp. Diesen wollen die meisten Clients. Er unterstützt OAuth mit dynamischer Client-Registrierung und PKCE. Ein Client, der den vollen Autorisierungsablauf beherrscht, braucht daher keinen Schlüssel. Ein Client, der das nicht kann, kann stattdessen einen Header Authorization: Bearer hmk_… senden. Beachte: Es gibt nur streamable HTTP. Einen alten HTTP+SSE-Endpunkt gibt es nicht. Ein Client, der nur das alte Transportprotokoll spricht, hat hier also keine Verbindungsmöglichkeit.
• stdio, über npm: npx -y hermoso mcp, dein Schlüssel steht in HERMOSO_TOKEN. Jeder stdio-MCP-Client kann ihn laden. Dasselbe Paket ist außerdem eine CLI (npm install -g hermoso). Für Terminal-Agenten ist das der token-sparsame Weg: Sie rufen pro Befehl ein Programm auf, statt bei jedem Schritt ein Manifest mit über 922 Tools mitzuschleppen.

Agenten können die Serverkarte unter /.well-known/mcp.json automatisch finden. Außerdem steht der Server im offiziellen MCP-Verzeichnis als io.github.hermoso-ai/hermoso.

Der allgemeine Konfigurationsblock

Die meisten Clients nehmen eine Variante davon:

{ "mcpServers": { "hermoso": {
    "url": "https://app.hermoso.ai/mcp",
    "headers": { "Authorization": "Bearer <your key>" }
} } }

Erstelle den Schlüssel in Hermoso unter MCP & CLI → Terminal & API-Schlüssel. Eine Ausnahme gibt es: Codex liest TOML, nicht JSON. Ein kopierter Block mcpServers wird dort nicht geladen. Die vier Zeilen, die Codex braucht, stehen auf der Codex-Seite.

Clients mit eigener Seite

• Claude: verbindet sich per OAuth, du musst nichts einfügen.
• ChatGPT: verbindet sich per OAuth, du musst nichts einfügen.
• Claude Code: meldet sich im Terminal mit hermoso auth login an, du musst nichts einfügen. Da es ein Terminal-Agent ist, ist für lange Läufe die CLI der günstigere Weg.
• Cursor: meldet sich im Terminal mit hermoso auth login an, du musst nichts einfügen.
• Codex: meldet sich im Terminal mit hermoso auth login an, du musst nichts einfügen. Da es ein Terminal-Agent ist, ist für lange Läufe die CLI der günstigere Weg.
• Cline: nimmt einen API-Schlüssel in einem Authorization-Header.
• OpenClaw: meldet sich im Terminal mit hermoso auth login an, du musst nichts einfügen. Da es ein Terminal-Agent ist, ist für lange Läufe die CLI der günstigere Weg.
• Grok Bot: fügt die Vorlage Hermoso Marketing Bot hinzu und nimmt einen API-Schlüssel im Chat, oder du meldest dich im Terminal des Bots an.
• Hermes: meldet sich im Terminal mit hermoso auth login an, du musst nichts einfügen. Da es ein Terminal-Agent ist, ist für lange Läufe die CLI der günstigere Weg.
• Gemini CLI: meldet sich im Terminal mit hermoso auth login an, du musst nichts einfügen. Da es ein Terminal-Agent ist, ist für lange Läufe die CLI der günstigere Weg.
• Perplexity: verbindet sich per OAuth, du musst nichts einfügen.
• Le Chat: verbindet sich per OAuth, du musst nichts einfügen.
• Claude Cowork: verbindet sich per OAuth, du musst nichts einfügen.
• Perplexity Computer: verbindet sich per OAuth, du musst nichts einfügen.
• Paperclip: verbindet sich per OAuth, du musst nichts einfügen.
• Gemini: verbindet sich per OAuth, du musst nichts einfügen.
• Grok Build: meldet sich im Terminal mit hermoso auth login an, du musst nichts einfügen. Da es ein Terminal-Agent ist, ist für lange Läufe die CLI der günstigere Weg.
• Kimi Code: trägt die gehostete URL in mcp.json ein und meldet sich mit /mcp-config login an, du musst nichts einfügen. Da es ein Terminal-Agent ist, ist für lange Läufe die CLI der günstigere Weg.
• DeepSeek Harness: meldet sich im Terminal mit hermoso auth login an und betreibt Hermoso als lokalen Server, du musst nichts einfügen.
• Manus: nimmt einen API-Schlüssel in einem Authorization-Header.
• Muse, eingerichtet über eine Chat-Nachricht, die sich per OAuth verbindet, du musst nichts einfügen.

Vier Clients haben bewusst keine eigene Seite. Es lohnt sich, zu sagen, warum, statt mehr Unterstützung anzudeuten, als wir getestet haben. VS Code: Hermoso bietet einen Ein-Klick-Deeplink für VS Code, aber es gibt im Produkt keinen VS-Code-Installationsblock und keinen getesteten Weg. Deshalb gibt es auch keine Seite, die einen behauptet. Der Deeplink installiert nur den nackten Endpunkt, und die Anmeldung übernimmt OAuth von VS Code selbst. Claude Desktop: Claude Desktop nutzt denselben Connectors-Ablauf wie claude.ai und ist daher auf der Claude-Seite abgedeckt und nicht doppelt beschrieben. Grok: Grok-Chat verbindet sich heute über die Setup-Karte auf /mcp. Eine eigene Seite gibt es noch nicht, weil ihr Text pro Kanal nur die ChatGPT-Seiten wiederholen würde, ohne etwas hinzuzufügen, was nur wir sagen können. Muse: Meta Muse wird über eine Chat-Nachricht eingerichtet und nicht über einen Einstellungsbildschirm. Deshalb ist die Anleitung von Hand auf hermoso.ai/muse geschrieben und nicht hier generiert.

Jeder Kanal, von jedem dieser Clients aus

Der Client ändert nicht, was erreichbar ist. Von jedem von ihnen aus kannst du veröffentlichen und planen auf Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram und Google Business Profile. Du kannst die Werbebibliotheken von Meta, Google und LinkedIn durchsuchen, dazu organisches TikTok, Instagram, YouTube, Reddit und Threads. Fertige Bild- und Videoanzeigen lassen sich mit über 100 Modellen rendern. Und Kampagnen baust du auf Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads und AppLovin Ads.

Ein Veröffentlichungskanal ist gebaut, aber zurückgehalten, bis die Plattform mitspielt: Reddit. Organisches Posten und Post-Statistiken sind gebaut, aber Reddits Responsible Builder Policy verlangt eine ausdrückliche schriftliche Genehmigung, bevor eine App die Data API nutzen darf, und diese Genehmigung liegt nicht vor. Der Connector wird deshalb zurückgehalten, statt als OAuth-Bildschirm angeboten zu werden, der zu einer toten API führt. Reddit Ads ist eine andere Verbindung und sie ist live: der komplette Kampagnenbaum, Prognosen, Zielgruppensuche, Pixel und Lead-Formulare.

Was kein Client allein kann

Ein Agent mit Budget ist nur dann nützlich, wenn der mögliche Schaden begrenzt ist. Deshalb sitzt die Sperre im Server und nicht in einem Prompt. Jede Werbekampagne, jedes Anzeigenset, jede Anzeigengruppe und jede Anzeige wird pausiert angelegt. Und die Statusänderungen, die echtes Geld bewegen, laufen nur mit einer ausdrücklichen Bestätigung. Jeder Render wird vorher bepreist (hermoso_capabilities nennt die genauen Credit-Kosten jedes Modells, bevor etwas ausgegeben wird). Credits werden vor dem ersten Anbieteraufruf reserviert und danach zu den exakten Kosten abgerechnet. Schlägt ein Auftrag fehl, wird also erstattet, statt dass du für nichts zahlst. Auch Löschungen sind bestätigungspflichtig, und jeder Kampagnenbaum wird aus der Werbeplattform zurückgelesen, bevor dein Agent dir erzählt, was er gebaut hat.

Ein Schritt bleibt bewusst bei dir: jedes Konto einmal verknüpfen. Die meisten Kanäle verknüpfen sich über den OAuth-Zustimmungsbildschirm der Plattform im Browser. Bluesky nimmt ein App-Passwort und Telegram ein Bot-Token, das du in Hermoso einfügst. Alles danach ist ein Tool-Aufruf.

Häufig gestellte Fragen

Funktioniert Hermoso mit jedem MCP-Client?

Über stdio ja. Jeder Client, der npx -y hermoso mcp starten kann, bekommt alle über 922 Tools. Über den gehosteten Endpunkt gibt es nur streamable HTTP. Eine alte HTTP+SSE-Route existiert nicht, deshalb hat ein Client, der nur das alte Protokoll spricht, dort keine Verbindungsmöglichkeit.

Brauche ich einen API-Schlüssel, oder funktioniert OAuth?

Beide Wege gibt es. Der gehostete Endpunkt unterstützt OAuth mit dynamischer Client-Registrierung und PKCE. So melden sich die Connectors für Claude, ChatGPT, Perplexity, Le Chat, Claude Cowork, Perplexity Computer, Paperclip und Gemini an, ohne dass du etwas einfügst. Clients, die einen lokalen Prozess starten, melden sich einmal mit hermoso auth login an. Ein Client, der keines von beidem kann, sendet einen API-Schlüssel (hmk_…) in einem Header Authorization: Bearer. Den erstellst du im Tab MCP & CLI unter Terminal & API-Schlüssel.

Wie lautet die MCP-Endpunkt-URL?

https://app.hermoso.ai/mcp. In der Serverkarte unter /.well-known/mcp.json ist sie als entferntes streamable-HTTP-Ziel angegeben. Das Paket heißt auf npm hermoso und im offiziellen MCP-Verzeichnis io.github.hermoso-ai/hermoso.