Cómo conectar Claude, ChatGPT, Claude Code o Cursor a Hermes para que revisen tu agente y lo ayuden a mejorar, y cómo usar tu propia clave de Anthropic en la Salud del agente.
MCP es una forma estándar de darle a un asistente de IA (Claude, ChatGPT, Claude Code, Cursor…) acceso controlado a Hermes. Cuando conectas uno, ese asistente puede ver tus productos, tu conocimiento y la salud de tu agente, hablarle a tu agente como si fuera un cliente de prueba y proponer mejoras en su borrador, sin que tengas que copiar y pegar nada.
¿Qué es una conexión MCP?
Es una autorización que le das a una aplicación (por ejemplo, tu Claude) para entrar a tu organización en Hermes con ciertos permisos. Tú decides cuál conectar y puedes revocarla cuando quieras. El asistente corre en tu cuenta y con tu suscripción: Hermes solo le entrega herramientas.
Hay dos caminos para revisar y mejorar a tu agente con IA, y los dos se manejan en la misma pantalla: Configuración → Conexiones (MCP).
| Camino | Qué es | Cuándo conviene |
|---|---|---|
| Conexión MCP | Conectas tu propio asistente. Él hace de cliente de prueba y de revisor. | Quieres que tu Claude o tu ChatGPT revise a tu agente. Está disponible en todos los planes. |
| API key de Anthropic | Pegas tu clave y la Salud del agente del panel funciona con ella. | Quieres usar los escenarios y el diagnóstico del panel sin que tu plan incluya Salud del agente. |
En ¿Qué vas a conectar? elige tu asistente: Claude, Claude Code, ChatGPT, Cursor u Otro conector. Hermes rellena el Nombre y las URLs de redirección por ti, y debajo puede mostrar una nota con un detalle propio de ese asistente. Si eliges Otro conector, escribe tú el nombre y las URLs (una por línea; deben empezar con https:// o ser de tu propio computador, como http://localhost:puerto).
Pulsa Crear conexión. Aparece la ventana Conexión creada con el client_id, el client_secret y un Prompt para tu asistente de IA.
El secreto se muestra una sola vez
Copia el client_secret antes de pulsar Listo. Hermes solo guarda su huella, así que no se puede recuperar después. Si lo pierdes, crea una conexión nueva y revoca la anterior. No lo compartas ni lo pegues en lugares públicos.
Configura tu asistente con esos datos y la URL del servidor MCP que muestra la ventana (termina en /api/mcp):
claude mcp add --transport http hermes <URL del servidor> y, en tu archivo .claude.json, fija "callbackPort": 8765 dentro de "oauth". Sin eso, Claude Code usa un puerto distinto cada vez y la conexión falla.~/.cursor/mcp.json con la URL.Si usas Claude Code o Cursor, también puedes pegar el prompt de la ventana en su chat: el asistente configura la conexión por ti.
Cuando tu asistente abra el navegador, entra a Hermes y revisa la pantalla Conectar «tu asistente»: te dice a qué organización entra y qué permisos pide. Pulsa Autorizar. Este paso siempre lo hace una persona.
Sabrás que terminaste cuando…
En la tabla de Conexiones MCP ves tu conexión con la etiqueta Activa, y tu asistente puede listar tus productos o leer la salud de tu agente.
Al autorizar, el asistente pide uno o dos permisos:
Con eso, el asistente dispone de estas herramientas:
| Para qué | Herramientas | Quién puede usarlas |
|---|---|---|
| Ver tu negocio | listar_productos, obtener_producto, listar_plantillas, buscar_conocimiento, obtener_configuracion | Cualquier rol del equipo |
| Revisar la salud del agente | salud_embudo, salud_conversaciones_estancadas, leer_conversacion, leer_documento_agente, leer_equipo, leer_reglas_calificacion, leer_fallos, listar_escenarios | Administradores y editores |
| Mejorar el borrador | editar_seccion_borrador | Administradores y editores |
| Probar y guardar escenarios | probar_agente, guardar_escenario, borrar_escenario | Solo administradores |
Además hay una guía lista, el prompt revisar_salud_agente, que le enseña al asistente el flujo completo: mirar dónde se traban las conversaciones, leer las estancadas, probar a tu agente como cliente, corregir una sección del borrador y volver a probar.
Lo que el asistente no puede hacer: publicar el documento del agente, escribir en una conversación real ni enviar mensajes por WhatsApp. El borrador que deja lo revisas y lo publicas tú desde el panel. Los permisos del asistente dependen de tu rol, que Hermes revisa en cada llamada: si te cambian de rol o de organización, la conexión se ajusta sola.
Cada vez que el asistente prueba a tu agente se gasta un turno de prueba del cupo diario. Si tu plan no incluye Salud del agente, las pruebas usan un modelo más económico y lo avisan en el resultado, y cuando el cupo del día se agota el asistente te lo dice.
En la tabla ves el nombre, el identificador, cuándo se creó y su estado:
Para cortar un acceso pulsa el icono de la papelera de la fila y confirma Revocar conexión: el asistente pierde el acceso de inmediato. Revoca las conexiones que ya no uses.
La tarjeta API key de Anthropic (arriba en la misma pantalla, solo la ves si eres administrador) activa la Salud del agente del panel en cualquier plan: tus escenarios de prueba, el juez y el diagnóstico corren con tu clave y Anthropic te cobra ese uso a tu cuenta. Se usa solo para eso, nunca para las respuestas a tus clientes.
sk-ant-api).•••• y sus últimos 4 caracteres) con Reemplazar y Borrar.Solo sirve una API key
Un token de suscripción de Claude Pro o Max no funciona: Anthropic no permite usarlo en integraciones y Hermes lo rechaza. Si Anthropic rechaza tu clave, la tarjeta avisa «Anthropic rechazó tu API key; reemplázala».
No. Está disponible en todos los planes, siempre que tu suscripción esté activa. Lo que depende del plan es la Salud del agente del panel; con tu propia API key de Anthropic también la tienes.
Solo si es administrador o editor y usa las herramientas de Salud del agente, que leen las conversaciones estancadas para entender qué falló. No puede escribir en ellas.
No. Integraciones trae productos de tu tienda a Hermes (Integraciones). MCP deja que un asistente tuyo entre a Hermes para revisar y mejorar a tu agente.
En la sección de Salud del agente del Agente IA.
Integraciones
Cómo conectar tu tienda (Shopify, WooCommerce) o tu cuenta de Dropi para que Hermes traiga tus productos, precios y stock solo y los mantenga al día.
Analítica
Cómo leer los números de tu asistente (mensajes, calientes, tiempos de respuesta, acciones de la IA) y cómo enseñarle lo que no supo responder.