Use o Hermoso em qualquer cliente MCP

O servidor do Hermoso é um servidor Model Context Protocol simples, então "qual cliente?" é, sobretudo, uma questão de sintaxe de configuração e não de capacidade. Há dois jeitos de entrar, e os dois chegam às mesmas 922+ ferramentas.

Os dois transportes

• Hospedado, HTTP em streaming: https://app.hermoso.ai/mcp. É o que a maioria dos clientes quer. Ele oferece OAuth com registro dinâmico de cliente e PKCE, então um cliente que fala o fluxo completo de autorização não precisa de chave nenhuma; um cliente que não fala pode enviar um cabeçalho Authorization: Bearer hmk_… no lugar. Observe que é somente HTTP em streaming. Não existe endpoint HTTP+SSE legado, então um cliente que fala apenas o transporte antigo não tem onde se conectar aqui.
• stdio, via npm: npx -y hermoso mcp, com a sua chave em HERMOSO_TOKEN. Qualquer cliente MCP via stdio pode carregá-lo. O mesmo pacote também é uma CLI (npm install -g hermoso), que é o caminho barato em tokens para agentes de terminal: eles rodam um comando por vez no shell, em vez de carregar um manifesto de mais de 922 ferramentas em cada turno.

Agentes podem descobrir automaticamente o cartão do servidor em /.well-known/mcp.json, e ele está listado no registro oficial do MCP como io.github.hermoso-ai/hermoso.

O bloco de configuração genérico

A maioria dos clientes aceita alguma grafia deste bloco:

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

Crie a chave no Hermoso em MCP & CLI → Terminal & chaves de API. Um cliente é uma exceção de verdade: o Codex lê TOML, não JSON, então um bloco mcpServers copiado não carrega ali. Veja a página do Codex para as quatro linhas que ele espera.

Clientes com página própria

• Claude: conecta com OAuth, nada para colar.
• ChatGPT: conecta com OAuth, nada para colar.
• Claude Code: entra pelo terminal com hermoso auth login, nada para colar; é um agente de terminal, então a CLI é o caminho mais barato para execuções longas.
• Cursor: entra pelo terminal com hermoso auth login, nada para colar.
• Codex: entra pelo terminal com hermoso auth login, nada para colar; é um agente de terminal, então a CLI é o caminho mais barato para execuções longas.
• Cline: aceita uma chave de API em um cabeçalho Authorization.
• OpenClaw: entra pelo terminal com hermoso auth login, nada para colar; é um agente de terminal, então a CLI é o caminho mais barato para execuções longas.
• Grok Bot: adiciona o modelo Hermoso Marketing Bot e aceita uma chave de API no chat, ou entra pelo terminal do próprio Bot.
• Hermes: entra pelo terminal com hermoso auth login, nada para colar; é um agente de terminal, então a CLI é o caminho mais barato para execuções longas.
• Gemini CLI: entra pelo terminal com hermoso auth login, nada para colar; é um agente de terminal, então a CLI é o caminho mais barato para execuções longas.
• Perplexity: conecta com OAuth, nada para colar.
• Le Chat: conecta com OAuth, nada para colar.
• Claude Cowork: conecta com OAuth, nada para colar.
• Perplexity Computer: conecta com OAuth, nada para colar.
• Paperclip: conecta com OAuth, nada para colar.
• Gemini: conecta com OAuth, nada para colar.
• Grok Build: entra pelo terminal com hermoso auth login, nada para colar; é um agente de terminal, então a CLI é o caminho mais barato para execuções longas.
• Kimi Code: adiciona a URL hospedada ao mcp.json e entra com /mcp-config login, nada para colar; é um agente de terminal, então a CLI é o caminho mais barato para execuções longas.
• DeepSeek Harness: entra pelo terminal com hermoso auth login e roda o Hermoso como servidor local, nada para colar.
• Manus: aceita uma chave de API em um cabeçalho Authorization.
• Muse, configurado por uma única mensagem de chat que conecta com OAuth, nada para colar.

Quatro clientes deliberadamente não têm página própria, e vale dizer por quê, em vez de sugerir um suporte maior do que o que testamos. VS Code: o Hermoso publica um deeplink de um clique para o VS Code, mas não há bloco de instalação do VS Code em lugar nenhum do produto e não há caminho testado, então não existe página afirmando um. O deeplink instala o endpoint puro e deixa a autenticação para o OAuth do próprio VS Code. Claude Desktop: o Claude Desktop usa o mesmo fluxo de Conectores do claude.ai, então é coberto pela página do Claude e não é duplicado. Grok: o chat do Grok conecta hoje pelo cartão de configuração em /mcp; não tem página própria ainda, porque o texto específico do canal duplicaria as páginas do ChatGPT em vez de acrescentar algo que só nós podemos dizer. Muse: o Meta Muse é configurado por uma mensagem de chat, e não por uma tela de configurações, então o seu guia é escrito à mão em hermoso.ai/muse e não gerado aqui.

Todos os canais, a partir de qualquer um deles

O cliente não muda o que é alcançável. De qualquer um deles: publique e agende no Facebook, no Instagram, no Threads, no TikTok, no YouTube, no X, no LinkedIn, no Pinterest, no Bluesky, no Telegram e no Google Business Profile; pesquise nas bibliotecas de anúncios da Meta, do Google e do LinkedIn, além de TikTok, Instagram, YouTube, Reddit e Threads orgânicos; renderize anúncios finais de imagem e vídeo em mais de 100 modelos; e monte campanhas na Meta, no Google Ads, no Microsoft Advertising, no Reddit Ads, no LinkedIn, no Pinterest, no X Ads, no TikTok Ads, no Snapchat Ads, no ChatGPT Ads, no Apple Search Ads e no AppLovin Ads.

Uma superfície de publicação está construída e retida, esperando a plataforma: o Reddit. A publicação orgânica e as estatísticas de post estão prontas, mas a Política de Construtor Responsável do Reddit exige aprovação escrita explícita antes que um app use a API de Dados, e esse pedido ainda não foi concedido. O conector fica retido em vez de ser oferecido como uma tela OAuth que leva a uma API morta. O Reddit Ads é outra conexão, e está ativo: a árvore completa de campanhas, previsões, busca de segmentação, pixels e formulários de lead.

O que nenhum cliente consegue fazer sozinho

Um agente com orçamento só é útil se o raio de ação for limitado, então a trava está no servidor e não em um prompt. Toda campanha, conjunto de anúncios, grupo de anúncios e anúncio é criado pausado, e as mudanças de status que ativam dinheiro real recusam rodar sem uma flag de confirmação explícita. Toda renderização tem preço antes (hermoso_capabilities publica o custo exato em créditos de cada modelo antes de qualquer gasto). Os créditos são reservados antes da primeira chamada ao provedor e acertados no custo exato depois, então um envio que falha é reembolsado em vez de deixar você cobrado por nada. Exclusões também exigem confirmação, e toda árvore de campanha é relida da plataforma de anúncios antes de o seu agente dizer o que construiu.

Um passo é deliberadamente seu: conectar cada conta, uma vez. A maioria dos canais conecta pela tela de consentimento OAuth da própria plataforma, em um navegador; o Bluesky aceita uma senha de app e o Telegram um token de bot, colados no Hermoso. Depois disso, tudo é uma chamada de ferramenta.

Perguntas frequentes

O Hermoso funciona com qualquer cliente MCP?

Via stdio, sim. Qualquer cliente que consiga iniciar npx -y hermoso mcp recebe todas as 922+ ferramentas. Pelo endpoint hospedado, é apenas HTTP em streaming: não há rota HTTP+SSE legada, então um cliente que fala somente o transporte antigo não tem onde se conectar.

Preciso de chave de API, ou o OAuth funciona?

Os dois caminhos existem. O endpoint hospedado oferece OAuth com registro dinâmico de cliente e PKCE, e é assim que os conectores de Claude, ChatGPT, Perplexity, Le Chat, Claude Cowork, Perplexity Computer, Paperclip e Gemini entram, sem nada colado. Clientes que iniciam um processo local entram uma vez com hermoso auth login, e um cliente que não faz nenhum dos dois envia uma chave de API (hmk_…) em um cabeçalho Authorization: Bearer, criada na aba MCP & CLI, em Terminal & chaves de API.

Qual é a URL do endpoint MCP?

https://app.hermoso.ai/mcp, declarada como um remoto de HTTP em streaming no cartão do servidor em /.well-known/mcp.json. O pacote é hermoso no npm e io.github.hermoso-ai/hermoso no registro oficial do MCP.