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

O Hermes Agent leva um comando para instalar e mais um para ter 85 ferramentas de redes sociais: hermes mcp add plugkit --url https://api.plugkit.co/mcp --auth header. Depois disso o seu agente consegue listar suas contas, publicar no Instagram, LinkedIn, X, TikTok, YouTube, Facebook, WhatsApp e Telegram, ler a caixa de entrada e responder. Essa é exatamente a sequência que rodei no meu próprio Mac em 4 de setembro de 2026, com a saída real, incluindo a peculiaridade de inicialização que faz as pessoas acharem que a conexão falhou.

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

Hermes Agent é o agente open source da Nous Research (licença MIT). Diferente de uma janela de chat, ele roda sempre ligado: um processo de 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 postar no Instagram, porque Instagram, LinkedIn, X e TikTok têm cada um uma API diferente, um fluxo 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

hermes setup é o assistente de configuração: 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 tem permissão de ver e configura os canais de mensagem. Verifique 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, hermes update coloca você em dia. O Hermes lança versões novas várias vezes por semana.

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

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

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

Crie uma PlugKit conta (US$ 29 por mês para 5 contas conectadas, cancele quando quiser), conecte suas contas sociais pelo dashboard com os botões de OAuth de sempre e crie uma chave de API. Instagram, Facebook, WhatsApp, TikTok, Telegram, YouTube, X e LinkedIn são suportados; o documentação MCP listam as capacidades atuais de cada plataforma.

A chave parece com sk_…. Nunca cole essa chave num chat com o agente: ela 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 ...

O que aconteceu no disco: a chave foi para ~/.hermes/.env como MCP_PLUGKIT_API_KEY, e ~/.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; hermes mcp add 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 hermes mcp list mostra o servidor como habilitado com todas as ferramentas. Dentro de uma sessão, as ferramentas vêm prefixadas com o nome do servidor: mcp_plugkit_whoami, mcp_plugkit_list_accounts, mcp_plugkit_create_post, mcp_plugkit_send_message, e assim por diante. Elas são injetadas em todos os canais do Hermes (CLI, WhatsApp, Telegram, cron), sem configuração adicional.

Veja o que whoami e list_accounts retornado 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ó, como 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 numa 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 do PlugKit leva cerca de 2,5 segundos, então a primeira mensagem sai 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á.
• Num hermes chat, envie qualquer mensagem primeiro, depois o 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, enviar 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 manda um relatório do alcance da semana passada por conta." Cron do Hermes mais get_analytics_summary.

Inicie o Hermes com o escopo OAuth mcp:read se você quiser uma semana de somente leitura antes de deixar ele escrever; o caminho da chave de API dá acesso total, então mantenha approvals.mode: smart do lado do Hermes e teste as escritas numa conta secundária.

Hermes Agent, OpenClaw ou um script simples?

Se você já roda o OpenClaw, o PlugKit conecta do mesmo jeito (ele fala MCP padrão sobre HTTP). O Hermes é quem vem ganhando terreno em 2026: gateway sempre ativo, cron, skills que se aprimoram sozinhas e um cliente MCP nativo que dispensa bridge. Um script simples chamando a API REST do 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 os detalhes 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 em ~/.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 elas 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 do PlugKit, o Hermes ganha create_post, publish_post, get_comments, reply_to_comment e as ferramentas de caixa de entrada na sua conta do Instagram conectada, para que ele consiga publicar, ler e responder.

Onde o Hermes guarda a chave de API do PlugKit?

Em ~/.hermes/.env como MCP_PLUGKIT_API_KEY. config.yaml referencia a variável no Authorization em vez de guardar a chave. Ative security.redact_secrets para que as chaves nunca apareçam 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$ 29 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.