Hermes Agent para Freshdesk: cómo conectarlo de forma segura (2026)

Por qué miré Hermes en Freshdesk

Mi trabajo diario en eesel es construir integraciones, y la API de Freshdesk es una en la que he pasado suficiente tiempo como para tener opiniones sobre sus límites de tasa. eesel lleva años ejecutando IA en colas de soporte reales, y la misma lección vuelve una y otra vez: el modelo es la parte fácil. Lo difícil es decidir qué puede tocar la IA y saber que está lista antes de que un cliente sea el primero en descubrir que no lo está.

Hermes Agent es el agente de código abierto y autoalojado de Nous Research, con 251.479 estrellas en GitHub bajo licencia MIT. La pregunta general ya la trabajé en Hermes Agent for customer support. Lo que estás leyendo es la versión para Freshdesk, y necesitaba su propia entrada porque Freshdesk cambió la respuesta el mes pasado.

Conviene decir desde el principio que Hermes no trae nada específico de Freshdesk. Su catálogo seleccionado de 68 servidores MCP no tiene entrada de Freshdesk, y cuando busqué en Hacker News, Reddit y X, nadie describía tampoco una configuración de Hermes con Freshdesk. Así que todo lo que sigue lo armé a partir de la documentación de los dos proveedores, que es más o menos como tendrías que construirlo tú mismo de todas formas.

Qué cambió: Freshdesk ya tiene su propio servidor MCP

Hasta hace poco, si querías un agente externo en Freshdesk, era código de la comunidad o un envoltorio que escribías tú alrededor de la API v2 de Freshdesk. Ahora Freshdesk ejecuta un servidor propio. Según su artículo sobre MCP, "Starting September 10, 2026, the Freshworks MCP integration is generally available."

Los datos principales, todos procedentes de las FAQ de MCP de Freshdesk y de ese mismo artículo:

• Planes: Growth, Pro y Enterprise, solo en las versiones 2021 Standalone u Omni 2026. Las cuentas heredadas no son compatibles.
• Endpoint: https://<subdomain>.freshdesk.com/mcp. Los dominios personalizados no funcionan.
• Autenticación: solo clave de API, y las llamadas siguen los permisos del rol de ese usuario.
• Herramientas: 37, que cubren tickets, conversaciones, contactos, agentes, grupos, empresas y artículos del centro de ayuda. Sin herramientas de borrado ni de fusión.
• Activado por defecto. Un administrador puede desactivarlo en Admin Settings > Apps & Integrations > MCP.

También se mide por uso, y eso es nuevo en Freshdesk. La partida aparece en cada tarjeta de plan:

Freshdesk documenta Claude Code, Claude Desktop, Cursor, Copilot Studio y VS Code como clientes, y añade que funciona "any AI tool that provides MCP support". Como Hermes habla MCP sobre HTTP, entra en esa categoría. Para quien ya leyó mi entrada Claude for Freshdesk, es el mismo servidor, ya fuera del acceso anticipado y disponible en planes más baratos.

Cuatro formas de conectar Hermes a Freshdesk

Aquí están todas las vías que encontré, y quién revisó el código que acaba guardando tu clave de API:

Hoy elegiría la primera. El proveedor cuyos datos toca es quien la mantiene, y tus credenciales del helpdesk no dan un rodeo por un tercero. También cubre los artículos del centro de ayuda, algo que el servidor de effytech no hace (no tiene herramientas de artículos de soluciones). En cuanto a la vía del webhook, es menos una cuarta alternativa y más un disparador: avisa a Hermes de que llegó un ticket, y Hermes sigue necesitando una de las otras tres para leerlo o escribirlo.

Cómo configurarlo de forma segura

Este es el orden que seguiría. La mayoría de estos pasos existen solo por una frase de las FAQ de Freshdesk: "tool-level access management is not available. All supported MCP tools are available by default to any user who connects using a valid API key."

1. Dale a Hermes su propio puesto de agente

El servidor MCP actúa como el agente al que pertenece la clave de API. Si pegas tu propia clave, Hermes puede hacer todo lo que tú puedes, y cada nota que escriba parecerá escrita por ti.

Lo que yo haría es crear un agente dedicado para el bot, darle un rol estrecho y llamarlo algo como "Hermes (draft only)". En Freshdesk eso significa un puesto de pago, desde 19 $/agente/mes en Growth con facturación anual. De todo lo de esta configuración, es la medida de seguridad más barata, ya que los permisos de rol son el único límite que Freshdesk aplica en el lado del servidor.

2. Añade el servidor y filtra sus herramientas

Hermes guarda los servidores MCP en mcp_servers dentro de ~/.hermes/config.yaml y resuelve los marcadores ${VAR} desde ~/.hermes/.env. También permite crear una lista blanca de herramientas por servidor (documentación MCP de Hermes). Si juntas eso con el endpoint y la cabecera de autenticación de Freshdesk, obtienes la configuración de abajo, que es mi propia combinación de las dos documentaciones y no un ejemplo oficial:

mcp_servers:
  freshdesk:
    url: "https://yourcompany.freshdesk.com/mcp"
    headers:
      Authorization: "${FRESHDESK_API_KEY}"
    tools:
      include:
        - fetchTicket
        - fetchTicketConversations
        - fetchSearchTickets
        - fetchSolutionArticle
        - createTicketNote

Una vez definido include, la documentación de Hermes dice: "Only those MCP server tools are registered." Así que esa lista corta acaba haciendo el trabajo que los permisos de Freshdesk no pueden hacer.

Hermes también tiene un ajuste trust por servidor. En un servidor untrusted, "every write-capable tool call... requires user approval through the standard approval surface before it runs" (referencia de configuración MCP). El valor por defecto es full. Si ejecutas Hermes desde un chat de Slack o Telegram con una persona mirando, cambiar a untrusted te da una segunda comprobación en cada nota.

3. Escribe notas privadas, nunca respuestas

Freshdesk mantiene ambas cosas separadas a nivel de API. Una nota que añades mediante /notes es privada por defecto, y "Private notes are for collaboration between agents and are not visible to the customer." El endpoint de actualización, en cambio, dice "Only public & private notes can be edited" (API de Freshdesk). Una vez enviada una respuesta, queda enviada.

El flujo es así: Hermes redacta en una nota privada, un agente la revisa y ese agente envía la respuesta con su propio nombre. Las respuestas borrador con IA de Freshdesk funcionan con la misma forma, y también cualquier herramienta de agent assist. Mi regla es mantenerlo ahí hasta que los fallos se vuelvan aburridos.

4. Elige un disparador: chat, cron o webhook

Hermes tiene que saber cuándo mirar un ticket, y hay tres opciones:

• Bajo petición. Un agente pega un número de ticket en Slack y pide un borrador a Hermes. Es la más sencilla, y una persona sigue en el circuito todo el tiempo.
• Consulta por cron. El planificador de Hermes late cada 60 segundos, y un script de comprobación previa puede imprimir {"wakeAgent": false} para que "cron skips the agent run entirely" cuando nada ha cambiado (documentación de cron). Bueno para "cada 5 minutos, redactar notas en los tickets nuevos de este grupo".
• Webhook. Una regla de automatización de Freshdesk al crear un ticket dispara "Trigger webhook" a una ruta de Hermes como http://your-server:8644/webhooks/freshdesk.

De las tres, los webhooks son los más cercanos al tiempo real y también los más delicados. Hermes exige un secreto en cada ruta y rechaza cualquier petición sin "a recognized signature header" (documentación de webhooks). La regla de Freshdesk puede añadir cabeceras personalizadas, pero no encontré ninguna opción para firmar el cuerpo, así que antes de depender de ello, prueba cuál de los esquemas que acepta Hermes puede satisfacer realmente tu regla. Si falla, Freshdesk reintenta cada 30 minutos, 48 veces, y los webhooks tienen un tope de 1.000 llamadas por hora (ayuda de Freshdesk).

Conviene conocer un par de detalles más de los webhooks. Las ejecuciones por webhook empiezan con un conjunto de herramientas por defecto muy reducido, lo que significa que la ruta necesita una concesión manual toolsets: ["mcp-freshdesk"] antes de poder tocar ningún ticket. La documentación también advierte: "HMAC validation authenticates the sender, not the content." Como el cuerpo del ticket lo escribe un cliente, trátalo como texto no fiable, y es una razón más para que la única herramienta de escritura sea una nota privada.

5. Prueba con tickets antiguos antes de confiar

Aquí es donde dedicaría más tiempo, y también donde Hermes menos ayuda. No tiene un modo de reproducción para recorrer los tickets del mes pasado y puntuar los borradores frente a lo que tu equipo envió realmente.

Puedes construirlo tú: extrae tickets resueltos, ejecuta Hermes sobre ellos en un perfil aislado y luego compara. Hay dos trampas de Freshdesk. List Tickets "by default" solo devuelve tickets "created within the past 30 days" salvo que pases updated_since, y el endpoint de búsqueda llega a un tope de unos 300 resultados (API de Freshdesk). Además, cada lectura durante la evaluación cuenta contra tu cupo MCP, así que tiene más sentido ejecutar la evaluación por la API REST. Para saber cómo es "suficientemente bueno", mi guía sobre entrenar una IA con una base de conocimiento lo explica.

Cuánto cuesta realmente Hermes en Freshdesk

La licencia no cuesta nada. Las otras cuatro partidas de la factura sí.

Acciones MCP. "Any call to an MCP server counts as one action, regardless of whether it reads or writes data" (FAQ de MCP). El cupo se fija por cuenta y por año, y no se acumula:

Lo que exceda cuesta 15 $ por cada 1.000, según la página de precios. Los límites REST vienen de la documentación de la API y se comparten en toda la cuenta con cualquier otra integración que ejecutes.

Un borrador útil requiere más de una llamada. Hermes lee el ticket, luego el hilo, busca tickets similares y extrae un artículo de ayuda antes de escribir la nota:

Con cinco acciones por ticket, Growth cubre unos 240 borradores al año, más o menos 20 al mes. Después, sale a 7,5 centavos por ticket en acciones, lo que parece barato por ticket pero es fácil de subestimar en total. Los agentes también reintentan y exploran, así que considera cinco como el mínimo, no como la media. Puedes introducir tus propios números aquí:

Tokens del modelo. Nous Portal Plus cuesta 20 $/mes por 22 $ de crédito, Super 100 $ y Ultra 200 $. Otra opción es conectar un plan de ChatGPT compatible y usarlo para la inferencia.

El puesto del bot. Entre 19 y 89 $ al mes, según el plan que tengas.

La construcción. Esta es la que la gente suele saltarse. Un comprador de Freshdesk en las llamadas de ventas de eesel, una empresa de seguridad del correo que avanza hacia 20.000 tickets al año, pasó por 200 interacciones en un solo día de pruebas, y lo primero que preguntó fue cómo sería eso con 9.000 al mes. Con IA medida por uso, el volumen se convierte en la primera pregunta de un responsable de soporte, y Hermes te hace medir tres cosas a la vez: tokens y acciones MCP, y encima horas de ingeniería. Para esto último, mi desglose build vs buy pone cifras.

Dónde deja de funcionar Hermes en Freshdesk

Todo lo anterior asume el esquema de borradores. En cuanto apuntas Hermes directamente a los clientes de Freshdesk, te topas con los mismos muros que encontré en la reseña de soporte general:

• La memoria es por perfil, no por solicitante. La memoria integrada es MEMORY.md (2.200 caracteres) y USER.md (1.375), cargadas en cada sesión que ejecuta el perfil (documentación de memoria). Lo que guarde del ticket de un cliente queda en el prompt del siguiente.
• Sin destino de entrega en Freshdesk. Las opciones deliver de una ejecución por webhook son plataformas de chat, correo o un registro. Para devolver la respuesta al ticket, siempre pasas por una llamada a herramienta.
• Sin ensayo. Lo traté arriba, y es la carencia a la que daría más peso.
• El bot nativo ya existe. El Freddy AI Agent de Freshdesk está en todos los planes con 500 sesiones únicas, y luego 49 $ por cada 100. Si lo que quieres es un bot de cara al cliente dentro de Freshdesk, Hermes estaría reconstruyendo algo que el helpdesk ya vende.

Hay un usuario de Hacker News que sí ejecuta un helpdesk basado en Hermes, y ese hilo resume bien el compromiso:

"We replaced our helpdesk with Hermes. It has long term memory about our business. When a customer messages us, Hermes gets all the relevant details about the customer and creates a Pi session using Gemma 4 running locally and customer talks to that agent."

theturtletalks, Hacker News

La primera respuesta preguntó si eso arriesga "one customer's data leaking to another" (dezgeg, Hacker News). Fíjate en el diseño, aun así. Hermes no es el agente con el que habla el cliente; en su lugar abre una sesión local separada por cada cliente. Es una arquitectura sensata, y también mucha arquitectura.

Hermes vs Freddy AI vs eesel en Freshdesk

Para la comparación más amplia, mi recopilación best AI for Freshdesk y la lista de Freshdesk AI alternatives profundizan más, mientras que Hermes Agent alternatives cubre el lado de los agentes generales.

¿Deberías ejecutar Hermes en tu cola de Freshdesk?

Tras leer ambas documentaciones, aquí es donde acabo.

Sí, si tienes un ingeniero al que le gusta este tipo de trabajo y la tarea es redactar notas para agentes que las revisan, siempre que tu volumen quepa en el cupo de acciones. El servidor MCP oficial con una lista include de cinco herramientas es una configuración ordenada que puedes defender, y sobre ella las funciones de cron y webhook de Hermes te dan automatización real. También encaja bien como chatbot interno de soporte que responde a tu propio equipo a partir del historial de Freshdesk.

No, si quieres que la IA responda a clientes, o necesitas un registro de cada acción de la IA que un responsable de soporte pueda leer sin SSH. Misma respuesta si nadie puede dedicarse a mantener un archivo YAML y un arnés de evaluación. Y la revisión de seguridad de Freshdesk que harías a cualquier proveedor se convierte en una que ahora haces sobre tu propio servidor.

La versión honesta es que Freshdesk acaba de convertir el cableado en la parte fácil. Lo que queda es el problema de las alucinaciones de la IA más el ensayo y las barreras de protección a su alrededor, y ese es el trabajo real de poner IA en una cola.

eesel para Freshdesk

Si el motivo por el que miraste Hermes era querer que una IA trabaje tus tickets de Freshdesk, eesel es el compañero construido exactamente para ese trabajo. Se conecta con tu subdominio de Freshdesk y una clave de API, sin app que instalar, y aprende de tu centro de ayuda y tus respuestas predefinidas, además de tus tickets resueltos (documentación de eesel).

Así encaja con las carencias de arriba:

• Primero, ensayo. Simula con tus tickets pasados de Freshdesk antes de responder a un solo cliente.
• Tú eliges el nivel de escritura. Puede dejar notas internas, retener borradores de respuesta para aprobación o enviar. También incluye etiquetar y asignar, además de fijar el estado y actualizar campos, lo que cubre también el triaje automático de Freshdesk.
• Sin medición por llamada. Un ticket cuesta 1 crédito sin importar cuántas respuestas vayan y vengan. Los planes empiezan en 299 $ por 500 créditos, y el plan gratuito incluye 100 créditos.
• Freshchat incluido. La misma conexión cubre también el chat de Freshdesk, así que no hay una segunda configuración.

Y si la mitad del atractivo de Hermes era la terminal, eesel también tiene una. La CLI de eesel maneja al mismo compañero: eesel integrations connect freshdesk enlaza la cuenta, eesel integrations download start descarga el historial de tickets y eesel automations define qué hace en cada disparador. Como los comandos imprimen JSON, un script o un agente de programación como Claude Code puede ejecutar tu configuración de Freshdesk de principio a fin. Hay más sobre eso en mi entrada CLI for customer support.

Quédate con Hermes para los trabajos en los que es excelente. Para la cola de Freshdesk, en cambio, prueba antes eesel con tus tickets reales.