Usa Hermoso da qualsiasi client MCP

Il server di Hermoso è un normale server Model Context Protocol, quindi "quale client?" è soprattutto una questione di sintassi della configurazione e non di capacità. Ci sono due modi per entrare, e tutti e due raggiungono gli stessi 922+ strumenti.

I due trasporti

• Ospitato, HTTP streamable: https://app.hermoso.ai/mcp. È quello che vogliono la maggior parte dei client. Supporta OAuth con registrazione dinamica del client e PKCE, quindi un client che parla il flusso di autorizzazione completo non ha bisogno di alcuna chiave; un client che non lo fa può invece inviare un header Authorization: Bearer hmk_…. Nota che è solo HTTP streamable. Non esiste un endpoint HTTP+SSE legacy, quindi un client che parla solo il vecchio trasporto qui non ha a cosa connettersi.
• stdio, tramite npm: npx -y hermoso mcp, con la tua chiave in HERMOSO_TOKEN. Qualsiasi client MCP via stdio può caricarlo. Lo stesso pacchetto è anche una CLI (npm install -g hermoso), che è il percorso economico in token per gli agenti da terminale: lanciano un comando alla volta invece di portarsi dietro un manifesto di 922+ strumenti a ogni turno.

Gli agenti possono scoprire automaticamente la scheda del server in /.well-known/mcp.json, ed è elencato nel registro ufficiale MCP come io.github.hermoso-ai/hermoso.

Il blocco di configurazione generico

La maggior parte dei client accetta una variante di questo:

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

Crea la chiave in Hermoso sotto MCP & CLI → Terminal & chiavi API. Un client fa eccezione: Codex legge TOML, non JSON, quindi un blocco mcpServers copiato lì non verrà caricato. Vedi la pagina Codex per le quattro righe che richiede.

Client con una pagina dedicata

• Claude: si connette con OAuth, niente da incollare.
• ChatGPT: si connette con OAuth, niente da incollare.
• Claude Code: accede dal terminale con hermoso auth login, niente da incollare; è un agente da terminale, quindi la CLI è il percorso più economico per le esecuzioni lunghe.
• Cursor: accede dal terminale con hermoso auth login, niente da incollare.
• Codex: accede dal terminale con hermoso auth login, niente da incollare; è un agente da terminale, quindi la CLI è il percorso più economico per le esecuzioni lunghe.
• Cline: accetta una chiave API in un header Authorization.
• OpenClaw: accede dal terminale con hermoso auth login, niente da incollare; è un agente da terminale, quindi la CLI è il percorso più economico per le esecuzioni lunghe.
• Grok Bot: aggiunge il template Hermoso Marketing Bot e accetta una chiave API nella chat, oppure accede dal terminale del Bot stesso.
• Hermes: accede dal terminale con hermoso auth login, niente da incollare; è un agente da terminale, quindi la CLI è il percorso più economico per le esecuzioni lunghe.
• Gemini CLI: accede dal terminale con hermoso auth login, niente da incollare; è un agente da terminale, quindi la CLI è il percorso più economico per le esecuzioni lunghe.
• Perplexity: si connette con OAuth, niente da incollare.
• Le Chat: si connette con OAuth, niente da incollare.
• Claude Cowork: si connette con OAuth, niente da incollare.
• Perplexity Computer: si connette con OAuth, niente da incollare.
• Paperclip: si connette con OAuth, niente da incollare.
• Gemini: si connette con OAuth, niente da incollare.
• Grok Build: accede dal terminale con hermoso auth login, niente da incollare; è un agente da terminale, quindi la CLI è il percorso più economico per le esecuzioni lunghe.
• Kimi Code: aggiunge l'URL ospitato a mcp.json e accede con /mcp-config login, niente da incollare; è un agente da terminale, quindi la CLI è il percorso più economico per le esecuzioni lunghe.
• DeepSeek Harness: accede dal terminale con hermoso auth login ed esegue Hermoso come server locale, niente da incollare.
• Manus: accetta una chiave API in un header Authorization.
• Muse, configurato con un solo messaggio in chat che si connette con OAuth, niente da incollare.

Quattro client non hanno una pagina propria, di proposito, e vale la pena dire perché invece di lasciar intendere un supporto più ampio di quello che abbiamo testato. VS Code: Hermoso pubblica un deeplink di VS Code con un clic, ma nel prodotto non c'è alcun blocco di installazione per VS Code e non esiste un percorso testato, quindi non c'è una pagina che ne sostenga uno. Il deeplink installa il solo endpoint e lascia l'autenticazione all'OAuth di VS Code. Claude Desktop: Claude Desktop usa lo stesso flusso Connettori di claude.ai, quindi è coperto dalla pagina Claude invece di essere duplicato. Grok: Grok in chat si connette oggi tramite la scheda di configurazione su /mcp; non ha ancora una pagina propria perché il suo testo per canale duplicherebbe le pagine ChatGPT senza aggiungere nulla che possiamo dire solo noi. Muse: Meta Muse si configura con un messaggio in chat invece che con una schermata delle impostazioni, quindi la sua guida è scritta a mano su hermoso.ai/muse invece di essere generata qui.

Ogni canale, da qualsiasi client

Il client non cambia ciò che è raggiungibile. Da qualsiasi di essi: pubblichi e programmi su Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram, Google Business Profile; ricerchi nelle librerie di Meta, Google e LinkedIn più TikTok, Instagram, YouTube, Reddit e Threads organici; generi annunci finiti immagine e video su oltre 100 modelli; e costruisci campagne su Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads e AppLovin Ads.

Una superficie di pubblicazione è costruita ma trattenuta, in attesa della piattaforma: Reddit. Pubblicazione organica e statistiche dei post sono costruite, ma la Responsible Builder Policy di Reddit richiede un'approvazione scritta esplicita prima che un'app possa usare la Data API, e quel via libera non è ancora arrivato. Il connettore è trattenuto invece di essere offerto come schermata OAuth che porta a un'API non funzionante. Reddit Ads è un'altra connessione ed è attiva: l'intero albero delle campagne, le previsioni, la ricerca di targeting, i pixel e i moduli lead.

Cosa nessun client può fare da solo

Un agente con un budget è utile solo se il raggio d'azione è limitato, quindi il vincolo sta nel server e non in un prompt. Ogni campagna pubblicitaria, set di annunci, gruppo di annunci e annuncio viene creato in pausa, e gli interruttori di stato che attivano denaro reale si rifiutano di funzionare senza un flag di conferma esplicito. Ogni render viene prima preventivato (hermoso_capabilities pubblica il costo esatto in crediti di ogni modello prima che qualsiasi cosa venga speso). I crediti vengono riservati prima della prima chiamata al provider e poi addebitati al costo esatto, così un invio fallito viene rimborsato invece di lasciarti addebitato per nulla. Anche le eliminazioni richiedono conferma, e ogni albero di campagne viene riletto dalla piattaforma pubblicitaria prima che il tuo agente ti dica cosa ha costruito.

Un passaggio è volutamente tuo: collegare ogni account, una volta. La maggior parte dei canali si collega tramite la schermata di consenso OAuth della piattaforma in un browser; Bluesky richiede una password per app e Telegram un token di bot, incollati in Hermoso. Tutto il resto, dopo, è una chiamata a uno strumento.

Domande frequenti

Hermoso funziona con qualsiasi client MCP?

Via stdio, sì. Qualsiasi client che può avviare npx -y hermoso mcp ottiene tutti i 922+ strumenti. Sull'endpoint ospitato funziona solo HTTP streamable: non esiste una route HTTP+SSE legacy, quindi un client che parla solo il vecchio trasporto non ha a cosa connettersi.

Serve una chiave API o funziona OAuth?

Esistono entrambi i percorsi. L'endpoint ospitato supporta OAuth con registrazione dinamica del client e PKCE, ed è così che i connettori Claude, ChatGPT, Perplexity, Le Chat, Claude Cowork, Perplexity Computer, Paperclip e Gemini accedono senza che si incolli nulla. I client che avviano un processo locale accedono una volta con hermoso auth login, e un client che non può fare nessuno dei due invia una chiave API (hmk_…) in un header Authorization: Bearer, creata nella scheda MCP & CLI, sotto Terminal & chiavi API.

Qual è l'URL dell'endpoint MCP?

https://app.hermoso.ai/mcp, dichiarato come remoto HTTP streamable nella scheda del server su /.well-known/mcp.json. Il pacchetto è hermoso su npm e io.github.hermoso-ai/hermoso nel registro ufficiale MCP.