Servidor MCP de Jitbit Helpdesk

Un servidor MCP (Model Context Protocol) que permite a los asistentes de IA buscar y leer tickets de soporte de Jitbit Helpdesk. Funciona tanto con instalaciones SaaS como locales (on-premise).

⚠️ Aviso de obsolescencia: Jitbit ahora incluye un endpoint HTTP MCP integrado en /api/mcp en todas las instalaciones SaaS y locales que ejecuten la versión 11.21 o posterior. Esa es la forma preferida de conectar asistentes de IA a Jitbit: tiene más herramientas, se mantiene sincronizado automáticamente con las versiones de Jitbit y no requiere instalación local. Este paquete npm quedará obsoleto pronto y solo se recomienda para instalaciones locales anteriores a la 11.21. Consulta la documentación de MCP de Jitbit.

Configuración

Dos opciones:

1. Endpoint HTTP alojado (recomendado): integrado en Jitbit, no requiere instalación. Disponible en instalaciones SaaS y locales que ejecuten la versión 11.21 o posterior. Consulta la documentación de MCP de Jitbit.

2. Paquete npm local (obsoleto): este repositorio, se ejecuta localmente mediante npx. Úsalo solo si tu instalación local de Jitbit es anterior a la 11.21.

Opción 1: Endpoint HTTP alojado

Claude Code

claude mcp add --transport http jitbit-helpdesk https://yourcompany.jitbit.com/api/mcp \
  --header "Authorization: Bearer your-api-token"

Claude Desktop, Cursor, Windsurf

{
  "mcpServers": {
    "jitbit-helpdesk": {
      "type": "http",
      "url": "https://yourcompany.jitbit.com/api/mcp",
      "headers": {
        "Authorization": "Bearer your-api-token"
      }
    }
  }
}

Opción 2: Paquete npm local

Claude Code

claude mcp add jitbit-helpdesk \
  -e JITBIT_URL=https://yourcompany.jitbit.com \
  -e JITBIT_TOKEN=your-api-token \
  -- npx -y jitbit-helpdesk-mcp

Claude Desktop, Cursor, Windsurf

Añádelo a tu archivo de configuración:

• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows)

• Cursor: Settings > MCP Servers

• Windsurf: Settings > MCP Servers

{
  "mcpServers": {
    "jitbit-helpdesk": {
      "command": "npx",
      "args": ["-y", "jitbit-helpdesk-mcp"],
      "env": {
        "JITBIT_URL": "https://yourcompany.jitbit.com",
        "JITBIT_TOKEN": "your-api-token"
      }
    }
  }
}

Variables de entorno

Obtención de tu token de API

1. Inicia sesión en tu Jitbit Helpdesk

2. Ve a tu Perfil de usuario (haz clic en tu avatar en la esquina superior derecha)

3. Haz clic en el botón "API Token"

4. Copia el token y úsalo como valor de JITBIT_TOKEN

Related MCP server: tickiti-mcp

Herramientas

jitbit_search_tickets

Busca tickets por palabra clave o frase.

Parámetros:

• query (cadena, requerido): consulta de búsqueda

• limit (número, predeterminado 25): resultados máximos (1–100)

• offset (número, predeterminado 0): desplazamiento de paginación

jitbit_list_tickets

Enumera y filtra tickets.

Parámetros:

• mode (cadena, opcional): "all", "unanswered" o "updated"

• status (cadena, opcional): filtrar por estado del ticket

• limit (número, predeterminado 25): resultados máximos (1–100)

• offset (número, predeterminado 0): desplazamiento de paginación

jitbit_get_ticket

Obtén un ticket individual con su hilo de conversación completo.

Parámetros:

• ticketId (número, requerido): el ID del ticket

Desarrollo

npm install
npm run build

Licencia

MIT