어떤 MCP 클라이언트에서든 Hermoso 실행하기

Hermoso의 서버는 평범한 Model Context Protocol 서버이므로, “어떤 클라이언트?”는 대개 기능이 아니라 설정 문법에 관한 질문입니다. 들어가는 방법은 두 가지이며, 둘 다 같은 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 클라이언트라면 무엇이든 불러올 수 있습니다. 같은 패키지는 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 키에서 만듭니다. 한 클라이언트만 예외입니다. Codex는 JSON이 아니라 TOML을 읽으므로 복사한 mcpServers 블록은 거기서 로드되지 않습니다. Codex에 필요한 네 줄은 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: 채팅 메시지 한 통으로 설정하며, OAuth로 연결합니다. 붙여 넣을 것이 없습니다.

네 개의 클라이언트는 자체 페이지가 없습니다. 지원 범위를 실제보다 넓게 암시하지 않도록 이유를 밝혀 둡니다. VS Code: Hermoso는 원클릭 VS Code 딥링크를 제공하지만, 제품 어디에도 VS Code 설치 블록이 없고 검증된 경로도 없으므로 그것을 주장하는 페이지는 없습니다. 딥링크는 기본 엔드포인트만 설치하고, 인증은 VS Code 자체 OAuth에 맡깁니다. Claude Desktop: Claude Desktop은 claude.ai와 같은 Connectors 흐름을 쓰므로, 중복하지 않고 Claude 페이지에서 다룹니다. Grok: Grok 채팅은 지금 /mcp의 설정 카드로 연결합니다. 채널별 안내가 ChatGPT 페이지와 겹치기만 하고 우리만 할 수 있는 말을 더하지 못하므로, 자체 페이지는 아직 없습니다. Muse: Meta Muse는 설정 화면이 아니라 채팅 메시지 한 통으로 설정하므로, 가이드는 여기서 생성하지 않고 hermoso.ai/muse에 직접 작성했습니다.

모든 채널, 어디에서든

클라이언트를 바꿔도 닿을 수 있는 범위는 바뀌지 않습니다. 어디에서든 Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram, Google Business Profile에 게시하고 예약할 수 있습니다. 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의 Responsible Builder Policy는 앱이 Data 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 탭의 터미널 & API 키에서 만듭니다.

MCP 엔드포인트 URL은 무엇인가요?

https://app.hermoso.ai/mcp이며, /.well-known/mcp.json의 서버 카드에 스트리머블 HTTP 원격으로 선언되어 있습니다. npm 패키지 이름은 hermoso이고, 공식 MCP 레지스트리에서는 io.github.hermoso-ai/hermoso입니다.