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.

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

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`
`search_tickets`	Encuentra entradas que coincidan con los 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`	Recuperar detalles de billetes individuales	`ticket_id`

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

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
Configure su dominio y los detalles de autenticación como se muestra a continuación

Uso con Claude Desktop

Instalar Claude Desktop desde el sitio web oficial
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.

Freshservice MCP server