osTicket MCP Server: Verwendung

Praxisbeispiele für den osTicket MCP Server: Aufträge in natürlicher Sprache und die zugehörigen Tool-Aufrufe für Suchen, Erstellen mit Anhang, Ändern, Notizen und Subtickets.

English Version

Zurück zur Übersicht

osTicket MCP Server: Verwendung

Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.

Du formulierst Aufträge in normaler Sprache. Claude wählt das passende Tool und füllt die Parameter. Diese Seite zeigt typische Aufträge und die Aufrufe, die dahinterstehen. Alle Parameter stehen auf der Seite Tools.

Aufträge

Auftrag	Tool
Zeig mir die offenen Tickets	`osticket_list_tickets` mit `status: "open"`
Suche Tickets zu Dashboard Widget	`osticket_search_tickets`
Hol Ticket 680284 mit allen Nachrichten	`osticket_get_ticket`
Wie viele Tickets sind überfällig?	`osticket_get_stats`
Erstelle ein Ticket zu diesem Fehler	`osticket_create_ticket`
Setze Ticket 680284 auf Closed	`osticket_update_ticket`
Schreibe eine Notiz an Ticket 680284	`osticket_update_ticket` mit `note`
Zeig die Untertickets von 680284	`osticket_get_child_tickets`

Ticket suchen und schließen

{ "query": "Dashboard Widget", "limit": 10 }

Mit der Nummer aus dem Ergebnis rufst du das Ticket ab und schließt es:

{ "number": "680284", "statusId": "Closed", "note": "Behoben und ausgeliefert." }

Der Statusname muss einem Status deiner osTicket-Instanz entsprechen, die Schreibweise ist egal. Kennst du die ID, übergibst du sie als Zahl.

Ticket mit Projektkontext und Anhang erstellen

{
  "subject": "Zahlungsberechnung liefert falsche Summe",
  "message": "## Problem\n\nBei Rabattcodes stimmt die Summe nicht.",
  "projectContext": "invoice-management",
  "attachments": [{ "path": "/tmp/screenshot.png" }]
}

Das Ticket beginnt mit der Zeile **Projekt:** invoice-management. Die Nachricht wird als Markdown gesendet, solange du kein format angibst. Ob osTicket Markdown darstellt, hängt von den Plugins der Instanz ab, etwa Markdown Support.

Name und E-Mail-Adresse kommen aus OSTICKET_DEFAULT_NAME und OSTICKET_DEFAULT_EMAIL, wenn du sie nicht angibst.

Eigenschaften ändern

{
  "number": "680284",
  "departmentId": 5,
  "staffId": 3,
  "dueDate": "2026-03-15"
}

Abteilung, Mitarbeiter, Hilfethema und SLA übergibst du als ID. Die IDs findest du zum Beispiel im osTicket-Admin-Panel oder in einem abgerufenen Ticket (departmentId, staffId).

Notiz mit Datei anhängen

{
  "number": "680284",
  "note": "Der Audit-Bericht liegt bei.",
  "noteTitle": "Audit",
  "attachments": [{ "path": "/tmp/audit.pdf" }]
}

Anhänge hängen immer an der Notiz. Ohne note lehnt das Tool den Aufruf ab.

Anhang eines Tickets herunterladen

Rufe das Ticket mit osticket_get_ticket ab.
Suche im Thread den Eintrag mit dem Anhang und nimm dessen file_id.
Rufe osticket_download_attachment mit dieser file_id auf.

Die Antwort nennt den Pfad der gespeicherten Datei im temporären Verzeichnis.

Subtickets verwalten

{ "parentNumber": "680284", "childNumber": "680290" }

Das ist der Aufruf für osticket_create_subticket_link. Ein Ticket kann nur ein Elternticket haben. Mit osticket_unlink_subticket und der Kindnummer löst du die Verknüpfung wieder.