Freshdesk MCP server

Servidor MCP de Freshdesk

Una implementación de servidor MCP que se integra con Freshdesk, lo que permite que los modelos de IA interactúen con los módulos de Freshdesk y realicen diversas operaciones de soporte.

Características

• Integración con Freshdesk : interacción fluida con los puntos finales de la API de Freshdesk
• Soporte de modelos de IA : permite que los modelos de IA realicen operaciones de soporte a través de Freshdesk
• Gestión automatizada de tickets : gestione la creación, las actualizaciones y las respuestas de tickets

Componentes

Herramientas

El servidor ofrece varias herramientas para las operaciones de Freshdesk:

• create_ticket : Crea nuevos tickets de soporte
  • Entradas :
    • subject (cadena, obligatorio): Asunto del ticket
    • description (cadena, obligatoria): Descripción del ticket
    • source (número, obligatorio): Código fuente del ticket
    • priority (número, requerido): Nivel de prioridad del ticket
    • status (número, requerido): Código de estado del ticket
    • email (cadena, opcional): correo electrónico del solicitante
    • requester_id (número, opcional): ID del solicitante
    • custom_fields (objeto, opcional): campos personalizados para configurar en el ticket
• update_ticket : Actualizar tickets existentes
  • Entradas :
    • ticket_id (número, obligatorio): ID del ticket a actualizar
    • updates (objeto, requerido): Campos a actualizar
• delete_ticket : Eliminar un ticket
  • Entradas :
    • ticket_id (número, obligatorio): ID del ticket a eliminar
• search_tickets : Busca entradas según criterios
  • Entradas :
    • query (cadena, obligatoria): cadena de consulta de búsqueda
• get_ticket_fields : Obtener todos los campos del ticket
  • Entradas :
    • Ninguno
• get_tickets : Obtener todas las entradas
  • Entradas :
    • page (número, opcional): Número de página a buscar
    • per_page (número, opcional): Número de tickets por página
• get_ticket : Consigue un billete individual
  • Entradas :
    • ticket_id (número, obligatorio): ID del ticket a obtener

Empezando

Instalación mediante herrería

Para instalar freshdesk_mcp para Claude Desktop automáticamente a través de Smithery :

Prerrequisitos

• Una cuenta Freshdesk (regístrese en freshdesk.com )
• Clave API de Freshdesk
• uvx instalado ( pip install uv o brew install uv )

Configuración

1. Genere su clave API de Freshdesk desde el panel de administración de Freshdesk
2. Configura tu dominio y detalles de autenticación

Uso con Claude Desktop

1. Instale Claude Desktop si aún no lo ha hecho
2. Agregue la siguiente configuración a su claude_desktop_config.json :

Notas importantes :

• Reemplace YOUR_FRESHDESK_API_KEY con su clave API de Freshdesk real
• Reemplace YOUR_FRESHDESK_DOMAIN con su dominio de Freshdesk (por ejemplo, yourcompany.freshdesk.com )

Operaciones de ejemplo

Una vez configurado, puedes pedirle a Claude que realice operaciones como:

• Cree un nuevo ticket con el asunto "Problema de pago del cliente A101" y la descripción "Contactando con el cliente A101 por un problema de pago ocurrido el mes pasado", donde el correo electrónico del cliente sea a101@acme.com y establezca la prioridad en alta.
• "Actualizar el estado del ticket n.° 12345 a 'Resuelto'"
• "Enumere todos los tickets de alta prioridad asignados al agente John Doe"
• Lista de tickets anteriores del cliente A101 en los últimos 30 días

Pruebas

Para fines de prueba, puede iniciar el servidor manualmente:

Solución de problemas

• Verifique que su clave API y dominio de Freshdesk sean correctos
• Asegúrese de que haya una conectividad de red adecuada con los servidores de Freshdesk
• Consultar los límites de velocidad y cuotas de la API
• Verifique que el comando uvx esté disponible en su PATH

Licencia

Este servidor MCP está licenciado bajo la licencia MIT. Consulte el archivo de licencia en el repositorio del proyecto para obtener más información.