osTicket MCP Server
MCP-Server für osTicket: Claude liest, sucht, erstellt, aktualisiert und löscht Tickets über die REST-API und verwaltet Subtickets. 12 Tools, stdio, Node.js 18+.
osTicket MCP Server
Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.
Überblick
Der osTicket MCP Server verbindet Claude mit deiner osTicket-Instanz. Claude kann Tickets abrufen, suchen, erstellen, aktualisieren und löschen, Anhänge hochladen und herunterladen und Eltern-Kind-Beziehungen zwischen Tickets verwalten, ohne dass du zwischen Editor und osTicket-Oberfläche wechselst.
Der Server läuft lokal als Node.js-Prozess und spricht über stdio mit dem MCP-Client. Zu osTicket baut er HTTP-Anfragen mit einem API-Key auf. Die Endpunkte dafür stellen osTicket-Plugins bereit.
Der Server funktioniert nur zusammen mit dem osTicket-Plugin API Endpoints. Zum Erstellen von Tickets braucht er zusätzlich das Plugin API Key Wildcard, für die Subticket-Tools das Plugin Subticket Manager.
graph LR
A["Claude Code oder anderer MCP-Client"] -->|"stdio"| B["osTicket MCP Server (Node.js)"]
B -->|"HTTPS, Header X-API-Key"| C["osTicket API"]
C --> D["Plugin API Endpoints"]
C --> E["Plugin API Key Wildcard"]
D --> F["Plugin Subticket Manager"]
Dokumentation
| Seite | Inhalt |
|---|---|
| Installation | Voraussetzungen auf osTicket-Seite, Server bauen, Konfigurationsdatei, Registrierung im MCP-Client, Update und Entfernen |
| Konfiguration | Alle Umgebungsvariablen mit Standardwerten, Speicherort der Datei, Limits |
| Tools | Alle 12 Tools mit Parametern, Rückgaben, benötigten API-Key-Berechtigungen und Plugin-Endpunkten |
| Verwendung | Beispielaufträge und Abläufe mit Anhängen, Notizen und Subtickets |
| Sicherheit | Umgang mit dem API-Key, TLS, Dateizugriff, Logging, Berechtigungen |
| Technik | Architektur, Request-Ablauf, Wiederholungen, Fehlerbehandlung, Dateistruktur |
| Fehlerbehebung | Fehlermeldungen, Ursachen und bekannte Einschränkungen |
Funktionen
| Funktion | Beschreibung |
|---|---|
| Tickets lesen | Einzelnes Ticket mit Thread und Anhang-Metadaten, Liste mit Statusfilter und Paginierung, Suche im Betreff, Statistik |
| Tickets erstellen | Markdown, HTML oder Text, optionaler Projektkontext, Standardwerte für Name, E-Mail und Hilfethema, bis zu 5 Anhänge |
| Tickets ändern | Status, Abteilung, Hilfethema, Mitarbeiter, SLA, Fälligkeitsdatum, Elternticket, interne Notiz mit Anhängen |
| Tickets löschen | Endgültiges Löschen eines Tickets |
| Subtickets | Elternticket und Kindtickets abrufen, Verknüpfung erstellen und lösen |
| Anhänge laden | Anhang einer Thread-Nachricht in eine temporäre Datei speichern |
| Status per Name | Statusnamen werden über die Statusliste von osTicket in IDs aufgelöst |
Anforderungen
| Anforderung | Hinweis |
|---|---|
| Node.js | 18 oder höher |
| osTicket mit REST-API | Die Dokumentation der Plugins nennt osTicket 1.18.x |
| Plugin API Endpoints | Pflicht für alle Tools außer dem Erstellen von Tickets |
| Plugin API Key Wildcard | Pflicht für osticket_create_ticket, weil der Server den Endpunkt /api/wildcard/tickets.json nutzt |
| Plugin Subticket Manager | Nur für die vier Subticket-Tools |
| API-Key | Mit den Berechtigungen, die die genutzten Tools brauchen |
Lizenz
Der Server steht unter der MIT-Lizenz, siehe LICENSE.
Support
Fragen und Fehler gehören in den Issue Tracker. Gib dabei Node.js-Version, osTicket-Version, Fehlermeldung und die Zeilen aus der Log-Datei an.
Entwickelt von Markus Michalski.