Skip to main content
O Hermes Agent é o agente de código aberto da Nous Research. Adicione o PostClean como um servidor MCP HTTP remoto e você passa a agendar, publicar e gerenciar posts das suas redes sociais pelo CLI do Hermes, pelo app Desktop ou por qualquer gateway de mensagens que já esteja rodando nessa instalação. Esta página trata do Hermes como cliente MCP: você aponta o Hermes para o PostClean. Ela não cobre o hermes mcp serve, que expõe o próprio Hermes para outros agentes.
O PostClean não está no catálogo de MCP aprovado pela Nous. hermes mcp sem argumentos (ou hermes mcp picker / hermes mcp install) só lista os itens do catálogo. Não procure um card do PostClean. Adicione um servidor HTTP personalizado com auth: oauth.

​
Pré-requisitos

  • Hermes Agent instalado (CLI e/ou Desktop). A instalação padrão já inclui MCP. Se algum comando disser que faltam os extras de MCP:
  • Uma conta ativa no PostClean

​
URL do servidor

Use exatamente esta URL. Não coloque barra no final. Não cole uma URL de autorização OAuth. Não use /api.
Deixe o transporte no padrão do Hermes (Streamable HTTP). Não defina transport: sse.

​
Configuração

O Hermes guarda os servidores em ~/.hermes/config.yaml, em mcp_servers. Para um servidor OAuth hospedado, ele usa url + auth: oauth e conclui o fluxo no navegador na primeira conexão ou com hermes mcp login. Escolha um jeito de adicionar o servidor. Não rode login depois de um add que deu certo: o hermes mcp login força uma nova autenticação, apaga o token salvo em disco e começa o fluxo no navegador de novo.
1

Adicione o servidor MCP do PostClean

Pelo CLI. O hermes mcp add grava o servidor e já conecta (essa conexão é o primeiro OAuth). Dê tempo para o teste de conexão esperar o login no navegador:
O --auth só aceita oauth ou header. Use oauth.
  1. Entre no PostClean, escolha o Workspace que essa conexão pode usar e clique em Autorizar (para usar outro workspace, conecte de novo e escolha-o)
  2. Quando aparecer Enable all N tools? [Y/n/select], responda Y. n cancela e não salva o servidor. select grava uma lista tools.include e esconde todo o resto (inclusive publicar e excluir)
Se a conexão falhar, o Hermes pode perguntar Save config anyway? e guardar o item com enabled: false. Mude para enabled: true no config.yaml e rode o login abaixo.YAML e depois login. É a mesma configuração que o Hermes documenta para servidores HTTP com OAuth. Escreva o bloco da seção Configuração manual, mais abaixo. Se o Hermes já estiver rodando, não espere o recarregamento automático da sessão: ele só espera 30 segundos, pouco tempo para o OAuth. Em um terminal novo:
O login espera até cinco minutos. Use esse mesmo comando depois para se autenticar de novo.Desktop. Abra o link Add to Hermes, confirme a janela e rode o login se o app ainda não tiver concluído o OAuth.
2

Conclua o login no navegador

Na primeira conexão, o Hermes mostra uma URL de autorização, abre o navegador quando consegue e fica esperando um callback de loopback. Você não cola chave de API, Client ID nem Client Secret: o PostClean usa Dynamic Client Registration.Quando dá certo, ele grava ~/.hermes/mcp-tokens/postclean.json (modo 0o600). As sessões seguintes reaproveitam esse arquivo e renovam o token. Uma nova autorização só acontece quando a renovação falha, ou quando você roda login.Se o navegador não conseguir acessar http://127.0.0.1:<porta>/callback (SSH, VPS, gateway sem interface), veja Hermes remoto e sem interface.
3

Recarregue e confira

O hermes mcp list deve mostrar postclean. O hermes mcp test postclean deve conectar e listar as tools.Se uma sessão já estiver aberta, rode /reload-mcp. Depois use o prompt que o Hermes documenta para essa verificação:
As tools do PostClean devem aparecer. Depois:
O Hermes registra cada tool como mcp__<servidor>__<tool> (referência de configuração). Hífens viram sublinhados, então list-posts-tool vira mcp__postclean__list_posts_tool. Você não precisa digitar esse nome: peça em linguagem natural. Se o Hermes responder sem usar as tools, diga para ele usar o servidor MCP postclean.Veja a referência de tools com todas as tools e o fluxo recomendado (escolher o canal e o tipo de conteúdo, criar com mídia, pré-visualizar, publicar).

​
Autenticação

O MCP do PostClean aceita somente OAuth: um login no navegador com o escopo mcp:use. No Hermes, isso é auth: oauth. O Hermes cuida de descoberta, Dynamic Client Registration, PKCE, troca de token e renovação. Os Personal Access Tokens criados em Configurações → API Keys funcionam na API REST, não em /mcp/trypost.
Não passe --auth header e não coloque Authorization: Bearer … em headers. Uma chave de API colada ali retorna 403 MCP OAuth authorization required.
Não adicione oauth.client_id / oauth.client_secret. Esses campos são para servidores que recusam DCR (o Hermes documenta Google Drive e Atlassian desse jeito). O PostClean não é um deles. Depois, você gerencia os assistentes conectados em Configurações → MCP do workspace no PostClean. Para entrar de novo no Hermes (isso apaga o token guardado e repete o fluxo no navegador):
O hermes mcp reauth postclean faz o mesmo para um servidor. O hermes mcp reauth --all passa por todos os servidores com auth: oauth, um de cada vez.

​
O que você pode fazer

Com o servidor autorizado, o Hermes consegue: Algumas dessas ações dependem das suas permissões no workspace (aprovar exige publicação direta; horários de postagem, webhooks e chaves de API exigem administrador). Veja as permissões na introdução. O Pinterest precisa de um board_id, o Discord de um channel_id e o TikTok de um privacy_level antes de publicar. Peça ao Hermes para listar os boards ou canais primeiro. Detalhes e os nomes originais das tools (use esses em tools.include / tools.exclude, e não os nomes convertidos mcp__…): referência de tools. As mesmas tools ficam disponíveis no hermes chat, no Hermes Desktop e em qualquer gateway de mensagens dessa instalação (Telegram, Discord, Slack e os demais).

​
Configuração manual

Configuração equivalente à que o hermes mcp add grava, no formato HTTP com OAuth:
Salve em ~/.hermes/config.yaml e rode hermes mcp login postclean em um terminal novo. Não adicione headers, transport nem oauth.client_id. Para esconder o servidor sem apagar o bloco, defina enabled: false. Para removê-lo:
Para mudar quais tools o Hermes enxerga depois de um login que deu certo:

​
Hermes Desktop

O Desktop usa o mesmo ~/.hermes/config.yaml. As configurações do Desktop têm um painel MCP servers. Depois de adicionar e autorizar o servidor, abra esse painel ou comece uma nova conversa no Desktop para as tools carregarem. Instalação com um clique (Add to Hermes):
Abrir esse link não instala nada sozinho. O Desktop mostra o nome e a configuração completa, e você confirma. Nomes que já existem nunca são sobrescritos: você renomeia ou cancela. Depois rode hermes mcp login postclean se o app ainda não tiver concluído o OAuth.

​
Hermes remoto e sem interface

Quando o Hermes não está na mesma máquina que o seu navegador, o callback OAuth para http://127.0.0.1:<porta>/callback nunca chega ao listener. Este é o login MCP do PostClean, não o login do Hermes no provedor de modelos. Ordem de tentativa, segundo o guia OAuth over SSH e a skill mcp-oauth-remote-gateway: primeiro o painel no seu navegador, depois colar o redirecionamento ou um túnel SSH e, por último, a skill para ambientes sem interface.
Um Hermes remoto muitas vezes também roda o painel web. Adicionar ou reautenticar um servidor MCP com OAuth pelo painel, no seu navegador, evita o problema do callback de loopback. Procure a seção MCP / Connectors (o mesmo bloco mcp_servers do CLI). Se HERMES_DASHBOARD_PUBLIC_URL estiver definido no servidor, essa é a URL pública para abrir.
Num terminal interativo, o hermes mcp login postclean mostra a URL de autorização e pede que você cole o redirecionamento. Abra a URL no seu computador, escolha o workspace e clique em Autorizar. Depois copie a URL inteira da barra de endereço (a página pode mostrar um erro de conexão, e isso é esperado) e cole no prompt do Hermes. Uma string só com ?code=…&state=… também funciona. Passo a passo oficial: OAuth over SSH / Remote Hosts.
O Hermes mostra a porta que abriu (Waiting for callback on http://127.0.0.1:<porta>/callback). Em outro terminal, no seu computador:
Depois conclua a URL de autorização no navegador local, para o redirecionamento passar pelo túnel até o listener remoto. O Hermes pode trocar a porta sozinho se a preferida estiver ocupada: copie da linha Waiting for callback mais recente.
O Hermes também aceita um callback por proxy quando uma URL HTTPS pública encaminha para o listener. Fixe a porta e defina oauth.redirect_uri (guia de MCP):
Depois rode hermes mcp login postclean. Você não precisa disso num computador em que o navegador e o Hermes estão na mesma máquina.
Se você não consegue abrir o painel nem colar nada num prompt, instale a skill da Nous e deixe que ela conduza o fluxo:
Ela grava os tokens em ~/.hermes/mcp-tokens/ e depois você roda /reload-mcp. Documentação: mcp-oauth-remote-gateway.
Segundo o guia OAuth over SSH, os tokens são gravados no usuário Linux que rodou o login. Se o gateway ou a unidade do systemd roda como root ou como um usuário hermes dedicado, autentique-se como esse usuário (sudo -u hermes -i ou equivalente), para que ~/.hermes/mcp-tokens/postclean.json seja o arquivo que o agente em execução lê.

​
Comandos úteis

​
Solução de problemas

O add sem --connect-timeout usa um teste de conexão curto, pouco tempo para um login no navegador. Tente o add de novo com --connect-timeout 300, ou escreva o YAML e rode hermes mcp login postclean num terminal novo (o login espera cinco minutos). Se você editou o config.yaml dentro de uma sessão aberta, não espere o recarregamento automático: ele só espera 30 segundos. Não rode login logo depois de um add que deu certo, porque isso apaga o token que você acabou de receber.
Confirme que ~/.hermes/mcp-tokens/postclean.json existe e que enabled não está false (um mcp add que falhou pode salvar o servidor desativado). Rode hermes mcp test postclean e depois /reload-mcp ou um novo hermes chat. Pergunte quais tools MCP estão disponíveis. Se tools.include foi salvo com uma lista curta, rode hermes mcp configure postclean e ative tudo (ou apague o bloco tools). Se o /reload-mcp não mostrar nada e nenhuma tool aparecer, o recarregamento pode ter falhado em silêncio: rode hermes mcp test postclean e comece uma nova sessão.
O Hermes documenta isso quando o DCR falhou e nenhum token foi gravado em disco. Com o PostClean, o DCR deve funcionar. Confira se auth: oauth está definido, se não há headers.Authorization e se ~/.hermes/mcp-tokens/postclean.json existe depois do login. Se o arquivo não existir, rode hermes mcp login postclean de novo. Não adicione Client ID.
O Hermes se conecta a partir da máquina em que o agente roda. O endpoint do PostClean é público, então essa máquina precisa ter acesso à internet por HTTPS. Confira se a URL está exatamente como acima. Se o erro continuar, fale com o suporte.
A autorização OAuth funcionou, mas a conta do PostClean não está ativa. Abra o PostClean, ative a assinatura e rode hermes mcp login postclean de novo. Veja a introdução.
O token expirou ou foi revogado. Rode hermes mcp login postclean de novo.
A requisição usou --auth header ou um Bearer token em headers, ou um token OAuth sem mcp:use. Remova o cabeçalho, mantenha auth: oauth e entre de novo.
O install só aceita nomes do catálogo, e o PostClean não está nele. Use hermes mcp add com --url e --auth oauth.

​
Exemplos de prompts

​
Relacionados