Servidor MCP de Freshservice

Descripción general

Una potente implementación de servidor MCP (Protocolo de Control de Modelos) que se integra a la perfección con Freshservice, lo que permite que los modelos de IA interactúen con los módulos de Freshservice y realicen diversas operaciones de gestión de servicios de TI. Esta integración permite a sus asistentes de IA gestionar y resolver tickets de servicio de TI, optimizando así su flujo de trabajo de soporte.

Related MCP server: Freshdesk MCP Server by CData

Características principales

• Integración de Freshservice de nivel empresarial : comunicación directa y segura con los puntos finales de la API de Freshservice

• Compatibilidad del modelo de IA : permite que Claude y otros modelos de IA ejecuten operaciones de la mesa de ayuda a través de Freshservice

• Gestión automatizada de ITSM : gestione de forma eficiente la creación de tickets, actualizaciones, respuestas y gestión de activos.

• Aceleración del flujo de trabajo : reduzca la intervención manual en tareas rutinarias de servicio de TI

Módulos de Freshservice compatibles

Este servidor MCP actualmente admite operaciones en una amplia gama de módulos de Freshservice :

• Entradas

• Conversaciones

• Productos

• Solicitantes

• Agentes

• Grupos de agentes

• Grupos de solicitantes

• Respuestas enlatadas

• Carpetas de respuestas predefinidas

• Espacios de trabajo

• Categorías de soluciones

• Carpetas de soluciones

• Artículos de solución

Componentes y herramientas

El servidor proporciona un conjunto de herramientas completo para las operaciones de Freshservice:

Gestión de tickets

Empezando

Instalación mediante herrería

Para instalar freshservice_mcp automáticamente a través de Smithery:

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

Prerrequisitos

• Una cuenta Freshservice (regístrese en freshservice.com )

• Clave API de Freshservice

• uvx instalado ( pip install uv o brew install uv )

Configuración

1. Genere su clave API de Freshservice desde el panel de administración:

   • Vaya a Configuración de perfil → Configuración de API

   • Copia tu clave API para la configuración

2. Configure su dominio y los detalles de autenticación como se muestra a continuación

Uso con Claude Desktop

1. Instalar Claude Desktop desde el sitio web oficial

2. Agregue la siguiente configuración a su claude_desktop_config.json :

"mcpServers": {
  "freshservice-mcp": {
    "command": "uvx",
    "args": [
        "freshservice-mcp"
    ],
    "env": {
      "FRESHSERVICE_API_KEY": "<YOUR_FRESHSERVICE_API_KEY>",
      "FRESHSERVICE_DOMAIN": "<YOUR_FRESHSERVICE_DOMAIN>"
    }
  }
}

Importante : reemplace <YOUR_FRESHSERVICE_API_KEY> con su clave API real y <YOUR_FRESHSERVICE_DOMAIN> con su dominio (por ejemplo, yourcompany.freshservice.com )

Operaciones de ejemplo

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

• Cree un nuevo ticket de incidente con el asunto "Problema de conectividad de red en el departamento de Marketing" y la descripción "Usuarios no pueden conectarse a Wi-Fi en el área de Marketing". Establezca la prioridad en alta.

• "Actualizar el estado de la solicitud de cambio n.° 45678 a 'Aprobado'"

• "Enumere todos los incidentes críticos reportados en las últimas 24 horas"

• Mostrar detalles del equipo portátil con etiqueta 'LT-2023-087'

• "Crear una solicitud de cambio para el mantenimiento programado del servidor el próximo martes a las 2 a. m."

Pruebas

Para fines de prueba, puede iniciar el servidor manualmente:

uvx freshservice-mcp --env FRESHSERVICE_API_KEY=<your_api_key> --env FRESHSERVICE_DOMAIN=<your_domain>

Solución de problemas

• Verifique que su clave API de Freshservice y su dominio sean correctos

• Asegúrese de que haya una conectividad de red adecuada con los servidores de Freshservice

• 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.

Recursos adicionales

• Documentación de la API de Freshservice

• Guía de integración de escritorios de Claude

• Especificación del protocolo MCP