AI Agents desde Claude (MCP)
MelonHelp Agents expone un servidor MCP (Model Context Protocol). Conéctalo a claude.ai y puedes configurar tus agentes hablando con Claude: cargar conocimiento, revisar y corregir skills, conectar tus APIs, crear flujos, ver el consumo de tokens y leer por qué el agente respondió lo que respondió. Este conector lee y escribe; el conector de Tickets es de solo lectura.
Qué puedes hacer desde Claude
- "Revisa mis skills y unifica las duplicadas."
- "Conecta la API de clientes en esta URL con el header X-Api-Key y vincúlala al agente de soporte."
- "Crea un flujo: cuando un cliente dice que no tiene internet, pídele el documento, búscalo en la API y, si tiene facturas vencidas, mándale el link de pago."
- "¿Por qué escaló el agente el ticket 5943?"
- "¿Cuánto gastamos en tokens esta semana y cuáles fueron las conversaciones más caras?"
Conectarlo
- En Agents → Ajustes, activa la tarjeta Conector MCP. Ahí está la URL del servidor.
- En claude.ai, ve a Settings → Connectors → Add custom connector y pégala.
- Autoriza con tu cuenta de MelonHelp (OAuth 2.1). El acceso queda atado a tu usuario y a un workspace.
- Las herramientas aparecen solas en tus conversaciones con Claude.
Las herramientas disponibles
Conocimiento
| Tool | Qué hace |
|---|
generate_faqs | Redacta respuestas para una lista de preguntas a partir del conocimiento ya cargado (para revisar antes de guardar). |
add_faqs | Guarda pares de pregunta y respuesta en la base de conocimiento. |
add_website | Agrega un sitio web como fuente y lo rastrea. |
add_text | Agrega un documento de texto como fuente. |
Skills
| Tool | Qué hace |
|---|
list_skills | Todas las skills con su contenido completo, estado y la skill más parecida (para detectar duplicados). |
get_skill | Una skill por id. |
create_skill | Crea una skill (como borrador). |
update_skill | Edita cualquier campo, incluido el mensaje de escalado y la aprobación. |
Agentes
| Tool | Qué hace |
|---|
list_agents | Los agentes del workspace. |
get_agent | La configuración completa de un agente, con sus skills y flujos vinculados. |
update_agent | Cambia instrucciones, tono, política y mensaje de fallback, idioma, tope de respuestas, largo de respuesta, memoria, datasets. |
set_agent_skills | Define exactamente qué skills usa un agente. |
Acciones (tus APIs)
| Tool | Qué hace |
|---|
list_tools | Las herramientas HTTP y MCP del workspace, sin secretos. |
create_http_tool | Crea una herramienta HTTP: URL con marcadores, método, headers (cifrados en reposo), parámetros y qué campos de la respuesta conservar. |
update_tool | Edita una herramienta. |
delete_tool | Elimina una herramienta. |
set_agent_tools | Define exactamente qué herramientas puede llamar un agente. |
Los valores de los headers, como las API keys, se cifran y ninguna herramienta los devuelve ni se los muestra al modelo.
Flujos
| Tool | Qué hace |
|---|
get_flow_format | La referencia del formato de definición de un flujo (tipos de nodo, salidas, condiciones, filtros de plantilla). |
list_flows | Los flujos del workspace con estado y versión. |
get_flow | Un flujo con su definición completa. |
create_flow | Crea un flujo como borrador. Una definición inválida se rechaza con la lista de errores. |
update_flow | Edita un flujo (la definición completa se vuelve a validar). |
simulate_flow | Corre un flujo sobre una lista de mensajes de ejemplo del cliente, con respuestas de API simuladas si quieres, y devuelve la respuesta de cada turno y los nodos que recorrió. |
publish_flow | Publica (valida y sube la versión) o despublica. |
delete_flow | Elimina un flujo. |
set_agent_flows | Define exactamente qué flujos usa un agente. |
En Flujos está explicado cómo funcionan.
Consumo
| Tool | Qué hace |
|---|
get_usage | Tokens, llamadas al modelo y costo estimado de un período, desglosado por modelo, con las conversaciones más caras. |
get_conversation_usage | El desglose de tokens de una conversación. |
Diagnóstico
| Tool | Qué hace |
|---|
list_conversations | Conversaciones recientes con estado, canal y cliente. |
get_conversation | Los mensajes de una conversación con el razonamiento de la IA por respuesta: nivel, skill cargada, flujo y nodos, llamadas a herramientas y sus resultados, motivo de escalado. También el estado del flujo activo. |
Seguridad
- La autorización es por usuario y por workspace (OAuth 2.1). Claude solo puede tocar el workspace que autorizaste.
- Puedes desactivar el conector en cualquier momento desde la tarjeta de Ajustes; los tokens existentes dejan de funcionar al instante.
- Los secretos (API keys en los headers de las herramientas) se guardan cifrados y nunca se exponen por el conector.
Problemas comunes
- Claude no ve las herramientas nuevas. Desconecta y vuelve a conectar el conector en claude.ai: la lista de herramientas se trae al conectar.
- Una herramienta responde "workspace no autorizado". El conector está desactivado en Ajustes, o se revocó tu membresía en el workspace.
