Hermoso draaien in elke MCP-client

De server van Hermoso is een gewone Model Context Protocol-server, dus "welke client?" is vooral een vraag over configuratiesyntaxis en niet over mogelijkheden. Er zijn twee manieren om binnen te komen, en beide bereiken dezelfde 922+ tools.

De twee transporten

• Gehost, streambare HTTP: https://app.hermoso.ai/mcp. Dit is de optie die de meeste clients willen. Hij ondersteunt OAuth met dynamische clientregistratie en PKCE, dus een client die de volledige autorisatieflow spreekt heeft helemaal geen sleutel nodig. Een client die dat niet kan, kan in plaats daarvan een Authorization: Bearer hmk_…-header sturen. Let op: het is alleen streambare HTTP. Er is geen verouderd HTTP+SSE-eindpunt, dus een client die alleen het oude transport spreekt heeft hier niets om mee te verbinden.
• stdio, via npm: npx -y hermoso mcp, met je sleutel in HERMOSO_TOKEN. Elke stdio-MCP-client kan hem laden. Hetzelfde pakket is ook een CLI (npm install -g hermoso), en dat is het goedkope pad voor terminalagents: zij shellen per commando in plaats van een manifest van 922+ tools door elke beurt te slepen.

Agents kunnen de serverkaart automatisch vinden op /.well-known/mcp.json, en de server staat in het officiële MCP-register als io.github.hermoso-ai/hermoso.

Het generieke configuratieblok

De meeste clients nemen een variant van dit blok:

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

Maak de sleutel aan in Hermoso onder MCP & CLI → Terminal & API-sleutels. Eén client is een echte uitzondering: Codex leest TOML, geen JSON, dus een gekopieerd mcpServers-blok laadt daar niet. Zie de Codex-pagina voor de vier regels die daar nodig zijn.

Clients met een eigen pagina

• Claude: verbindt met OAuth, niets te plakken.
• ChatGPT: verbindt met OAuth, niets te plakken.
• Claude Code: meldt zich aan vanuit de terminal met hermoso auth login, niets te plakken; een terminalagent, dus de CLI is het goedkopere pad voor lange runs.
• Cursor: meldt zich aan vanuit de terminal met hermoso auth login, niets te plakken.
• Codex: meldt zich aan vanuit de terminal met hermoso auth login, niets te plakken; een terminalagent, dus de CLI is het goedkopere pad voor lange runs.
• Cline: neemt een API-sleutel in een Authorization-header.
• OpenClaw: meldt zich aan vanuit de terminal met hermoso auth login, niets te plakken; een terminalagent, dus de CLI is het goedkopere pad voor lange runs.
• Grok Bot: voegt de Hermoso Marketing Bot-template toe en neemt een API-sleutel in de chat, of meldt zich aan vanuit de eigen terminal van de Bot.
• Hermes: meldt zich aan vanuit de terminal met hermoso auth login, niets te plakken; een terminalagent, dus de CLI is het goedkopere pad voor lange runs.
• Gemini CLI: meldt zich aan vanuit de terminal met hermoso auth login, niets te plakken; een terminalagent, dus de CLI is het goedkopere pad voor lange runs.
• Perplexity: verbindt met OAuth, niets te plakken.
• Le Chat: verbindt met OAuth, niets te plakken.
• Claude Cowork: verbindt met OAuth, niets te plakken.
• Perplexity Computer: verbindt met OAuth, niets te plakken.
• Paperclip: verbindt met OAuth, niets te plakken.
• Gemini: verbindt met OAuth, niets te plakken.
• Grok Build: meldt zich aan vanuit de terminal met hermoso auth login, niets te plakken; een terminalagent, dus de CLI is het goedkopere pad voor lange runs.
• Kimi Code: voegt de gehoste URL toe aan mcp.json en meldt zich aan met /mcp-config login, niets te plakken; een terminalagent, dus de CLI is het goedkopere pad voor lange runs.
• DeepSeek Harness: meldt zich aan vanuit de terminal met hermoso auth login en draait Hermoso als lokale server, niets te plakken.
• Manus: neemt een API-sleutel in een Authorization-header.
• Muse, ingesteld met één chatbericht dat met OAuth verbindt, niets te plakken.

Vier clients hebben bewust geen eigen pagina, en het is de moeite waard om te zeggen waarom, in plaats van meer ondersteuning te suggereren dan we hebben getest. VS Code: Hermoso publiceert een deeplink voor VS Code met één klik, maar er is nergens een VS Code-installatieblok in het product en er is geen geteste route, dus er is geen pagina die er een claimt. De deeplink installeert het kale eindpunt en laat de authenticatie over aan de eigen OAuth van VS Code. Claude Desktop: Claude Desktop gebruikt dezelfde Connectors-flow als claude.ai, dus het wordt gedekt door de Claude-pagina en niet gedupliceerd. Grok: Grok-chat verbindt vandaag via de setupkaart op /mcp; er is nog geen eigen pagina omdat de kopie per kanaal de ChatGPT-pagina's zou dupliceren zonder iets toe te voegen wat alleen wij kunnen zeggen. Muse: Meta Muse wordt ingesteld met één chatbericht in plaats van een instellingenscherm, dus de gids is met de hand geschreven op hermoso.ai/muse en niet hier gegenereerd.

Elk kanaal, vanuit elk van hen

De client verandert niet wat bereikbaar is. Vanuit elk van hen kun je publiceren en inplannen op Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram en Google Business Profile. Je kunt onderzoek doen in de advertentiebibliotheken van Meta, Google en LinkedIn, plus organische TikTok-, Instagram-, YouTube-, Reddit- en Threads-content; afgewerkte beeld- en video-advertenties renderen met meer dan 100 modellen; en campagnes bouwen op Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads en AppLovin Ads.

Eén publicatieoppervlak is gebouwd en ingehouden, in afwachting van het platform: Reddit. Organisch posten en postanalyses zijn gebouwd, maar het Responsible Builder Policy van Reddit vereist een expliciete schriftelijke goedkeuring voordat een app de Data API mag gebruiken, en die aanvraag is niet verleend. De connector wordt daarom ingehouden in plaats van als OAuth-scherm te worden aangeboden dat naar een dode API leidt. Reddit Ads is een andere verbinding en die is live: de volledige campagnestructuur, forecasting, zoeken naar targeting, pixels en leadformulieren.

Wat geen client zelf kan

Een agent met een budget is alleen nuttig als de schade beperkt blijft, dus de afscheiding zit op de server en niet in een prompt. Elke advertentiecampagne, advertentieset, advertentiegroep en advertentie wordt aangemaakt als gepauzeerd, en de statusschakelaars die echt geld in beweging zetten weigeren te draaien zonder een expliciete bevestigingsvlag. Elke render wordt eerst geoffreerd (hermoso_capabilities publiceert de exacte creditkosten van elk model voordat er iets wordt uitgegeven). Credits worden gereserveerd voordat de eerste providerroep plaatsvindt en daarna verrekend tegen de exacte kosten, zodat een mislukte aanvraag wordt terugbetaald in plaats van dat je voor niets belast wordt. Verwijderen vereist ook bevestiging, en elke campagnestructuur wordt teruggelezen uit het advertentieplatform voordat je agent je vertelt wat er is gebouwd.

Eén stap is bewust aan jou: elk account één keer koppelen. De meeste kanalen koppelen via het eigen OAuth-toestemmingsscherm van het platform in een browser; Bluesky vraagt om een app-wachtwoord en Telegram om een bottoken, die je in Hermoso plakt. Daarna is alles een toolaanroep.

Veelgestelde vragen

Werkt Hermoso met elke MCP-client?

Via stdio ja. Elke client die npx -y hermoso mcp kan starten krijgt alle 922+ tools. Via het gehoste eindpunt is het alleen streambare HTTP: er is geen verouderde HTTP+SSE-route, dus een client die alleen het oude transport spreekt heeft niets om mee te verbinden.

Heb ik een API-sleutel nodig, of werkt OAuth?

Beide paden bestaan. Het gehoste eindpunt ondersteunt OAuth met dynamische clientregistratie en PKCE. Zo melden de Claude-, ChatGPT-, Perplexity-, Le Chat-, Claude Cowork-, Perplexity Computer-, Paperclip- en Gemini-connectors zich aan zonder iets te plakken. Clients die een lokaal proces starten, melden zich één keer aan met hermoso auth login. Een client die geen van beide kan, stuurt een API-sleutel (hmk_…) in een Authorization: Bearer-header, aangemaakt op het tabblad MCP & CLI, onder Terminal & API-sleutels.

Wat is het MCP-eindpuntadres?

https://app.hermoso.ai/mcp, gedeclareerd als streambare HTTP-remote in de serverkaart op /.well-known/mcp.json. Het pakket heet hermoso op npm en io.github.hermoso-ai/hermoso in het officiële MCP-register.