freshservice-mcp

Un servidor MCP (Model Context Protocol) que conecta asistentes de IA a tu instancia de Freshservice ITSM. Gestiona tickets, activos, cambios, problemas, catálogo de servicios, base de conocimientos y más mediante lenguaje natural.

Características

53 herramientas en 9 categorías:

Categoría	Herramientas	Descripción
Tickets	9	Listar, obtener, crear, actualizar, eliminar, responder, añadir notas, conversaciones, buscar
Activos	5	Listar, obtener, crear, actualizar, eliminar
Personas	8	Solicitantes, agentes, grupos, departamentos (listar + obtener)
Tareas de ticket	5	Listar, obtener, crear, actualizar, eliminar subtareas en tickets
Entradas de tiempo	4	Listar, crear, actualizar, eliminar registros de tiempo
Cambios	5	Listar, obtener, crear, actualizar, eliminar solicitudes de cambio
Problemas	5	Listar, obtener, crear, actualizar, eliminar registros de problemas
Catálogo de servicios	3	Explorar elementos del catálogo, obtener detalles, realizar solicitudes de servicio
Base de conocimientos	9	Categorías, carpetas, artículos (CRUD completo)

Inicio rápido

Requisitos previos

Node.js 18+
Una cuenta de Freshservice con acceso a API
Tu clave de API de Freshservice (Icono de perfil > Configuración de perfil > Clave de API en el panel derecho)

Instalación mediante npx (recomendado)

No se requiere instalación. Configura tu cliente MCP para ejecutar:

{
  "mcpServers": {
    "freshservice": {
      "command": "npx",
      "args": ["-y", "freshservice-mcp"],
      "env": {
        "FRESHSERVICE_DOMAIN": "yourcompany",
        "FRESHSERVICE_API_KEY": "your-api-key"
      }
    }
  }
}

Instalación global

npm install -g freshservice-mcp

Luego configura tu cliente MCP:

{
  "mcpServers": {
    "freshservice": {
      "command": "freshservice-mcp",
      "env": {
        "FRESHSERVICE_DOMAIN": "yourcompany",
        "FRESHSERVICE_API_KEY": "your-api-key"
      }
    }
  }
}

Instalación desde el código fuente

git clone https://github.com/tannertm0/freshservice-mcp.git
cd freshservice-mcp
npm install

{
  "mcpServers": {
    "freshservice": {
      "command": "node",
      "args": ["/path/to/freshservice-mcp/src/index.js"],
      "env": {
        "FRESHSERVICE_DOMAIN": "yourcompany",
        "FRESHSERVICE_API_KEY": "your-api-key"
      }
    }
  }
}

Configuración

Variable	Requerido	Descripción
`FRESHSERVICE_DOMAIN`	Sí	Tu subdominio de Freshservice (ej. `tuempresa` para `tuempresa.freshservice.com`)
`FRESHSERVICE_API_KEY`	Sí	Tu clave de API de Freshservice

Configuración del cliente MCP

Claude Desktop - Añadir a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows)

Claude Code - Ejecutar claude mcp add freshservice -- npx -y freshservice-mcp y luego establecer las variables de entorno

Cursor / VS Code - Añadir a tu configuración de MCP siguiendo la documentación de tu editor

Herramientas disponibles

Tickets

Herramienta	Descripción
`list_tickets`	Listar tickets con filtros (estado, prioridad, solicitante, fecha)
`get_ticket`	Obtener detalles completos del ticket
`create_ticket`	Crear un nuevo ticket
`update_ticket`	Actualizar campos del ticket (estado, prioridad, asignación, etc.)
`delete_ticket`	Eliminar un ticket (se mueve a la papelera)
`reply_to_ticket`	Enviar una respuesta en un ticket
`add_note_to_ticket`	Añadir una nota pública o privada
`get_ticket_conversations`	Ver todas las respuestas y notas
`search_tickets`	Filtrar tickets con sintaxis de consulta

Activos

Herramienta	Descripción
`list_assets`	Listar todos los activos/CI
`get_asset`	Obtener detalles del activo con campos personalizados
`create_asset`	Registrar un nuevo activo
`update_asset`	Actualizar campos del activo
`delete_asset`	Eliminar un activo

Personas y organización

Herramienta	Descripción
`list_requesters` / `get_requester`	Usuarios finales
`list_agents` / `get_agent`	Personal de soporte
`list_groups` / `get_group`	Grupos de agentes con miembros
`list_departments` / `get_department`	Departamentos

Tareas de ticket

Herramienta	Descripción
`list_ticket_tasks`	Listar subtareas en un ticket
`get_ticket_task`	Obtener detalles de la tarea
`create_ticket_task`	Añadir una tarea a un ticket
`update_ticket_task`	Actualizar estado/asignación de la tarea
`delete_ticket_task`	Eliminar una tarea

Entradas de tiempo

Herramienta	Descripción
`list_time_entries`	Ver el tiempo registrado en un ticket
`create_time_entry`	Registrar el tiempo empleado
`update_time_entry`	Modificar una entrada de tiempo
`delete_time_entry`	Eliminar una entrada de tiempo

Cambios

Herramienta	Descripción
`list_changes`	Listar solicitudes de cambio
`get_change`	Obtener detalles del cambio (tipo, riesgo, programación)
`create_change`	Crear una solicitud de cambio
`update_change`	Actualizar campos del cambio
`delete_change`	Eliminar un cambio

Problemas

Herramienta	Descripción
`list_problems`	Listar registros de problemas
`get_problem`	Obtener detalles del problema
`create_problem`	Crear un registro de problema
`update_problem`	Actualizar campos del problema
`delete_problem`	Eliminar un problema

Catálogo de servicios

Herramienta	Descripción
`list_service_catalog_items`	Explorar servicios disponibles
`get_service_catalog_item`	Obtener detalles del servicio y campos requeridos
`place_service_request`	Enviar una solicitud de servicio

Base de conocimientos

Herramienta	Descripción
`list_solution_categories` / `get_solution_category`	Explorar categorías de la base de conocimientos
`list_solution_folders` / `get_solution_folder`	Explorar carpetas de la base de conocimientos
`list_solution_articles` / `get_solution_article`	Leer artículos
`create_solution_article`	Escribir un nuevo artículo
`update_solution_article`	Editar un artículo
`delete_solution_article`	Eliminar un artículo

Ejemplos de prompts

Una vez configurado, puedes pedirle a tu asistente de IA cosas como:

"Muéstrame todos los tickets P1 abiertos"
"Crea un ticket porque la impresora del tercer piso no funciona"
"¿Qué activos están asignados a John Smith?"
"Añade una nota privada al ticket #5678 diciendo que estamos esperando al proveedor"
"Crea una solicitud de cambio para la actualización del firewall programada para el próximo martes"
"Busca en la base de conocimientos instrucciones para configurar la VPN"
"Registra 2 horas en el ticket #1234 para la depuración del problema de red"
"Muéstrame todos los problemas abiertos y sus niveles de impacto"
"Realiza una solicitud de un nuevo portátil desde el catálogo de servicios"

Sintaxis de consulta de búsqueda

La herramienta search_tickets utiliza la sintaxis de consulta de filtro de Freshservice:

"priority:4 AND status:2"          - Urgent + Open tickets
"group_id:12345"                   - Tickets assigned to a specific group
"agent_id:67890"                   - Tickets assigned to a specific agent
"created_at:>'2024-01-01'"         - Tickets created after a date

Desarrollo

git clone https://github.com/tannertm0/freshservice-mcp.git
cd freshservice-mcp
npm install
npm test

Licencia

MIT

Freshservice MCP Server