任意の MCP クライアントから Hermoso を使う

Q: MCP のエンドポイントの URL は何ですか？

https://app.hermoso.ai/mcp, declared as a streamable-HTTP remote in the server card at /.well-known/mcp.json. The package is hermoso on npm and io.github.hermoso-ai/hermoso in the official MCP registry.

Hermoso のサーバーは素直な Model Context Protocol サーバーなので、「どのクライアントか」は主に設定の書き方の問題で、機能の問題ではありません。入り口は2つあり、どちらも同じ922以上のツールに届きます。

2つのトランスポート

ホスト型、ストリーミング HTTP: https://app.hermoso.ai/mcp。ほとんどのクライアントが求めるのはこちらです。動的クライアント登録と PKCE を使う OAuth に対応しているので、認可の流れを完全に扱えるクライアントは、キーをまったく必要としません。扱えないクライアントは、代わりに Authorization: Bearer hmk_… ヘッダーを送れます。注意点として、これはストリーミング HTTP のみです。従来の HTTP+SSE のエンドポイントはないので、古いトランスポートしか話せないクライアントは、ここに接続できません。
stdio、npm 経由: npx -y hermoso mcp。キーは HERMOSO_TOKEN に入れます。どの stdio の MCP クライアントも読み込めます。同じパッケージは CLI（npm install -g hermoso）としても使えます。これはターミナルのエージェント向けのトークン節約の方法です。ターンごとに922以上のツールのマニフェストを抱える代わりに、コマンドごとにシェルから呼び出します。

エージェントは /.well-known/mcp.json にあるサーバーカードを自動で見つけられます。また、公式の MCP レジストリに io.github.hermoso-ai/hermoso として掲載されています。

汎用の設定ブロック

ほとんどのクライアントは、この書き方のどれかを受け付けます。

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

キーは Hermoso の MCP & CLI → ターミナルと API キーで作成してください。例外が1つだけあります。Codex は JSON ではなく TOMLを読みます。そのため、コピーした mcpServers ブロックは Codex では読み込まれません。代わりに必要な4行は Codex のページをご覧ください。

専用のページがあるクライアント

Claude: OAuth で接続します。貼り付けるものはありません。
ChatGPT: OAuth で接続します。貼り付けるものはありません。
Claude Code: ターミナルから hermoso auth login でサインインします。貼り付けるものはありません。ターミナルのエージェントなので、長い作業には CLI のほうが安く済みます。
Cursor: ターミナルから hermoso auth login でサインインします。貼り付けるものはありません。
Codex: ターミナルから hermoso auth login でサインインします。貼り付けるものはありません。ターミナルのエージェントなので、長い作業には CLI のほうが安く済みます。
Cline: Authorization ヘッダーに APIキーを入れます。
OpenClaw: ターミナルから hermoso auth login でサインインします。貼り付けるものはありません。ターミナルのエージェントなので、長い作業には CLI のほうが安く済みます。
Grok Bot: Hermoso Marketing Bot のテンプレートを追加し、チャットで APIキーを入力するか、Bot 自身のターミナルからサインインします。
Hermes: ターミナルから hermoso auth login でサインインします。貼り付けるものはありません。ターミナルのエージェントなので、長い作業には CLI のほうが安く済みます。
Gemini CLI: ターミナルから hermoso auth login でサインインします。貼り付けるものはありません。ターミナルのエージェントなので、長い作業には CLI のほうが安く済みます。
Perplexity: OAuth で接続します。貼り付けるものはありません。
Le Chat: OAuth で接続します。貼り付けるものはありません。
Claude Cowork: OAuth で接続します。貼り付けるものはありません。
Perplexity Computer: OAuth で接続します。貼り付けるものはありません。
Paperclip: OAuth で接続します。貼り付けるものはありません。
Gemini: OAuth で接続します。貼り付けるものはありません。
Grok Build: ターミナルから hermoso auth login でサインインします。貼り付けるものはありません。ターミナルのエージェントなので、長い作業には CLI のほうが安く済みます。
Kimi Code: ホスト型の URL を mcp.json に追加し、/mcp-config login でサインインします。貼り付けるものはありません。ターミナルのエージェントなので、長い作業には CLI のほうが安く済みます。
DeepSeek Harness: ターミナルから hermoso auth login でサインインし、Hermoso をローカルのサーバーとして動かします。貼り付けるものはありません。
Manus: Authorization ヘッダーに APIキーを入れます。
Muse: チャットのメッセージ1通で設定します。OAuth で接続します。貼り付けるものはありません。

自分のページを持たないクライアントが4つあります。それを、テストしていない範囲の対応を匂わせるのではなく、理由とともに書いておきます。VS Code: Hermoso は1クリックの VS Code のディープリンクを公開していますが、製品のどこにも VS Code のインストールブロックはなく、テスト済みの方法もないので、そう主張するページは作っていません。このディープリンクは素のエンドポイントをインストールし、認証は VS Code 自身の OAuth に任せます。Claude Desktop: Claude Desktop は claude.ai と同じ Connectors の流れを使うので、重複させずに Claude のページでカバーしています。Grok: Grok のチャットは、今のところ /mcp のセットアップカードから接続します。ChatGPT のページと内容が重複するだけで、私たちにしか言えないことを加えられないので、まだ独自のページはありません。Muse: Meta Muse は設定画面ではなく、チャットのメッセージ1通で設定します。そのため、ガイドはここで自動生成せず、hermoso.ai/muse に手で書いています。

どのクライアントからも、すべてのチャネル

クライアントを変えても、届く範囲は変わりません。どれからでも、Facebook、Instagram、Threads、TikTok、YouTube、X、LinkedIn、Pinterest、Bluesky、Telegram、Google ビジネスプロフィールへの投稿と予約ができます。Meta、Google、LinkedIn の広告ライブラリと、TikTok、Instagram、YouTube、Reddit、Threads のオーガニック投稿でリサーチできます。100以上のモデルで完成した画像と動画の広告をレンダリングできます。Meta、Google Ads、Microsoft Advertising、Reddit Ads、LinkedIn、Pinterest、X Ads、TikTok Ads、Snapchat Ads、ChatGPT Ads、Apple Search Ads、AppLovin Ads でキャンペーンを組めます。

1つの投稿の窓口は、作ってあるものの、プラットフォーム側の準備待ちで保留しています。Reddit の場合です。オーガニックの投稿と投稿の統計は作ってありますが、Reddit の Responsible Builder Policy では、アプリが Data API を使う前に書面による明示的な承認が必要で、その申請はまだ承認されていません。そのため、接続は保留しています。承認されないまま、行き止まりの API につながる OAuth の画面を出すことはしていません。Reddit Ads は別の接続で、こちらは稼働しています。キャンペーンのツリー全体、予測、ターゲティングの検索、ピクセル、リードフォームが使えます。

どのクライアントにもできないこと

予算を持つエージェントは、影響範囲が限られていて初めて役に立ちます。そのため、制限はプロンプトではなくサーバー側にあります。すべての広告キャンペーン、広告セット、広告グループ、広告は一時停止の状態で作られ、実際のお金を動かすステータス切り替えは、明示的な確認フラグがないと実行されません。すべてのレンダリングは、先に見積もりを出します（hermoso_capabilities が、支出の前にモデルごとの正確なクレジット単価を公開します）。クレジットは、最初のプロバイダー呼び出しの前に確保され、あとで正確な費用で精算されます。そのため、送信に失敗した場合は、何も得ていないのに課金されたままになるのではなく、返金されます。削除も確認が必要です。また、どの広告キャンペーンのツリーも、エージェントが作ったものを報告する前に、広告プラットフォームから読み直されます。

1つだけ、あえてあなた自身の作業として残しているものがあります。各アカウントを一度だけ連携させることです。ほとんどのチャネルは、ブラウザでプラットフォーム自身の OAuth の同意画面を通して連携します。Bluesky はアプリパスワードを、Telegram はボットトークンを使い、Hermoso に貼り付けます。その後の作業は、すべてツールの呼び出しです。

よくある質問

Hermoso は、どの MCP クライアントでも動きますか？

stdio なら、はい。npx -y hermoso mcp を起動できるクライアントは、922以上のツールすべてを使えます。ホスト型のエンドポイントでは、ストリーミング HTTP のみに対応しています。従来の HTTP+SSE のルートはないので、古いトランスポートしか話せないクライアントは接続できません。

APIキーは必要ですか？ OAuth でも使えますか？

どちらも使えます。ホスト型のエンドポイントは、動的クライアント登録と PKCE を使う OAuth に対応しています。Claude、ChatGPT、Perplexity、Le Chat、Claude Cowork、Perplexity Computer、Paperclip、Gemini のコネクタは、これで何も貼り付けずにサインインします。ローカルのプロセスを起動するクライアントは、代わりに hermoso auth login で一度サインインします。どちらもできないクライアントは、APIキー（hmk_…）を Authorization: Bearer ヘッダーで送ります。そのキーは、MCP & CLI のタブの「ターミナルと API キー」で作成します。

MCP のエンドポイントの URL は何ですか？

https://app.hermoso.ai/mcp です。/.well-known/mcp.json のサーバーカードで、ストリーミング HTTP のリモートとして宣言されています。パッケージ名は npm の hermoso、公式 MCP レジストリでは io.github.hermoso-ai/hermoso です。

無料で始められて、カードは不要です。どのプランでもすべての機能が使えます。クレジットを使うのは AI モデルと Ad Spy のリサーチだけで、投稿、予約、広告管理、分析は無料です。

無料で始める → 料金を見る

任意の MCP クライアントから Hermoso を動かす