Utiliser Hermoso depuis n'importe quel client MCP

Le serveur de Hermoso est un serveur Model Context Protocol ordinaire, donc « quel client ? » est surtout une question de syntaxe de configuration plutôt que de capacités. Il existe deux façons d'y accéder, et les deux donnent accès aux mêmes plus de 922 outils.

Les deux transports

• Hébergé, HTTP en streaming : https://app.hermoso.ai/mcp. C'est celui que la plupart des clients demandent. Il prend en charge OAuth avec enregistrement dynamique du client et PKCE, donc un client qui gère le flux d'autorisation complet n'a besoin d'aucune clé ; un client qui ne le gère pas peut envoyer à la place un en-tête Authorization: Bearer hmk_…. Attention, il s'agit uniquement de HTTP en streaming. Il n'existe pas de point de terminaison HTTP+SSE historique, donc un client qui ne parle que l'ancien transport n'a rien à quoi se connecter ici.
• stdio, via npm : npx -y hermoso mcp, avec votre clé dans HERMOSO_TOKEN. N'importe quel client MCP en stdio peut le charger. Le même paquet est aussi une CLI (npm install -g hermoso), qui est le chemin économe en jetons pour les agents de terminal : ils lancent une commande à chaque fois au lieu de porter un manifeste de plus de 922 outils à chaque tour.

Les agents peuvent découvrir automatiquement la fiche du serveur à /.well-known/mcp.json, et il figure dans le registre officiel MCP sous le nom io.github.hermoso-ai/hermoso.

Le bloc de configuration générique

La plupart des clients acceptent une variante de ceci :

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

Créez la clé dans Hermoso sous MCP & CLI → Terminal et clés API. Un client fait exception : Codex lit du TOML, pas du JSON, donc un bloc mcpServers copié ne s'y chargera pas. Voir la page Codex pour les quatre lignes qu'il demande à la place.

Les clients qui ont leur propre page

• Claude : se connecte avec OAuth, rien à coller.
• ChatGPT : se connecte avec OAuth, rien à coller.
• Claude Code : se connecte depuis le terminal avec hermoso auth login, rien à coller ; c'est un agent de terminal, donc la CLI est le chemin le moins coûteux pour les longues sessions.
• Cursor : se connecte depuis le terminal avec hermoso auth login, rien à coller.
• Codex : se connecte depuis le terminal avec hermoso auth login, rien à coller ; c'est un agent de terminal, donc la CLI est le chemin le moins coûteux pour les longues sessions.
• Cline : prend une clé API dans un en-tête Authorization.
• OpenClaw : se connecte depuis le terminal avec hermoso auth login, rien à coller ; c'est un agent de terminal, donc la CLI est le chemin le moins coûteux pour les longues sessions.
• Grok Bot : ajoute le modèle Hermoso Marketing Bot et prend une clé API dans le chat, ou se connecte depuis le terminal propre au Bot.
• Hermes : se connecte depuis le terminal avec hermoso auth login, rien à coller ; c'est un agent de terminal, donc la CLI est le chemin le moins coûteux pour les longues sessions.
• Gemini CLI : se connecte depuis le terminal avec hermoso auth login, rien à coller ; c'est un agent de terminal, donc la CLI est le chemin le moins coûteux pour les longues sessions.
• Perplexity : se connecte avec OAuth, rien à coller.
• Le Chat : se connecte avec OAuth, rien à coller.
• Claude Cowork : se connecte avec OAuth, rien à coller.
• Perplexity Computer : se connecte avec OAuth, rien à coller.
• Paperclip : se connecte avec OAuth, rien à coller.
• Gemini : se connecte avec OAuth, rien à coller.
• Grok Build : se connecte depuis le terminal avec hermoso auth login, rien à coller ; c'est un agent de terminal, donc la CLI est le chemin le moins coûteux pour les longues sessions.
• Kimi Code : ajoute l'URL hébergée à mcp.json et se connecte avec /mcp-config login, rien à coller ; c'est un agent de terminal, donc la CLI est le chemin le moins coûteux pour les longues sessions.
• DeepSeek Harness : se connecte depuis le terminal avec hermoso auth login et lance Hermoso comme serveur local, rien à coller.
• Manus : prend une clé API dans un en-tête Authorization.
• Muse, configuré par un seul message de chat qui se connecte avec OAuth, rien à coller.

Quatre clients n'ont volontairement pas de page propre, et il vaut la peine de dire pourquoi plutôt que de suggérer une prise en charge plus large que celle que nous avons testée. VS Code : Hermoso publie un lien profond VS Code en un clic, mais il n'existe nulle part dans le produit de bloc d'installation pour VS Code et aucun chemin testé, donc il n'y a pas de page qui en affirme un. Le lien profond installe le point de terminaison nu et laisse l'authentification à l'OAuth de VS Code. Claude Desktop : Claude Desktop utilise exactement le même flux Connecteurs que claude.ai, il est donc couvert par la page Claude plutôt que dupliqué. Grok : le chat Grok se connecte aujourd'hui via la carte de configuration sur /mcp ; il n'a pas encore de page propre, car son texte par canal ferait doublon avec les pages ChatGPT sans rien apporter que nous serions seuls à dire. Muse : Meta Muse se configure par un seul message de chat plutôt que par un écran de réglages, donc son guide est rédigé à la main sur hermoso.ai/muse plutôt que généré ici.

Tous les canaux, depuis n'importe lequel d'entre eux

Le client ne change pas ce qui est accessible. Depuis n'importe lequel : publier et programmer sur Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram, Google Business Profile ; rechercher dans les bibliothèques Meta, Google et LinkedIn ainsi que dans les contenus organiques TikTok, Instagram, YouTube, Reddit et Threads ; produire des pubs image et vidéo finies sur plus de 100 modèles ; et construire des campagnes sur Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads et AppLovin Ads.

Une surface de publication est construite mais retenue, en attente de la plateforme : Reddit. La publication organique et les statistiques de posts sont construites, mais la Responsible Builder Policy de Reddit exige une autorisation écrite explicite avant qu'une appli puisse utiliser l'API de données, et cette demande n'a pas été accordée. Le connecteur est retenu plutôt que proposé comme un écran OAuth qui mène à une API inopérante. Reddit Ads est une connexion distincte, et elle est active : l'arborescence complète des campagnes, les prévisions, la recherche de ciblage, les pixels et les formulaires de prospects.

Ce qu'aucun client ne peut faire seul

Un agent doté d'un budget n'est utile que si l'impact d'une erreur est limité, donc la barrière est dans le serveur et non dans une consigne. Chaque campagne, ensemble de publicités, groupe d'annonces et annonce est créé en pause, et les bascules de statut qui activent de l'argent réel refusent de s'exécuter sans indicateur de confirmation explicite. Chaque rendu est chiffré d'abord (hermoso_capabilities publie le coût exact en crédits de chaque modèle avant toute dépense). Les crédits sont réservés avant le premier appel au fournisseur, puis réglés au coût exact, donc un envoi échoué est remboursé au lieu de vous laisser facturé pour rien. Les suppressions sont aussi soumises à confirmation, et chaque arborescence de campagne est relue depuis la plateforme publicitaire avant que votre agent ne vous dise ce qu'il a construit.

Une étape vous revient volontairement : relier chaque compte, une fois. La plupart des canaux se relient via l'écran de consentement OAuth de la plateforme, dans un navigateur ; Bluesky demande un mot de passe d'application et Telegram un jeton de bot, collés dans Hermoso. Tout le reste ensuite est un appel d'outil.

Questions fréquentes

Hermoso fonctionne-t-il avec n'importe quel client MCP ?

En stdio, oui. Tout client capable de lancer npx -y hermoso mcp obtient les plus de 922 outils. Sur le point de terminaison hébergé, il n'y a que HTTP en streaming : aucune route HTTP+SSE historique n'existe, donc un client qui ne parle que l'ancien transport n'a rien à quoi se connecter.

Ai-je besoin d'une clé API, ou OAuth fonctionne-t-il ?

Les deux chemins existent. Le point de terminaison hébergé prend en charge OAuth avec enregistrement dynamique du client et PKCE, c'est ainsi que les connecteurs Claude, ChatGPT, Perplexity, Le Chat, Claude Cowork, Perplexity Computer, Paperclip et Gemini se connectent sans rien coller. Les clients qui lancent un processus local se connectent une fois avec hermoso auth login à la place, et un client qui ne peut faire ni l'un ni l'autre envoie une clé API (hmk_…) dans un en-tête Authorization: Bearer, créée sur l'onglet MCP & CLI, sous Terminal et clés API.

Quelle est l'URL du point de terminaison MCP ?

https://app.hermoso.ai/mcp, déclarée comme distante en HTTP en streaming dans la fiche du serveur à /.well-known/mcp.json. Le paquet s'appelle hermoso sur npm, et io.github.hermoso-ai/hermoso dans le registre officiel MCP.