Hermoso는 마케팅용 MCP 서버입니다. 하나의 OAuth 인증 엔드포인트 뒤에 922+개 도구가 있어서, 에이전트가 시장에서 이미 돌고 있는 광고를 조사하고, 완성된 이미지와 영상 광고를 만들고, 게시하고, 그 뒤의 유료 캠페인까지 구성할 수 있습니다. Claude는 하나의 연결로 이 모든 것에 접근합니다. 이 페이지는 그중 한 부분, 즉 Claude가 X에서 실제로 할 수 있는 것과 X가 허용하지 않는 것을 다룹니다.
Claude에 Hermoso 연결하기
- 익스텐션을 설치하세요.
Hermoso 공개 저장소의 최신 릴리스를 설치해요. 스킬 5개(research, ad-from-brand, generate, product-photoshoot, marketing)와gemini extensions install https://github.com/hermoso-ai/hermosoGEMINI.md컨텍스트 파일이 들어 있어요. 스킬은npx를 통해hermoso명령을 실행하므로, Gemini CLI의 도구 목록에는 아무것도 추가되지 않고 명령이 실행되기 전까지는 문맥도 쓰지 않아요.gemini extensions list에 Agent skills 아래로 표시돼요. - 한 번 로그인하세요.
브라우저에서 로그인 화면이 열리고, 자격 증명은npx -y hermoso auth login~/.hermoso/config.json에 소유자만 읽을 수 있게 저장돼요. Gemini CLI는 Hermoso가 처음 필요할 때 이 로그인을 대신 실행할 수 있어요. 그 기기에 브라우저가 없나요? MCP & CLI → 터미널 & API 키에서 키를 만들고npx -y hermoso auth login --token hmk_…를 실행하세요. - 선택 사항: MCP 서버도 추가하기.
Gemini CLI는 첫 연결이 401로 응답하면 Hermoso의 인증 서버를 찾고 스스로 등록하므로,gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcpsettings.json에 키를 넣을 필요가 없어요. 세션 안에서/mcp auth hermoso를 실행하면 로그인이 진행돼요. 스킬은 이것이 없어도 모든 도구에 닿아요. - Claude에 무언가를 요청하세요. “가장 가까운 경쟁사 세 곳의 가장 오래 달리는 광고를 찾아서, 가장 좋은 훅을 9:16 영상으로 리믹스해 줘” 또는 “이 렌더를 채널에 올려 줘”. 에이전트가 도구를 고르고, 지출은 당신이 승인합니다.
위 설치는 2026-09-23에 깨끗한 홈 디렉터리에서 Gemini CLI 0.60.0으로 실행했어요. hermoso-ai/hermoso의 최신 릴리스를 가져왔고, gemini extensions list는 스킬 5개와 컨텍스트 파일을 표시했어요. 이 익스텐션에는 자체 MCP 서버가 없는데, 이는 의도된 설계예요. 도구 목록은 모든 세션에 불러와지지만, 스킬은 실행되기 전까지 아무 비용도 들지 않아요. Hermoso는 Google과 제휴하거나 Google의 승인을 받은 곳이 아니에요.
그다음 Hermoso의 설정 → 커넥터에서 X 자체를 한 번 연결하세요. OAuth 동의 화면이므로 브라우저가 필요한 유일한 단계입니다. 그 이후의 모든 작업은 도구 호출입니다.
Claude가 X에서 쓰는 도구
post_to_x: 텍스트, 대체 텍스트가 있는 이미지나 영상, 스레드 전체, 답글, 인용 게시물, 투표를 게시하며, 답글을 달 수 있는 사람을 제한할 수도 있습니다.post_x_article: 긴 형식의 Article을 게시합니다. Markdown으로 작성하면 제목, 목록, 인용문, 링크, 코드 블록, 표가 모두 그대로 옮겨집니다.edit_x_post: 이미 게시한 게시물을 X가 허용하는 1시간 안에 다시 씁니다.schedule_post: 공유 캘린더에 대기열로 넣습니다.x_post_metrics: 게시물의 공개 지표입니다.x_post_insights: 최근 28시간에 대한 광고주 수준의 수치입니다. 노출, 링크 클릭, 프로필 방문, 영상 조회수, 영상 완료 사분위를 포함합니다.x_post_insights_historical: 같은 수치를 임의의 기간에 대해, 한 번에 최대 25개 게시물까지 조회합니다. “지난달 성과는 어땠나요”에 쓰는 도구입니다.x_mentions: 브랜드를 언급하는 사람들을 보여 줍니다.delete_x_post: 게시물을 삭제합니다.
X는 호출마다 비용이 드는 유일한 커넥터이며, 그 숫자를 숨기지 않고 공개합니다. Meta, TikTok, LinkedIn, YouTube, Threads, Drive는 요청마다 비용이 들지 않지만, X는 우리에게 과금하므로 이 호출들에는 적은 크레딧이 청구됩니다. 일반 게시물은 요청당 $0.015이고, 링크가 포함된 게시물은 $0.200으로 약 13배 비쌉니다. 삭제, 조회, 대체 텍스트 메타데이터 쓰기는 각각 별도의 가격이 있고, 인사이트는 반환된 게시물 단위로 청구됩니다. 링크 감지는 일부러 링크가 있다고 가정하는 쪽으로 기울어 있습니다. 반대로 잘못 짐작하면 우리가 13배를 부담하기 때문입니다. 실제로 의미하는 바는, X에서는 좋은 게시물 하나가 다섯 개보다 낫고, 에이전트는 게시하기 전에 가격을 먼저 확인받는다는 것입니다. 글자 수 제한은 고정 280자가 아니라 게시하는 계정에 따라 다릅니다. Hermoso는 계정의 X 구독 정보를 읽어, Premium이 허용하는 경우 최대 25,000자까지 보냅니다. 그래서 긴 게시물은 거부되지 않고 그대로 전부 나갑니다. 내용이 잘리는 일도 없습니다. 비용 측면에서도 유리합니다. 긴 게시물 하나는 X 호출 한 번으로 청구되지만, 같은 내용을 다섯 게시물로 나누면 호출이 다섯 번 청구됩니다. X Premium에서는 Hermoso가 대신 게시할 수 있는 것이 두 가지 더 열립니다. 긴 형식의 Article(Markdown으로 작성하며 제목, 목록, 인용문, 코드 블록, 표가 그대로 유지됨)과, X가 허용하는 1시간 안에 이미 게시한 게시물에 대한 수정입니다.
자동화하기 전에 알아 둘 만한 X의 제한
| 텍스트 | 글자 수는 계정에 따라 다릅니다. 일반 계정은 280자, X Premium은 최대 25,000자입니다. Hermoso가 X에서 구독 정보를 읽으므로 긴 게시물도 그대로 나갑니다. 내용이 잘리는 일은 없습니다. 이 제한은 게시물을 만들거나 예약할 때 적용되므로, 제한을 넘은 게시물은 나가는 도중 몰래 잘리는 대신 여러분이 아직 옆에 있을 때 거부됩니다. |
|---|---|
| 공개 범위 | 공개만 가능합니다. X의 게시물은 존재하는 순간부터 공개입니다. API에는 초안도 일부 공개 게시물도 없습니다. 보호된 계정은 존재하지만, 이는 계정 전체의 설정이며 Hermoso가 읽거나 제어하지 않습니다. 게시물별로 고르는 것이 아닙니다. |
| 캐러셀 | 이유와 함께 이름을 밝혀 거부합니다. “X에는 넘겨 보는 캐러셀이 없습니다.” X의 API는 게시물에 미디어를 최대 4개까지 붙이고 격자로 표시하므로, 모든 이미지가 한눈에 보이고 넘겨볼 것이 없습니다. 따라서 “1/6 · SWIPE”가 적힌 번호형 슬라이드 덱은 의도한 대로 게시할 수 없습니다. 거부 메시지는 대안을 알려 줍니다. “가장 강력한 슬라이드 하나만 X에 게시하거나, 이 게시물에서 X를 빼세요.” 독자에게 넘기라고 지시하는 덱을 격자로 게시하는 것은 게시하지 않는 것보다 나쁩니다. |
| 어느 계정 | 없음. X는 연결된 계정에 게시합니다. |
Claude에서 해 보기
일상 언어로 요청하세요. 이것은 DSL이 아니라 평범한 문장입니다:
“./notes/launch.md를 X 게시물 하나로 바꿔 줘. 들어가지 않으면 짧은 스레드로 나눠 주고, 링크는 마지막 게시물에만 넣고, 비용을 먼저 알려 줘.”
이 흐름은 get_brand → generate_text → post_to_x → x_post_insights_historical 순서로 진행돼요. Gemini CLI는 셸 명령을 실행하기 전에 물어보고, 스킬은 hermoso 명령을 통해 동작하므로, 게시는 승인하기 전에 읽을 수 있는 한 줄로 나타나요. MCP 도구에는 한 번만, 해당 도구는 항상, 또는 서버는 항상 허용 중에서 고를 수 있어요.
Claude와 X: 주의할 점
Hermoso의 MCP 서버를 Gemini CLI에 추가하면서 X에 게시하게 할 때는 --trust로 추가하지 마세요. 이 플래그는 서버의 모든 확인을 건너뛰고, X에서는 게시, 읽기, 삭제마다 요금이 청구되며, 링크가 있는 게시물은 일반 게시물보다 약 13배 비싸요. Premium 계정에서는 긴 게시물 하나가 청구 한 번이고, 다섯 부분으로 된 스레드는 청구가 다섯 번이에요.
Gemini CLI에서 두 가지 설정이 이 방식의 안전성을 정해요. gemini mcp add는 --scope user를 주지 않으면 프로젝트의 .gemini/settings.json에 기록해요. 한 저장소가 항상 한 브랜드로만 실행되어야 할 때 유용해요. 그리고 Hermoso를 --trust와 함께 추가하지 마세요. 이 옵션은 게시 직전의 확인을 포함해 서버의 모든 확인을 건너뛰어요. MCP 도구의 이름은 mcp_hermoso_와 도구 이름이 합쳐져 붙고, --exclude-tools로 특정 도구를 아예 제외할 수 있어요.
게시 전에 X 조사하기
여기에는 X 광고 라이브러리가 없습니다. 이 도구에서 X 조사는 여러분 자신의 계정에 대한 것입니다. 언급, 게시물 지표, 과거 광고주 수치입니다. 나머지 조사 기능은 그대로입니다. Meta, Google, LinkedIn 광고 라이브러리와 TikTok, Instagram, YouTube, Reddit, Threads의 유기적 콘텐츠가 여기에 해당합니다.
유료 부분
X Ads가 2026년 8월에 출시되어, 이제 X는 두 영역을 모두 갖춥니다. X Ads API는 별도의 호스트에 있는 별도의 제품이며 OAuth 1.0a 서명 방식이 따로 있어서, 다른 기능보다 늦게 들어왔습니다. Hermoso는 이제 이 API 위에 프로모션 게시물 구조 전체를 만듭니다. 캠페인, 라인 아이템(X가 부르는 광고 그룹 이름), 프로모션 트윗, 타겟팅, 예산, 상태, 보고가 모두 포함됩니다. X 광고는 게시물을 홍보하므로 크리에이티브는 게시물이며, Hermoso가 유기적으로 게시하는 것과 같은 게시물입니다. 실제 돈을 활성화하는 스위치는 나머지 11개 플랫폼과 마찬가지로 명시적 확인 없이는 실행되지 않습니다. 예산을 세우기 전에 알아 둘 점이 하나 있습니다. X는 앱 단위가 아니라 광고 계정 단위로 Ads API 접근 권한을 부여하므로 이를 위한 OAuth 버튼이 없습니다. business.x.com → Account access에서 Hermoso의 X 사용자를 광고 계정에 추가하면, 그것이 list_x_ads_accounts에 나타나고 X가 부여한 권한 수준이 함께 표시됩니다.
Gemini CLI 혼자서는 할 수 없는 일
예산이 있는 에이전트는 영향 범위가 제한되어 있을 때만 쓸모가 있으므로, 울타리는 프롬프트가 아니라 서버에 둡니다. 모든 광고 캠페인, 광고 세트, 광고 그룹, 광고는 일시 중지 상태로 만들어지며, 실제 돈이 움직이는 상태 변경은 명시적인 확인 표시 없이는 실행되지 않습니다. 모든 렌더는 먼저 견적을 받습니다(hermoso_capabilities가 비용이 쓰이기 전에 모델별 정확한 크레딧 비용을 공개합니다). 크레딧은 첫 제공자 호출 전에 예약되고 이후 정확한 비용으로 정산되므로, 전송이 실패하면 환불되며 아무것도 없이 청구되지 않습니다. 삭제도 확인이 필요하며, 에이전트가 무엇을 만들었다고 말하기 전에 모든 캠페인 구조를 광고 플랫폼에서 다시 읽어 옵니다.
일부러 헤드리스로 하지 않는 단계가 하나 있습니다: 계정 연결은 OAuth 승인 화면이므로, 채널은 브라우저에서 한 번 연결합니다. 그 이후의 모든 작업은 도구 호출입니다.
나머지 매트릭스
Gemini CLI에서 다음에 게시: Facebook · Instagram · Threads · TikTok · YouTube · LinkedIn · Pinterest · Bluesky · Telegram. 또는 Gemini CLI가 게시할 수 있는 모든 채널을 확인하세요.
다음에서 X에 게시: Claude · ChatGPT · Claude Code · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip
자주 묻는 질문
Claude로 X에 게시할 수 있나요?
네, Hermoso의 Gemini CLI 익스텐션으로 가능해요. gemini extensions install https://github.com/hermoso-ai/hermoso를 실행하세요. 그러면 hermoso 명령을 구동하는 Hermoso 스킬 5개가 추가되고, npx -y hermoso auth login으로 한 번 로그인하면 돼요. 로그인은 브라우저를 열고 자격 증명을 직접 저장하므로, 만들 키도 붙여넣을 키도 없어요. Gemini CLI 자체 도구 목록에도 Hermoso 도구를 넣고 싶다면 gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp가 호스팅 서버를 추가하며, 이 서버는 OAuth로 로그인해요. 그러면 Gemini CLI는 마케팅 도구 922개 이상을 쓸 수 있어요. X에 게시하는 도구뿐 아니라, 시장에서 이미 집행 중인 광고를 리서치하고 크리에이티브를 처음부터 렌더링하는 도구도 포함돼요.
Claude를 X에 어떻게 연결하나요?
두 단계이고 각각 한 번씩만 하면 돼요. gemini extensions install https://github.com/hermoso-ai/hermoso를 실행하세요. 그러면 hermoso 명령을 구동하는 Hermoso 스킬 5개가 추가되고, npx -y hermoso auth login으로 한 번 로그인하세요. 로그인은 브라우저를 열고 자격 증명을 직접 저장하므로, 만들 키도 붙여넣을 키도 없어요. Gemini CLI 자체 도구 목록에도 Hermoso 도구를 넣고 싶다면 gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp가 호스팅 서버를 추가하며, 이 서버는 OAuth로 로그인해요. 그다음 Hermoso 안의 설정 → 커넥터에서 X를 연결하세요. 브라우저에서 열리는 OAuth 동의 화면이에요. 그 뒤로 Gemini CLI는 X 게시를 일반 도구 호출처럼 처리해요.
ChatGPT로 X에 비공개로 또는 초안으로 게시할 수 있나요?
아니요. X의 게시물은 존재하는 순간부터 공개입니다. API에는 초안도 일부 공개 게시물도 없습니다. Hermoso는 X가 지킬 수 없는 공개 범위를 요청받는 순간 거부하며, 더 약한 설정으로 몰래 게시하지 않습니다.
ChatGPT가 게시하기 전에 X를 조사할 수 있나요?
광고 라이브러리를 통해서는 안 됩니다. X는 광고 라이브러리를 공개하지 않기 때문입니다. Hermoso가 X에서 읽는 것은 여러분 계정의 데이터입니다. 게시물 지표, 기간을 지정한 광고주 수준 인사이트, 그리고 브랜드 언급입니다.
ChatGPT로 게시할 때 X의 글자 수 제한은 얼마인가요?
계정에 따라 다르며, Hermoso는 추측하지 않고 확인합니다. 일반 X 계정은 280자로 제한되고, X Premium 계정은 최대 25,000자입니다. Hermoso가 X에서 구독 정보를 읽어 게시하므로 긴 게시물도 전부 나가며, 내용이 잘리는 일은 없습니다. Premium 계정에서는 긴 게시물 하나가 보통 스레드보다 읽기 좋고 비용도 적습니다. 다섯 부분이면 다섯 번 청구되지만, 긴 게시물은 X 호출 한 번으로 청구되기 때문입니다. Premium은 Markdown으로 쓰는 긴 형식의 Article과, X가 허용하는 1시간 안에 이미 게시한 게시물의 수정도 열어 줍니다. Hermoso는 게시물을 만들거나 예약할 때 이 제한을 적용하므로, ChatGPT는 나중에 아무도 지켜보지 않을 때 실패하는 대신 즉시 알림을 받습니다.
ChatGPT에서 게시뿐 아니라 X 광고도 운영할 수 있나요?
네, 2026년 8월부터 가능합니다. X Ads는 별도의 호스트에서 자체 OAuth 1.0a 서명으로 동작하며, Hermoso가 그 위에 전체 구조를 만듭니다. 캠페인, 라인 아이템, 프로모션 트윗, 타겟팅, 예산, 상태, 보고가 포함됩니다. X는 앱 단위가 아니라 광고 계정 단위로 Ads API 접근 권한을 부여하므로 이를 위한 OAuth 버튼은 없습니다. business.x.com → Account access에서 Hermoso의 X 사용자를 광고 계정에 추가하세요.