Chạy Hermoso từ mọi client MCP

Máy chủ của Hermoso là một máy chủ Model Context Protocol thuần, nên câu hỏi “dùng client nào?” chủ yếu là câu hỏi về cú pháp cấu hình chứ không phải về khả năng. Có hai cách kết nối và cả hai đều dẫn tới cùng 922+ công cụ.

Hai kiểu truyền tải

• Hosted, streamable HTTP: https://app.hermoso.ai/mcp. Đây là lựa chọn mà hầu hết client muốn. Nó hỗ trợ OAuth với đăng ký client động và PKCE, nên một client biết toàn bộ luồng ủy quyền không cần khóa nào cả; một client không làm được thì có thể gửi header Authorization: Bearer hmk_…. Lưu ý là chỉ hỗ trợ streamable HTTP. Không có endpoint HTTP+SSE kiểu cũ, nên một client chỉ nói giao thức cũ sẽ không có gì để kết nối ở đây.
• stdio, qua npm: npx -y hermoso mcp, với khóa của bạn trong HERMOSO_TOKEN. Bất kỳ client MCP stdio nào cũng có thể nạp nó. Cùng gói đó cũng là một CLI (npm install -g hermoso), đây là đường đi tiết kiệm token cho các agent terminal: chúng gọi shell cho từng lệnh thay vì mang theo bản kê 922+ công cụ qua mọi lượt.

Các agent có thể tự khám phá server card tại /.well-known/mcp.json, và máy chủ được liệt kê trong registry MCP chính thức với tên io.github.hermoso-ai/hermoso.

Khối cấu hình chung

Hầu hết client đều nhận một dạng viết nào đó của khối này:

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

Tạo khóa trong Hermoso tại MCP & CLI → Khóa Terminal & API. Có một ngoại lệ thật sự: Codex đọc TOML, không đọc JSON, nên một khối mcpServers sao chép nguyên văn sẽ không nạp được ở đó. Xem trang Codex để biết bốn dòng mà nó cần.

Các client có trang riêng

• Claude: kết nối bằng OAuth, không cần dán gì.
• ChatGPT: kết nối bằng OAuth, không cần dán gì.
• Claude Code: đăng nhập từ terminal bằng hermoso auth login, không cần dán gì; là agent terminal nên CLI là đường đi rẻ hơn cho các lần chạy dài.
• Cursor: đăng nhập từ terminal bằng hermoso auth login, không cần dán gì.
• Codex: đăng nhập từ terminal bằng hermoso auth login, không cần dán gì; là agent terminal nên CLI là đường đi rẻ hơn cho các lần chạy dài.
• Cline: nhận khóa API trong header Authorization.
• OpenClaw: đăng nhập từ terminal bằng hermoso auth login, không cần dán gì; là agent terminal nên CLI là đường đi rẻ hơn cho các lần chạy dài.
• Grok Bot: thêm mẫu Hermoso Marketing Bot và nhận khóa API trong chat, hoặc đăng nhập từ terminal của Bot.
• Hermes: đăng nhập từ terminal bằng hermoso auth login, không cần dán gì; là agent terminal nên CLI là đường đi rẻ hơn cho các lần chạy dài.
• Gemini CLI: đăng nhập từ terminal bằng hermoso auth login, không cần dán gì; là agent terminal nên CLI là đường đi rẻ hơn cho các lần chạy dài.
• Perplexity: kết nối bằng OAuth, không cần dán gì.
• Le Chat: kết nối bằng OAuth, không cần dán gì.
• Claude Cowork: kết nối bằng OAuth, không cần dán gì.
• Perplexity Computer: kết nối bằng OAuth, không cần dán gì.
• Paperclip: kết nối bằng OAuth, không cần dán gì.
• Gemini: kết nối bằng OAuth, không cần dán gì.
• Grok Build: đăng nhập từ terminal bằng hermoso auth login, không cần dán gì; là agent terminal nên CLI là đường đi rẻ hơn cho các lần chạy dài.
• Kimi Code: thêm URL hosted vào mcp.json và đăng nhập bằng /mcp-config login, không cần dán gì; là agent terminal nên CLI là đường đi rẻ hơn cho các lần chạy dài.
• DeepSeek Harness: đăng nhập từ terminal bằng hermoso auth login và chạy Hermoso như một máy chủ local, không cần dán gì.
• Manus: nhận khóa API trong header Authorization.
• Muse, thiết lập bằng một tin nhắn chat kết nối bằng OAuth, không cần dán gì.

Có bốn client cố ý không có trang riêng, và đáng nói rõ lý do thay vì ngụ ý hỗ trợ rộng hơn những gì chúng tôi đã thử. VS Code: Hermoso có một deeplink cài đặt VS Code một chạm, nhưng không có khối cài đặt VS Code nào trong sản phẩm và cũng chưa có đường đi đã kiểm thử, nên không có trang nào khẳng định có. Deeplink chỉ cài endpoint trần và để việc xác thực cho OAuth của VS Code. Claude Desktop: Claude Desktop dùng đúng luồng Connectors như claude.ai, nên nó được trang Claude bao phủ thay vì nhân bản. Grok: Grok chat hiện kết nối qua thẻ thiết lập trên /mcp; nó chưa có trang riêng vì nội dung theo từng kênh sẽ trùng với các trang ChatGPT thay vì thêm điều gì mà chỉ chúng tôi mới nói được. Muse: Meta Muse được thiết lập bằng một tin nhắn chat thay vì một màn hình cài đặt, nên hướng dẫn của nó được viết tay tại hermoso.ai/muse thay vì tạo tự động ở đây.

Mọi kênh, từ bất kỳ client nào

Client không thay đổi những gì có thể tiếp cận được. Từ bất kỳ client nào, bạn có thể: đăng và lên lịch lên Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram, Google Business Profile; nghiên cứu thư viện quảng cáo Meta, Google và LinkedIn cùng TikTok, Instagram, YouTube, Reddit và Threads tự nhiên; render quảng cáo ảnh và video hoàn chỉnh trên hơn 100 mô hình; và xây dựng chiến dịch trên Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads và AppLovin Ads.

Có một bề mặt đăng bài đã được xây dựng nhưng đang bị giữ lại, chờ nền tảng: Reddit. Đăng bài tự nhiên và số liệu bài đăng đã được xây dựng, nhưng Chính sách Nhà phát triển có trách nhiệm của Reddit yêu cầu chấp thuận bằng văn bản rõ ràng trước khi một ứng dụng được dùng Data API, và yêu cầu đó chưa được cấp. Connector được giữ lại thay vì đưa ra một màn hình OAuth dẫn tới một API đã chết. Reddit Ads là một kết nối khác và đã hoạt động: toàn bộ cây chiến dịch, dự báo, tìm kiếm nhắm mục tiêu, pixel và biểu mẫu khách hàng tiềm năng.

Điều không client nào tự làm được

Một agent có ngân sách chỉ hữu ích khi phạm vi tác động của nó bị giới hạn, nên hàng rào nằm ở máy chủ chứ không nằm trong prompt. Mọi chiến dịch, nhóm quảng cáo, nhóm quảng cáo và quảng cáo đều được tạo ở trạng thái tạm dừng, và các công tắc trạng thái có thể bật tiền thật sẽ từ chối chạy nếu không có cờ xác nhận rõ ràng. Mọi lần render đều được báo giá trước (hermoso_capabilities công bố chi phí credit chính xác của từng mô hình trước khi có gì được tiêu). Credit được giữ trước khi gọi nhà cung cấp đầu tiên và được quyết toán theo chi phí chính xác sau đó, nên một lần gửi thất bại sẽ được hoàn lại thay vì để bạn bị tính tiền cho hư không. Các thao tác xóa cũng cần xác nhận, và mọi cây chiến dịch đều được đọc lại từ nền tảng quảng cáo trước khi agent của bạn báo cho bạn biết nó đã xây dựng gì.

Có một bước là việc của riêng bạn: liên kết từng tài khoản, một lần. Hầu hết các kênh được liên kết qua màn hình đồng ý OAuth của chính nền tảng trong trình duyệt; Bluesky nhận mật khẩu ứng dụng và Telegram nhận bot token, được dán vào Hermoso. Sau đó mọi việc còn lại đều là một lần gọi công cụ.

Câu hỏi thường gặp

Hermoso có hoạt động với bất kỳ client MCP nào không?

Qua stdio, có. Bất kỳ client nào có thể chạy npx -y hermoso mcp đều nhận được toàn bộ hơn 922 công cụ. Qua endpoint hosted, chỉ hỗ trợ streamable HTTP: không có tuyến HTTP+SSE kiểu cũ, nên một client chỉ nói giao thức cũ sẽ không có gì để kết nối.

Tôi cần khóa API, hay OAuth là đủ?

Cả hai cách đều có. Endpoint hosted hỗ trợ OAuth với đăng ký client động và PKCE, đó là cách các connector Claude, ChatGPT, Perplexity, Le Chat, Claude Cowork, Perplexity Computer, Paperclip và Gemini đăng nhập mà không cần dán gì. Các client khởi chạy một tiến trình local thì đăng nhập một lần bằng hermoso auth login thay thế, và client nào không làm được cả hai thì gửi khóa API (hmk_…) trong header Authorization: Bearer, được tạo ở tab MCP & CLI, dưới Khóa Terminal & API.

URL endpoint MCP là gì?

https://app.hermoso.ai/mcp, được khai báo như một remote streamable-HTTP trong server card tại /.well-known/mcp.json. Gói trên npm là hermoso và trong registry MCP chính thức là io.github.hermoso-ai/hermoso.