Freshdesk

Se integra con Freshdesk para gestionar tickets de soporte, contactos y otras operaciones de servicio al cliente.

Documentación

Servidor MCP de Freshdesk

Una implementación de servidor MCP que se integra con Freshdesk, permitiendo a los modelos de IA interactuar con los módulos de Freshdesk y realizar diversas operaciones de soporte.

Características

Integración con Freshdesk: Interacción fluida con los endpoints de la API de Freshdesk
Soporte para modelos de IA: Permite a los modelos de IA realizar operaciones de soporte a través de Freshdesk
Gestión automatizada de tickets: Maneja la creación, actualización y respuestas de tickets

Componentes

Herramientas

El servidor ofrece varias herramientas para operaciones de Freshdesk:

create_ticket: Crear nuevos tickets de soporte
- Entradas:
  - subject (cadena, obligatorio): Asunto del ticket
  - description (cadena, obligatorio): Descripción del ticket
  - source (número, obligatorio): Código de fuente del ticket
  - priority (número, obligatorio): Nivel de prioridad del ticket
  - status (número, obligatorio): 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 establecer en el ticket
  - additional_fields (objeto, opcional): Campos adicionales de nivel superior
update_ticket: Actualizar tickets existentes
- Entradas:
  - ticket_id (número, obligatorio): ID del ticket a actualizar
  - ticket_fields (objeto, obligatorio): Campos a actualizar
delete_ticket: Eliminar un ticket
- Entradas:
  - ticket_id (número, obligatorio): ID del ticket a eliminar
search_tickets: Buscar tickets según criterios
- Entradas:
  - query (cadena, obligatorio): Cadena de consulta de búsqueda
get_ticket_fields: Obtener todos los campos de tickets
- Entradas:
  - Ninguna
get_tickets: Obtener todos los tickets
- Entradas:
  - page (número, opcional): Número de página a obtener
  - per_page (número, opcional): Número de tickets por página
get_ticket: Obtener un solo ticket
- Entradas:
  - ticket_id (número, obligatorio): ID del ticket a obtener
get_ticket_conversation: Obtener la conversación de un ticket
- Entradas:
  - ticket_id (número, obligatorio): ID del ticket
create_ticket_reply: Responder a un ticket
- Entradas:
  - ticket_id (número, obligatorio): ID del ticket
  - body (cadena, obligatorio): Contenido de la respuesta
  - cc_emails (matriz de cadenas, opcional): Direcciones de correo electrónico adicionales añadidas al campo 'cc' del correo saliente. Estas complementan al solicitante del ticket, que siempre permanece como destinatario principal
  - bcc_emails (matriz de cadenas, opcional): Direcciones de correo electrónico adicionales añadidas al campo 'bcc' del correo saliente. Estas complementan al solicitante del ticket, que siempre permanece como destinatario principal
  - from_email (cadena, opcional): Dirección de correo electrónico desde la que se envía la respuesta
  - user_id (número, opcional): ID del agente que añade la respuesta
create_ticket_note: Añadir una nota a un ticket
- Entradas:
  - ticket_id (número, obligatorio): ID del ticket
  - body (cadena, obligatorio): Contenido de la nota
update_ticket_conversation: Actualizar una conversación
- Entradas:
  - conversation_id (número, obligatorio): ID de la conversación
  - body (cadena, obligatorio): Contenido actualizado
view_ticket_summary: Obtener el resumen de un ticket
- Entradas:
  - ticket_id (número, obligatorio): ID del ticket
update_ticket_summary: Actualizar el resumen de un ticket
- Entradas:
  - ticket_id (número, obligatorio): ID del ticket
  - body (cadena, obligatorio): Nuevo contenido del resumen
delete_ticket_summary: Eliminar el resumen de un ticket
- Entradas:
  - ticket_id (número, obligatorio): ID del ticket
get_agents: Obtener todos los agentes
- Entradas:
  - page (número, opcional): Número de página
  - per_page (número, opcional): Número de agentes por página
view_agent: Obtener un solo agente
- Entradas:
  - agent_id (número, obligatorio): ID del agente
create_agent: Crear un nuevo agente
- Entradas:
  - agent_fields (objeto, obligatorio): Detalles del agente
update_agent: Actualizar un agente
- Entradas:
  - agent_id (número, obligatorio): ID del agente
  - agent_fields (objeto, obligatorio): Campos a actualizar
search_agents: Buscar agentes
- Entradas:
  - query (cadena, obligatorio): Consulta de búsqueda
list_contacts: Obtener todos los contactos
- Entradas:
  - page (número, opcional): Número de página
  - per_page (número, opcional): Contactos por página
get_contact: Obtener un solo contacto
- Entradas:
  - contact_id (número, obligatorio): ID del contacto
search_contacts: Buscar contactos
- Entradas:
  - query (cadena, obligatorio): Consulta de búsqueda
update_contact: Actualizar un contacto
- Entradas:
  - contact_id (número, obligatorio): ID del contacto
  - contact_fields (objeto, obligatorio): Campos a actualizar
list_companies: Obtener todas las empresas
- Entradas:
  - page (número, opcional): Número de página
  - per_page (número, opcional): Empresas por página
view_company: Obtener una sola empresa
- Entradas:
  - company_id (número, obligatorio): ID de la empresa
search_companies: Buscar empresas
- Entradas:
  - query (cadena, obligatorio): Consulta de búsqueda
find_company_by_name: Encontrar una empresa por nombre
- Entradas:
  - name (cadena, obligatorio): Nombre de la empresa
list_company_fields: Obtener todos los campos de empresas
- Entradas:
  - Ninguna

Primeros pasos

Instalación mediante Smithery

Para instalar freshdesk_mcp para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install @effytech/freshdesk_mcp --client claude

Requisitos previos

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

Configuración

Genera tu clave de API de Freshdesk desde el panel de administración de Freshdesk
Configura tu dominio y detalles de autenticación

Uso con Claude Desktop

Instala Claude Desktop si aún no lo has hecho
Añade la siguiente configuración a tu claude_desktop_config.json:

"mcpServers": {
  "freshdesk-mcp": {
    "command": "uvx",
    "args": [
        "freshdesk-mcp"
    ],
    "env": {
      "FRESHDESK_API_KEY": "<YOUR_FRESHDESK_API_KEY>",
      "FRESHDESK_DOMAIN": "<YOUR_FRESHDESK_DOMAIN>"
    }
  }
}

Notas importantes:

Reemplaza YOUR_FRESHDESK_API_KEY con tu clave de API real de Freshdesk
Reemplaza YOUR_FRESHDESK_DOMAIN con tu dominio de Freshdesk (por ejemplo, yourcompany.freshdesk.com)

Operaciones de ejemplo

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

"Crear un nuevo ticket con asunto 'Problema de pago para el cliente A101' y descripción 'Contactando por un problema de pago del último mes para el cliente A101', donde el correo del cliente es a101@acme.com y establecer prioridad alta"
"Actualizar el estado del ticket #12345 a 'Resuelto'"
"Listar todos los tickets de alta prioridad asignados al agente Juan Pérez"
"Listar los tickets anteriores del cliente A101 en los últimos 30 días"

Pruebas

Para fines de prueba, puedes iniciar el servidor manualmente:

uvx freshdesk-mcp --env FRESHDESK_API_KEY=<your_api_key> --env FRESHDESK_DOMAIN=<your_domain>

Solución de problemas

Verifica que tu clave de API y dominio de Freshdesk sean correctos
Asegura una conectividad de red adecuada a los servidores de Freshdesk
Revisa los límites de velocidad y cuotas de la API
Verifica que el comando uvx esté disponible en tu PATH

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Consulta el archivo LICENSE en el repositorio del proyecto para obtener detalles completos.