Jitbit Helpdesk

Jitbit Helpdesk MCP Server

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 on-premise.

⚠️ Usa el endpoint HTTP alojado cuando sea posible. Jitbit incluye un endpoint HTTP MCP integrado en /api/mcp en todas las instalaciones SaaS y on-premise que ejecuten la versión 11.21 o posterior. Es la forma preferida de conectar asistentes de IA a Jitbit: sin instalación local, siempre sincronizado con las versiones de Jitbit. Consulta la documentación de MCP de Jitbit. A partir de 2.x, este paquete npm es un proxy stdio ligero hacia ese mismo endpoint, para clientes que aún no soportan servidores MCP HTTP remotos. Se requiere Jitbit 11.21 o posterior. Si estás en una versión on-premise anterior, quédate en jitbit-helpdesk-mcp@1.x.

Configuración

Dos opciones:

1. Endpoint HTTP alojado (recomendado) — conecta tu cliente MCP directamente al /api/mcp de Jitbit. Úsalo siempre que tu cliente soporte transporte MCP HTTP.
2. Paquete npm local (proxy stdio) — este repositorio. Úsalo cuando tu cliente MCP solo soporte transporte stdio. Reenvía cada solicitud a {JITBIT_URL}/api/mcp y no añade nada propio.

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 (proxy stdio)

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ñade 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

Variable	Requerido	Descripción
JITBIT_URL	Sí	URL base de tu instancia de Jitbit (SaaS: https://yourcompany.jitbit.com, on-prem: la URL de tu servidor)
JITBIT_TOKEN	Sí	Token de API — ver más abajo

Obteniendo 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 el valor de JITBIT_TOKEN

Herramientas

El proxy expone las herramientas que la instancia de Jitbit conectada anuncia en /api/mcp — típicamente búsqueda, listado y lectura de tickets, además de cualquier cosa que Jitbit agregue en versiones posteriores. Usa el listado de herramientas de tu cliente MCP (o la documentación de MCP de Jitbit) para el catálogo actualizado.

Desarrollo

npm install
npm run build

Licencia

MIT