Freshservice

Interactúa con los módulos de Freshservice para operaciones de gestión de servicios de TI.

Documentación

Servidor MCP de Freshservice

Descripción General

Una implementación potente de servidor MCP (Model Context Protocol) que se integra perfectamente con Freshservice, permitiendo que los modelos de IA interactúen con los módulos de Freshservice y realicen diversas operaciones de gestión de servicios de TI. Este puente de integración permite a tus asistentes de IA gestionar y resolver tickets de servicio de TI, optimizando tu flujo de trabajo de soporte.

Características Principales

Integración Freshservice de Nivel Empresarial: Comunicación directa y segura con los endpoints 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, actualización, respuestas de tickets y gestión de activos
Aceleración del Flujo de Trabajo: Reduce la intervención manual en tareas rutinarias de servicios de TI

Módulos de Freshservice Compatibles

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

Tickets
Cambios
Conversaciones
Productos
Solicitantes
Agentes
Grupos de Agentes
Grupos de Solicitantes
Respuestas Predefinidas
Carpetas de Respuestas Predefinidas
Espacios de Trabajo
Categorías de Soluciones
Carpetas de Soluciones
Artículos de Soluciones

Componentes y Herramientas

El servidor proporciona un kit de herramientas integral para operaciones de Freshservice:

Gestión de Tickets

Herramienta	Descripción	Parámetros Clave
`create_ticket`	Crear nuevos tickets de servicio	`subject`, `description`, `source`, `priority`, `status`, `email`
`update_ticket`	Actualizar tickets existentes	`ticket_id`, `updates`
`delete_ticket`	Eliminar tickets	`ticket_id`
`filter_tickets`	Buscar tickets que coincidan con criterios	`query`
`get_ticket_fields`	Recuperar definiciones de campos de tickets	Ninguno
`get_tickets`	Listar todos los tickets con paginación	`page`, `per_page`
`get_ticket_by_id`	Recuperar detalles de un ticket individual	`ticket_id`

Gestión de Cambios

Herramienta	Descripción	Parámetros Clave
`get_changes`	Listar todos los cambios con paginación	`page`, `per_page`, `query`
`filter_changes`	Filtrar cambios con consultas avanzadas	`query`, `page`, `per_page`
`get_change_by_id`	Recuperar detalles de un cambio individual	`change_id`
`create_change`	Crear nueva solicitud de cambio	`requester_id`, `subject`, `description`, `priority`, `impact`, `status`, `risk`, `change_type`
`update_change`	Actualizar cambio existente	`change_id`, `change_fields`
`close_change`	Cerrar cambio con explicación del resultado	`change_id`, `change_result_explanation`
`delete_change`	Eliminar cambio	`change_id`
`get_change_tasks`	Obtener tareas para un cambio	`change_id`
`create_change_note`	Añadir nota a un cambio	`change_id`, `body`

🚨 Importante: Sintaxis de Consulta para Filtrado

Al usar get_changes o filter_changes con el parámetro query, la cadena de consulta debe estar entre comillas dobles para que la API de Freshservice funcione correctamente:

✅ CORRECTO: "status:3", "approval_status:1 AND status:<6"
❌ INCORRECTO: status:3 (causará Error Interno del Servidor 500)

Ejemplos Comunes de Consulta:

"status:3" - Cambios pendientes de aprobación
"approval_status:1" - Cambios aprobados
"approval_status:1 AND status:<6" - Cambios aprobados que no están cerrados
"planned_start_date:>'2025-07-14'" - Cambios que comienzan después de una fecha específica
"status:3 AND priority:1" - Cambios de alta prioridad pendientes de aprobación

Primeros Pasos

Instalación mediante Smithery

Para instalar freshservice_mcp automáticamente mediante Smithery:

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

Requisitos Previos

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

Configuración

Genera tu clave API de Freshservice desde el panel de administración:
- Navega a Configuración de Perfil → Configuración de API
- Copia tu clave API para la configuración
Configura tu dominio y detalles de autenticación como se muestra a continuación

Uso con Claude Desktop

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

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

Importante: Reemplaza <YOUR_FRESHSERVICE_APIKEY> con tu clave API real y <YOUR_FRESHSERVICE_DOMAIN> con tu dominio (por ejemplo, yourcompany.freshservice.com)

Ejemplos de Operaciones

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

Tickets:

"Crea un nuevo ticket de incidente con el asunto 'Problema de conectividad de red en el departamento de Marketing' y la descripción 'Los usuarios no pueden conectarse al Wi-Fi en el área de Marketing', establece la prioridad como alta"
"Lista todos los incidentes críticos reportados en las últimas 24 horas"
"Actualiza el estado del ticket #12345 a resuelto"

Cambios:

"Crea una solicitud de cambio para el mantenimiento programado del servidor el próximo martes a las 2 AM"
"Actualiza el estado de la solicitud de cambio #45678 a 'Aprobado'"
"Cierra el cambio #5092 con la explicación del resultado 'Desplegado exitosamente en producción. Todas las pruebas pasaron.'"
"Lista todos los cambios pendientes"

Otras Operaciones:

"Muestra los detalles del activo para el portátil con la etiqueta de activo 'LT-2023-087'"
"Crea un artículo de solución sobre los procedimientos de restablecimiento de contraseña"

Pruebas

Para fines de prueba, puedes iniciar el servidor manualmente:

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

Solución de Problemas

Verifica que tu clave API y dominio de Freshservice sean correctos
Asegura una conectividad de red adecuada a los servidores de Freshservice
Comprueba los límites 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 todos los detalles.

Recursos Adicionales

Hecho con ❤️ por effy