Configurar o Hermes Agent: instalar e conectar Instagram, LinkedIn e X em 15 minutos

O Hermes Agent precisa de um comando para instalar e mais um para conectar a PlugKit: hermes mcp add plugkit --url https://api.plugkit.co/mcp --auth header. Seu agente então lista suas contas, publica no Instagram, LinkedIn, X, TikTok, YouTube, Facebook, WhatsApp e Telegram, lê a caixa de entrada e responde. Todos os comandos abaixo rodaram no meu Mac em 4 de setembro de 2026, com saída real incluída.

O que é o Hermes Agent (e por que ele precisa de um plug)

O Hermes Agent é o agente open source da Nous Research (licença MIT). Diferente de uma janela de chat, ele roda sempre ligado: um processo gateway que você acessa pelo WhatsApp, Telegram, Discord ou Slack, cron jobs, skills que ele mesmo escreve e melhora, memória entre sessões e um cliente MCP nativo. De fábrica, ele consegue navegar, rodar código e ler arquivos. Não consegue publicar no Instagram, porque Instagram, LinkedIn, X e TikTok têm cada um uma API diferente, um fluxo de OAuth diferente e uma revisão de app diferente.

É essa lacuna que um servidor MCP preenche. O PlugKit expõe suas contas sociais conectadas como ferramentas MCP em Streamable HTTP puro, então o Hermes ganha publicação, caixa de entrada, comentários, analytics e automações de comentário para DM sem você encostar em nenhuma API de plataforma.

Passo 1: instale o Hermes Agent

No macOS ou Linux (WSL2 também funciona):

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
hermes setup

O hermes setup é o assistente: ele escolhe seu provedor de modelo (eu rodo no gpt-5.5 pelo login do OpenAI Codex, Claude e modelos locais também funcionam), define o diretório de trabalho que o agente pode enxergar e configura os canais de mensagem. Confira a instalação:

hermes --version
# Hermes Agent v0.16.0 (2026.6.5) · upstream 85852b71

Se o banner disser que você está atrás do upstream, o hermes update te deixa em dia. O Hermes lança versões novas várias vezes por semana.

Duas configurações que vale ajustar de cara em ~/.hermes/config.yaml:

• terminal.cwd: a pasta em que o agente trabalha. O padrão resolve de forma estranha em alguns Macs; defina explicitamente.
• security.redact_secrets: true: caso contrário, chaves de API podem aparecer na íntegra nos logs de sessão. A minha estava desligada; descobri pelo aviso na inicialização.

Passo 2: pegue uma chave de API do PlugKit e conecte suas contas

Crie uma conta na PlugKit ($49 por mês para 5 contas conectadas, cancele quando quiser), conecte suas contas sociais pelo painel com os botões normais de OAuth e crie uma chave de API. Instagram, Facebook, WhatsApp, TikTok, Telegram, YouTube, X e LinkedIn são suportados; a documentação do MCP lista os recursos atuais por plataforma.

A chave se parece com sk_…. Nunca cole ela em um chat com o agente: fica no histórico para sempre. O próximo passo guarda ela do jeito certo.

Passo 3: adicione o PlugKit como servidor MCP no Hermes

hermes mcp add plugkit --url https://api.plugkit.co/mcp --auth header

O Hermes faz duas perguntas:

Does this server require authentication? [Y/n]: Y
API key / Bearer token: sk_…
✓ Saved to ~/.hermes/.env as MCP_PLUGKIT_API_KEY

Connecting to 'plugkit'...
✓ Connected! Found 85 tool(s) from 'plugkit':
  whoami            Entry point: returns the authenticated identity, the profiles...
  list_profiles     List profiles (workspaces grouping social accounts)...
  list_accounts     List connected social accounts, filterable by profile, platform...
  create_post       Create a post and publish it to several accounts at once...
  list_conversations, send_message, reply_to_comment, get_analytics_summary,
  create_comment_automation ...

Esta execução foi registrada com o Hermes Agent v0.16.0 e mostrou 85 ferramentas. Desde então, o servidor continuou ganhando novas ferramentas e hoje oferece mais de 100, então a sua contagem vai ser maior.

O que aconteceu no disco: a chave foi para ~/.hermes/.env como MCP_PLUGKIT_API_KEY, e o ~/.hermes/config.yaml ganhou este bloco, referenciando a variável em vez da chave crua:

mcp_servers:
  plugkit:
    url: https://api.plugkit.co/mcp
    headers:
      Authorization: Bearer ${MCP_PLUGKIT_API_KEY}
    enabled: true

Você pode escrever esse bloco na mão, se preferir; o hermes mcp add só faz isso por você e testa a conexão.

Passo 4: teste a conexão

hermes mcp test plugkit

Testing 'plugkit'...
Transport: HTTP → https://api.plugkit.co/mcp
  Authorization: Bear***7444
✓ Connected (2529ms)
✓ Tools discovered: 85

E o hermes mcp list mostra o servidor como habilitado com todas as ferramentas. Dentro de uma sessão, as ferramentas levam o nome do servidor como prefixo: mcp__plugkit__whoami, mcp__plugkit__list_accounts, mcp__plugkit__create_post, mcp__plugkit__send_message e assim por diante. É a forma com sublinhado duplo que o Hermes usa desde a v0.19.0; a v0.16.0, a versão do teste acima, ainda as chamava de mcp_plugkit_whoami. Elas são injetadas em todos os canais do Hermes (CLI, WhatsApp, Telegram, cron), sem configuração extra.

Veja o que whoami e list_accounts retornaram na minha conta, resumido:

profiles: Antoine Blanco (6 accounts, 54 posts), Antoine Blanco Business (1 account)

platform   account                    
facebook   Antoine.Blanco
linkedin   Antoine Blanco
youtube    @antoineblancobusiness
youtube    @antoineblanco99
tiktok     Antoine Blanco
x          @AntoineBlanco99
instagram  @antoineblanco99

Sete contas, um plug. Pergunte ao Hermes "quais contas PlugKit eu tenho?" e essa tabela é a resposta.

A peculiaridade da inicialização que parece uma falha

Se você testar com um comando de uma tacada só, tipo hermes chat -q "list my PlugKit accounts", a primeira resposta pode dizer que as ferramentas não estão disponíveis. Não é a conexão. O Hermes descobre servidores MCP em uma thread em segundo plano e só espera 0,75 segundo por ela antes do primeiro turno (hermes_cli/mcp_startup.py, wait_for_mcp_discovery(timeout=0.75) na v0.16.0). O handshake da PlugKit leva cerca de 2,5 segundos, então a primeira mensagem passa na frente da lista de ferramentas.

Três jeitos de contornar isso:

• Fale com o gateway sempre ativo (WhatsApp, Telegram, Discord). Ele conectou na inicialização, as ferramentas estão lá.
• Em um hermes chat interativo, mande qualquer mensagem primeiro e depois seu pedido de verdade.
• Para scripts e cron jobs, use hermes cron ou uma sessão com dois turnos em vez de um único -q.

Perdi vinte minutos nisso antes de ler o código-fonte. Agora você perde um minuto.

O que pedir ao Hermes depois que ele estiver plugado

Somente leitura, seguro para testar primeiro:

• "Quais contas PlugKit eu tenho, e qual perfil é o padrão?"
• "Me mostre meus últimos 10 posts do Instagram com alcance e curtidas."
• "Liste as DMs do Instagram sem resposta das últimas 24 horas."
• "Quais são os meus melhores horários para publicar no LinkedIn?"

Depois vem o trabalho de verdade:

• "Publique este texto no Instagram, LinkedIn e X amanhã às 9h, com a mesma mídia." Um create_post, três destinos.
• "Responda a todos os comentários do meu último Reel que perguntam sobre preço com o link da bio." Isso é get_comments mais reply_to_comment.
• "Crie uma automação de comentário para DM no Instagram: palavra-chave PLUG, envie o link do guia como botão." Isso é create_comment_automation; a DM é enviada com um botão porque a Meta bloqueia URLs cruas no corpo das mensagens.
• "Toda segunda-feira às 8h, me mande um relatório do alcance da semana passada por conta." Cron do Hermes mais get_analytics_summary.

Suba o Hermes com o escopo OAuth mcp:read se você quiser uma semana só de leitura antes de deixá-lo escrever; o caminho da chave de API dá acesso total, então defina trust: untrusted no servidor do PlugKit em config.yaml, o que faz cada ferramenta de escrita esperar a sua aprovação, e teste as escritas em uma conta secundária. approvals.mode só cobre comandos de shell perigosos, não as ferramentas MCP.

Hermes Agent, OpenClaw ou um script simples?

Se você já roda o OpenClaw, a PlugKit se conecta da mesma forma (ela fala MCP padrão sobre HTTP). O Hermes é quem vem ganhando espaço em 2026: gateway sempre ligado, cron, skills que se aprimoram sozinhas e um cliente MCP nativo que não precisa de ponte. Um script simples chamando a API REST da PlugKit continua sendo a resposta certa quando você quer publicação determinística sem modelo no meio do caminho; o agente serve para a metade conversacional, respostas, triagem, decisões.

Para a comparação completa, leia Hermes Agent vs OpenClaw para redes sociais. Para a mecânica por trás do servidor MCP, como dar acesso às redes sociais a um agente de IA.

Perguntas frequentes

O Hermes Agent suporta servidores MCP?

Sim. O Hermes tem um cliente MCP nativo desde o começo de 2026: os servidores ficam em mcp_servers no ~/.hermes/config.yaml (stdio ou HTTP), as ferramentas são descobertas na inicialização e registradas como mcp__<server>__<tool> em todos os canais. hermes mcp add, hermes mcp test e hermes mcp list gerenciam tudo pelo terminal.

O Hermes Agent consegue publicar no Instagram?

Sozinho, não. O Instagram exige a Graph API com uma conta business ou de criador e uma revisão de app. Pelo servidor MCP da PlugKit, o Hermes ganha create_post, publish_post, get_comments, reply_to_comment e as ferramentas de caixa de entrada na sua conta conectada do Instagram, então ele consegue publicar, ler e responder.

Onde o Hermes guarda a chave de API do PlugKit?

Em ~/.hermes/.env, como MCP_PLUGKIT_API_KEY. O config.yaml referencia a variável no header Authorization em vez de guardar a chave. Ative security.redact_secrets para que as chaves nunca caiam nos logs de sessão.

Por que o Hermes diz que as ferramentas do PlugKit estão indisponíveis na primeira mensagem?

Porque a descoberta MCP roda em segundo plano e o primeiro turno espera só 0,75 segundo por ela, enquanto o handshake do PlugKit leva cerca de 2,5 segundos. Envie uma segunda mensagem, ou use o gateway, que conectou na inicialização.

Quanto custa isso?

O Hermes Agent é gratuito e open source; você paga o seu provedor de modelo. O PlugKit custa US$ 49 por mês para 5 contas conectadas ou US$ 97 para 30, com todas as ferramentas incluídas, cancele quando quiser. As chamadas à API do X são o único repasse, cobradas pela tarifa do próprio X.

AB

Antoine BlancoFundador da PlugKit. Gerencia as próprias contas de Instagram, YouTube e X pela API e pelo servidor MCP descritos aqui.