Configurar Hermes Agent: instalarlo y conectarlo a Instagram, LinkedIn y X en 15 minutos

Hermes Agent necesita un comando para instalarse y otro más para conseguir 85 herramientas de redes sociales: hermes mcp add plugkit --url https://api.plugkit.co/mcp --auth header. A partir de ahí tu agente puede listar tus cuentas, publicar en Instagram, LinkedIn, X, TikTok, YouTube, Facebook, WhatsApp y Telegram, leer la bandeja de entrada y responder. Esta es la secuencia exacta que ejecuté en mi propio Mac el 4 de septiembre de 2026, con la salida real, incluida la rareza del arranque que hace pensar que la conexión ha fallado.

Qué es Hermes Agent (y por qué necesita un enchufe)

Hermes Agent es el agente open source de Nous Research (licencia MIT). A diferencia de una ventana de chat, funciona siempre encendido: un proceso gateway al que llegas desde WhatsApp, Telegram, Discord o Slack, cron jobs, skills que él mismo escribe y mejora, memoria entre sesiones y un cliente MCP nativo. De serie sabe navegar, ejecutar código y leer archivos. No puede publicar en Instagram, porque Instagram, LinkedIn, X y TikTok tienen cada uno una API distinta, un flujo OAuth distinto y una revisión de app distinta.

Ese es el hueco que llena un servidor MCP. PlugKit expone tus cuentas sociales conectadas como herramientas MCP sobre Streamable HTTP sin más, así que Hermes consigue publicación, bandeja de entrada, comentarios, analítica y automatizaciones de comentario a DM sin que toques ni una sola API de plataforma.

Paso 1: instalar Hermes Agent

En macOS o Linux (WSL2 también vale):

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

hermes setup es el asistente de configuración: elige tu proveedor de modelo (yo lo ejecuto con gpt-5.5 mediante el login de OpenAI Codex; Claude y los modelos locales también funcionan), fija el directorio de trabajo que el agente puede ver y configura los canales de mensajería. Comprueba la instalación:

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

Si el banner dice que vas por detrás de upstream, hermes update te pone al día. Hermes saca versiones nuevas varias veces por semana.

Dos ajustes que conviene corregir de entrada en ~/.hermes/config.yaml:

• terminal.cwd: la carpeta en la que trabaja el agente. El valor por defecto se resuelve de forma rara en algunos Mac; defínelo de forma explícita.
• security.redact_secrets: true: si no, las claves de API pueden aparecer tal cual en los logs de sesión. La mía estaba desactivada; me enteré por el aviso del arranque.

Paso 2: consigue una clave de API de PlugKit y conecta tus cuentas

Crea una PlugKit cuenta (29 $ al mes por 5 cuentas conectadas, cancela cuando quieras), conecta tus cuentas sociales desde el panel con los botones de OAuth de siempre y crea una clave de API. Instagram, Facebook, WhatsApp, TikTok, Telegram, YouTube, X y LinkedIn son compatibles; el documentación de MCP listan las capacidades actuales de cada plataforma.

La clave se parece a sk_…. No la pegues nunca en un chat con el agente: se queda en el historial para siempre. El siguiente paso la guarda como toca.

Paso 3: añade PlugKit como servidor MCP en Hermes

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

Hermes hace dos preguntas:

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 ...

Lo que pasó en el disco: la clave fue a parar a ~/.hermes/.env como MCP_PLUGKIT_API_KEY, y ~/.hermes/config.yaml ganó este bloque, que referencia la variable en lugar de la clave en bruto:

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

Puedes escribir ese bloque a mano si lo prefieres; hermes mcp add lo hace por ti y prueba la conexión.

Paso 4: probar la conexión

hermes mcp test plugkit

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

Y hermes mcp list muestra el servidor como habilitado y con todas las herramientas. Dentro de una sesión, las herramientas llevan el nombre del servidor como prefijo: mcp_plugkit_whoami, mcp_plugkit_list_accounts, mcp_plugkit_create_post, mcp_plugkit_send_message, etc. Se inyectan en todos los canales de Hermes (CLI, WhatsApp, Telegram, cron), sin configuración extra.

Esto es lo que whoami y list_accounts devuelto en mi cuenta, recortado:

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

Siete cuentas, un solo plug. Pregúntale a Hermes "¿qué cuentas tengo en PlugKit?" y esa tabla es la respuesta.

La rareza del arranque que parece un fallo

Si pruebas con un comando de un solo disparo como hermes chat -q "list my PlugKit accounts", puede que la primera respuesta diga que las herramientas no están disponibles. No es la conexión. Hermes descubre los servidores MCP en un hilo en segundo plano y solo espera 0,75 segundos antes del primer turno (hermes_cli/mcp_startup.py, wait_for_mcp_discovery(timeout=0.75) en la v0.16.0). El handshake de PlugKit tarda unos 2,5 segundos, así que el primer mensaje se adelanta a la lista de herramientas.

Tres formas de solucionarlo:

• Habla con el gateway siempre activo (WhatsApp, Telegram, Discord). Se conectó al arrancar, las herramientas están ahí.
• En un hermes chat, manda cualquier mensaje primero y luego tu petición real.
• Para scripts y tareas cron, usa hermes cron o una sesión con dos turnos en lugar de un solo -q.

Perdí veinte minutos con esto antes de leer el código fuente. Tú ahora tienes el minuto.

Qué pedirle a Hermes una vez enchufado

Solo lectura, seguro para probar primero:

• "¿Qué cuentas tengo en PlugKit, y cuál es el perfil por defecto?"
• "Muéstrame mis últimas 10 publicaciones de Instagram con alcance y likes."
• "Lista los DM de Instagram sin responder de las últimas 24 horas."
• "¿Cuáles son mis mejores horas para publicar en LinkedIn?"

Y luego el trabajo de verdad:

• "Publica este texto en Instagram, LinkedIn y X mañana a las 9am, con el mismo archivo." Un solo create_post, tres destinos.
• "Responde a cada comentario de mi último Reel que pregunte por el precio con el enlace de la bio." Eso es get_comments más reply_to_comment.
• "Crea una automatización de comentario a DM en Instagram: palabra clave PLUG, envía el enlace de la guía como botón." Eso es create_comment_automation; el DM se envía con un botón porque Meta bloquea las URL sueltas en el cuerpo de los mensajes.
• "Todos los lunes a las 8am, mándame un informe del alcance de la semana pasada por cuenta." El cron de Hermes más get_analytics_summary.

Arranca Hermes con el scope de OAuth mcp:read si quieres una semana de solo lectura antes de dejarlo escribir; la vía de la API key da acceso completo, así que mantén approvals.mode: smart del lado de Hermes y prueba las escrituras en una cuenta secundaria.

¿Hermes Agent, OpenClaw o un script normal y corriente?

Si ya usas OpenClaw, PlugKit se conecta igual (habla MCP estándar sobre HTTP). Hermes es el que está ganando terreno en 2026: gateway siempre activo, cron, skills que se mejoran solas y un cliente MCP nativo que no necesita ningún puente. Un script normal que llame a la API REST de PlugKit sigue siendo la respuesta correcta cuando quieres publicaciones deterministas sin ningún modelo de por medio; el agente está para la mitad conversacional: respuestas, triaje, decisiones.

Para la comparativa completa, lee Hermes Agent vs OpenClaw para redes sociales. Para ver la mecánica que hay detrás del servidor MCP, cómo darle a un agente de IA acceso a redes sociales.

Preguntas frecuentes

¿Hermes Agent admite servidores MCP?

Sí. Hermes tiene un cliente MCP nativo desde principios de 2026: los servidores van en mcp_servers en ~/.hermes/config.yaml (stdio o HTTP), las herramientas se descubren al arrancar y se registran como mcp_<server>_<tool> en todos los canales. hermes mcp add, hermes mcp test y hermes mcp list los gestionan desde la terminal.

¿Hermes Agent puede publicar en Instagram?

Por sí solo no. Instagram exige la Graph API con una cuenta de empresa o de creador y una revisión de la app. A través del servidor MCP de PlugKit, Hermes consigue create_post, publish_post, get_comments, reply_to_comment y las herramientas de bandeja de entrada en tu cuenta de Instagram conectada, para que pueda publicar, leer y responder.

¿Dónde guarda Hermes la API key de PlugKit?

En ~/.hermes/.env como MCP_PLUGKIT_API_KEY. config.yaml referencia la variable en el Authorization en vez de guardar la clave. Activa security.redact_secrets para que las claves nunca acaben en los logs de sesión.

¿Por qué Hermes dice que las herramientas de PlugKit no están disponibles en el primer mensaje?

Porque el descubrimiento MCP corre en segundo plano y el primer turno solo lo espera 0,75 segundos, mientras que el handshake de PlugKit tarda unos 2,5 segundos. Manda un segundo mensaje, o usa el gateway, que se conectó al arrancar.

¿Cuánto cuesta esto?

Hermes Agent es gratuito y de código abierto; pagas a tu proveedor de modelos. PlugKit cuesta 29 $ al mes por 5 cuentas conectadas o 97 $ por 30, con todas las herramientas incluidas y cancelación cuando quieras. Las llamadas a la API de X son lo único que se repercute, facturado a la tarifa de X.

AB

Antoine BlancoFundador de PlugKit. Gestiona sus propias cuentas de Instagram, YouTube y X a través de la API y del servidor MCP que se describen aquí.