Jitbit Helpdesk MCP-Server

Ein MCP-Server (Model Context Protocol), der es KI-Assistenten ermöglicht, Support-Tickets von Jitbit Helpdesk zu suchen und zu lesen. Funktioniert sowohl mit SaaS- als auch mit On-Premise-Installationen.

⚠️ Hinweis zur Veraltung: Jitbit bietet jetzt einen integrierten HTTP-MCP-Endpunkt unter /api/mcp für alle SaaS- und On-Premise-Installationen ab Version 11.21 an. Dies ist die bevorzugte Methode, um KI-Assistenten mit Jitbit zu verbinden – sie bietet mehr Tools, bleibt automatisch mit Jitbit-Releases synchron und erfordert keine lokale Installation. Dieses npm-Paket wird in Kürze als veraltet markiert und wird nur für On-Premise-Installationen empfohlen, die älter als 11.21 sind. Siehe die Jitbit MCP-Dokumentation.

Einrichtung

Zwei Optionen:

1. Gehosteter HTTP-Endpunkt (empfohlen) – in Jitbit integriert, keine Installation erforderlich. Verfügbar für SaaS- und On-Premise-Installationen ab Version 11.21. Siehe die Jitbit MCP-Dokumentation.

2. Lokales npm-Paket (veraltet) – dieses Repository, läuft lokal über npx. Verwenden Sie dies nur, wenn Ihre On-Premise-Jitbit-Version älter als 11.21 ist.

Option 1: Gehosteter HTTP-Endpunkt

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"
      }
    }
  }
}

Option 2: Lokales npm-Paket

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

Fügen Sie dies zu Ihrer Konfigurationsdatei hinzu:

• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %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"
      }
    }
  }
}

Umgebungsvariablen

Abrufen Ihres API-Tokens

1. Melden Sie sich bei Ihrem Jitbit Helpdesk an

2. Gehen Sie zu Ihrem Benutzerprofil (klicken Sie auf Ihren Avatar oben rechts)

3. Klicken Sie auf die Schaltfläche "API Token"

4. Kopieren Sie das Token und verwenden Sie es als Wert für JITBIT_TOKEN

Related MCP server: tickiti-mcp

Tools

jitbit_search_tickets

Suchen Sie Tickets nach Stichwort oder Phrase.

Parameter:

• query (string, erforderlich) – Suchanfrage

• limit (number, Standard 25) – maximale Ergebnisse (1–100)

• offset (number, Standard 0) – Paginierungs-Offset

jitbit_list_tickets

Listen Sie Tickets auf und filtern Sie diese.

Parameter:

• mode (string, optional) – "all", "unanswered" oder "updated"

• status (string, optional) – nach Ticket-Status filtern

• limit (number, Standard 25) – maximale Ergebnisse (1–100)

• offset (number, Standard 0) – Paginierungs-Offset

jitbit_get_ticket

Abrufen eines einzelnen Tickets mit seinem vollständigen Konversationsverlauf.

Parameter:

• ticketId (number, erforderlich) – die Ticket-ID

Entwicklung

npm install
npm run build

Lizenz

MIT