Hermoso 的服务器是一个普通的模型上下文协议服务器,因此“用哪个客户端”主要是配置语法的问题,而不是能力的问题。进入的方式有两种,两者都能访问同样的 922+ 个工具。
两种传输方式
- 托管,流式 HTTP:
https://app.hermoso.ai/mcp。这是大多数客户端想要的方式。它支持带动态客户端注册和 PKCE 的 OAuth,因此能完整走授权流程的客户端无需任何密钥;不支持的客户端则可以改为发送Authorization: Bearer hmk_…请求头。注意它只支持流式 HTTP。没有旧的 HTTP+SSE 端点,因此只支持旧传输方式的客户端在这里无法连接。 - stdio,通过 npm:
npx -y hermoso mcp,密钥放在HERMOSO_TOKEN中。任何支持 stdio 的 MCP 客户端都能加载它。同一个包也是一个命令行工具(npm install -g hermoso),对终端智能体来说是更省 token 的路线:它们逐条调用命令,而不是在每一轮对话中携带一个 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 → Terminal & API keys 下创建密钥。有一个客户端是例外:Codex 读取的是 TOML,不是 JSON,因此直接复制 mcpServers 配置块在那里无法加载。Codex 需要的四行配置请看 Codex 页面。
拥有各自页面的客户端
- Claude:通过 OAuth 连接,无需粘贴任何内容。
- ChatGPT:通过 OAuth 连接,无需粘贴任何内容。
- Claude Code:在终端里用 hermoso auth login 登录,无需粘贴任何内容;它是终端智能体,因此长时间运行时命令行工具是更省钱的路线。
- Cursor:在终端里用 hermoso auth login 登录,无需粘贴任何内容。
- Codex:在终端里用 hermoso auth login 登录,无需粘贴任何内容;它是终端智能体,因此长时间运行时命令行工具是更省钱的路线。
- Cline:在 Authorization 请求头中填写 API 密钥。
- OpenClaw:在终端里用 hermoso auth login 登录,无需粘贴任何内容;它是终端智能体,因此长时间运行时命令行工具是更省钱的路线。
- Grok Bot:添加 Hermoso 营销机器人模板,并在聊天中填写 API 密钥,或在 Bot 自己的终端中登录。
- Hermes:在终端里用 hermoso auth login 登录,无需粘贴任何内容;它是终端智能体,因此长时间运行时命令行工具是更省钱的路线。
- Gemini CLI:在终端里用 hermoso auth login 登录,无需粘贴任何内容;它是终端智能体,因此长时间运行时命令行工具是更省钱的路线。
- Perplexity:通过 OAuth 连接,无需粘贴任何内容。
- Le Chat:通过 OAuth 连接,无需粘贴任何内容。
- Claude Cowork:通过 OAuth 连接,无需粘贴任何内容。
- Perplexity Computer:通过 OAuth 连接,无需粘贴任何内容。
- Paperclip:通过 OAuth 连接,无需粘贴任何内容。
- Gemini:通过 OAuth 连接,无需粘贴任何内容。
- Grok Build:在终端里用 hermoso auth login 登录,无需粘贴任何内容;它是终端智能体,因此长时间运行时命令行工具是更省钱的路线。
- Kimi Code:把托管网址添加到 mcp.json,并用 /mcp-config login 登录,无需粘贴任何内容;它是终端智能体,因此长时间运行时命令行工具是更省钱的路线。
- DeepSeek Harness:在终端里用 hermoso auth login 登录,并把 Hermoso 作为本地服务器运行,无需粘贴任何内容。
- Manus:在 Authorization 请求头中填写 API 密钥。
- Muse,通过一条聊天消息完成设置,使用 OAuth 连接,无需粘贴任何内容。
有四个客户端刻意没有自己的页面,值得说明原因,而不是暗示我们支持的范围比实际测试过的更广。VS Code:Hermoso 提供一键 VS Code 深度链接,但产品中没有任何 VS Code 安装配置块,也没有经过测试的路径,因此不设页面来声称支持。该深度链接只安装裸端点,身份验证交给 VS Code 自己的 OAuth。Claude Desktop:Claude Desktop 使用与 claude.ai 完全相同的连接器流程,因此由 Claude 页面覆盖,不再重复撰写。Grok:Grok 聊天目前通过 /mcp 上的设置卡片连接;它暂时没有自己的页面,因为它的各渠道文案会与 ChatGPT 页面重复,而没有新增任何只有我们能说的内容。Muse:Meta Muse 通过一条聊天消息完成设置,而不是设置页面,因此它的指南是手写的,位于 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 上搭建广告系列。
有一个发布渠道已经做好,但在等待平台方:Reddit。有机发布和帖子数据统计已经完成,但 Reddit 的负责任构建者政策要求,应用在使用数据 API 之前必须获得明确的书面批准,而这份批准尚未下达。因此该连接器被暂时搁置,而不是提供一个通往无效 API 的 OAuth 页面。Reddit Ads 则是另一种连接,已经上线:完整的广告系列体系、预测、定向搜索、像素和潜在客户表单都可用。
任何客户端自己都做不到的事
智能体手里有预算,只有在影响范围有界的前提下才有用,因此约束放在服务器里,而不是提示词里。每一个广告系列、广告组和广告,都以暂停状态创建,能够启动真实资金花费的状态开关,如果没有明确的确认标记,都会拒绝运行。每次渲染都会先报价(hermoso_capabilities 会在任何花费之前公布每个模型的精确积分成本)。积分在第一次调用模型供应商之前预留,之后按精确成本结算,因此派发失败会退款,而不会让你为没有得到的结果付费。删除操作同样需要确认,并且每个广告系列结构在智能体告诉你它搭建了什么之前,都会从广告平台回读一遍。
有一个步骤刻意留给你:每个账户只需连接一次。大多数渠道通过平台自己的 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 登录。两者都不支持的客户端,可以在 Authorization: Bearer 请求头中发送 API 密钥(hmk_…),密钥在 MCP与CLI 标签页的“Terminal & API keys”下创建。
MCP 端点的网址是什么?
https://app.hermoso.ai/mcp,在 /.well-known/mcp.json 的服务器卡片中声明为流式 HTTP 远程端点。该包在 npm 上的名称是 hermoso,在官方 MCP 注册表中的名称是 io.github.hermoso-ai/hermoso。