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

Hermes Agent se instala con un comando y se conecta a PlugKit con uno más: hermes mcp add plugkit --url https://api.plugkit.co/mcp --auth header. Tu agente ya puede listar tus cuentas, publicar en Instagram, LinkedIn, X, TikTok, YouTube, Facebook, WhatsApp y Telegram, leer la bandeja de entrada y responder. Todos los comandos de abajo se ejecutaron en mi Mac el 4 de septiembre de 2026, con su salida real incluida.

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, tareas cron, habilidades que él mismo escribe y mejora, memoria entre sesiones y un cliente MCP nativo. De serie sabe navegar, ejecutar código y leer archivos. Lo que no puede es publicar en Instagram, porque Instagram, LinkedIn, X y TikTok traen 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: elige tu proveedor de modelo (yo lo uso con gpt-5.5 a través del login de OpenAI Codex, también funcionan Claude y los modelos locales), 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 aviso dice que vas por detrás del repositorio, hermes update te pone al día. Hermes saca versiones nuevas varias veces por semana.

Dos ajustes que conviene arreglar 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; ponlo de forma explícita.
• security.redact_secrets: true: si no, las claves de API pueden aparecer tal cual en los registros de sesión. La mía estaba desactivada; me enteré por el aviso de arranque.

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

Crea una cuenta de PlugKit ($49 al mes por 5 cuentas conectadas, cancelas cuando quieras), conecta tus redes desde el panel con los botones OAuth de siempre y crea una clave de API. Instagram, Facebook, WhatsApp, TikTok, Telegram, YouTube, X y LinkedIn están soportados; la documentación de MCP lista las capacidades actuales de cada plataforma.

La clave tiene la forma sk_…. No la pegues nunca en un chat con el agente: se queda en el historial para siempre. El paso siguiente 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 ...

Esta ejecución se capturó con Hermes Agent v0.16.0 y mostró 85 herramientas. Desde entonces el servidor no ha dejado de sumar herramientas y hoy expone más de 100, así que a ti te saldrán más.

Lo que pasó en el disco: la clave fue 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 claro:

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 simplemente 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 activado con todas sus 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. Es la forma con doble guion bajo que usa Hermes desde la v0.19.0; la v0.16.0, la versión de la prueba de arriba, todavía las llamaba mcp_plugkit_whoami. Se inyectan en todos los canales de Hermes (CLI, WhatsApp, Telegram, cron), sin configuración adicional.

Esto es lo que devolvieron whoami y list_accounts 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 tiro tipo 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 lo 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 interactivo, manda primero cualquier mensaje y luego tu petición de verdad.
• Para scripts y tareas cron, usa hermes cron o una sesión con dos turnos en vez 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 9h, con el mismo material." Un solo create_post, tres destinos.
• "Responde con el enlace de la bio a todos los comentarios de mi último Reel que pregunten por el precio." 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 URLs sueltas en el cuerpo de los mensajes.
• "Cada lunes a las 8h, 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 OAuth mcp:read si quieres una semana de solo lectura antes de dejarle escribir; la vía de la clave de API da acceso completo, así que pon trust: untrusted en el servidor de PlugKit en config.yaml, con lo que cada herramienta de escritura espera tu aprobación, y prueba las escrituras en una cuenta secundaria. approvals.mode solo cubre los comandos de shell peligrosos, no las herramientas MCP.

¿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 encendido, cron, habilidades que se mejoran solas y un cliente MCP nativo que no necesita puente. Un script normal que llame a la API REST de PlugKit sigue siendo la respuesta correcta cuando quieres publicar de forma determinista sin un modelo de por medio; el agente es para la mitad conversacional, las respuestas, el triaje, las decisiones.

Para la comparativa completa, lee Hermes Agent frente a OpenClaw para redes sociales. Para el funcionamiento interno del servidor MCP, cómo dar a un agente de IA acceso a las redes sociales.

Preguntas frecuentes

¿Hermes Agent admite servidores MCP?

Sí. Hermes tiene cliente MCP nativo desde principios de 2026: los servidores van bajo 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 las 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 app. A través del servidor MCP de PlugKit, Hermes recibe create_post, publish_post, get_comments, reply_to_comment y las herramientas de bandeja de entrada sobre tu cuenta de Instagram conectada, así que puede 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 la cabecera Authorization en lugar de guardar la clave. Activa security.redact_secrets para que las claves nunca acaben en los registros 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 49 $ 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í.