Servidor Freshservice MCP

Visión general

Una potente implementación de servidor MCP (Model Control Protocol) que se integra perfectamente con Freshservice, permitiendo a los modelos de IA interactuar con los módulos de Freshservice y realizar diversas operaciones de gestión de servicios de TI. Este puente de integración permite a sus asistentes de IA gestionar y resolver tickets de servicio de TI, agilizando su flujo de trabajo de soporte.

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 con modelos de IA: Permite que Claude y otros modelos de IA ejecuten operaciones de service desk a través de Freshservice
• Gestión ITSM automatizada: Maneja eficientemente 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 servicios de TI

Módulos Freshservice compatibles

Este servidor MCP soporta actualmente operaciones a través de una amplia gama de módulos Freshservice:

• Tickets
• Conversaciones
• Productos
• Solicitantes
• Agentes
• Grupos de agentes
• Grupos de solicitantes
• Respuestas programadas
• Carpetas de respuestas programadas
• Espacios de trabajo
• Categorías de soluciones
• Carpetas de soluciones
• Artículos de soluciones

Componentes y herramientas

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

Gestión de tickets

Primeros pasos

Instalación a través de Smithery

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

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

Requisitos previos

• Una cuenta de 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:

   • Navega a Configuración de perfil → Configuración de API
   • Copie su clave de API para la configuración

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

Uso con Claude Desktop

1. Instale Claude Desktop desde el sitio web oficial
2. Añade la siguiente configuración a tu claude_desktop_config.json:

"mcpServers": { "freshservice-mcp": { "command": "uvx", "args": [ "freshservice-mcp" ], "env": { "FRESHSERVICE_APIKEY": "<SU_FRESHSERVICE_APIKEY>", "FRESHSERVICE_DOMAIN": "<SU_DOMINIO_SERVICIO_FRESCO>" } }

Importante: Sustituya <YOUR_FRESHSERVICE_APIKEY> por su clave de API real y <YOUR_FRESHSERVICE_DOMAIN> por su dominio (por ejemplo, suempresa.freshservice.com)

Ejemplos de operaciones

Una vez configurado, puede pedir a Claude que realice operaciones como:

• "Crear un nuevo ticket de incidencia con asunto 'Problema de conectividad de red en el departamento de Marketing' y descripción 'Los usuarios no pueden conectarse a la Wi-Fi en el área de Marketing', establecer la prioridad en alta"
• actualizar el estado de la solicitud de cambio nº 45678 a "Aprobado"
• "Listar todos los incidentes críticos reportados en las últimas 24 horas"
• "Mostrar detalles de activos para el portátil con la etiqueta de activo 'LT-2023-087'"
• "Crear una solicitud de cambio para el mantenimiento programado del servidor el próximo martes a las 2 AM"

Probar

Para realizar pruebas, puede iniciar el servidor manualmente:

uvx freshservice-mcp --env FRESHSERVICE_APIKEY=<su_clave_api> --env FRESHSERVICE_DOMAIN=<su_dominio>

Solución de problemas

• Compruebe que la clave API y el dominio de Freshservice son correctos
• Asegúrese de que la conectividad de red a los servidores de Freshservice es correcta
• Compruebe los límites y cuotas de la API
• Compruebe que el comando uvx está disponible en su PATH

Licencia

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

Recursos adicionales

• Documentación de la API de Freshservice
• Guía de integración de Claude Desktop
• Especificación del protocolo MCP