Ticketsystem API und MCP-Server, ohne Aufpreis
404desk hat eine REST-API und Webhooks mit eigenen Schlüsseln je Firma. Dazu kommt ein MCP-Server, über den KI-Assistenten Tickets lesen, anlegen und beantworten können. Alles gehört zur Schnittstelle und ist im Grundpreis.
curl https://brenntal.404desk.de/api/v1/tickets \
-H "Authorization: Bearer $API_SCHLUESSEL" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $ANFRAGE_ID" \
-d '{"betreff":"Monitor flackert",
"beschreibung":"Das Bild setzt alle paar Minuten aus.",
"melderId":"$MELDER_ID"}'
{ "nummer": 1295, "betreff": "Monitor flackert", "status": "NEU", … }So bindest du 404desk an
Schlüssel anlegen
Als Admin in der Konsole unter Anbindungen. Jeder Schlüssel hat einen Namen, eine verantwortliche Person aus der IT, eine Gültigkeit von höchstens 90 Tagen und nur die Rechte, die das Werkzeug braucht. Er wird genau einmal angezeigt.
API oder Webhook wählen
Die REST-API, wenn dein Programm fragt. Ein Webhook, wenn 404desk Bescheid geben soll, etwa bei jedem neuen Ticket.
MCP-Server verbinden
Im KI-Assistenten die Adresse des MCP-Servers und den Schlüssel eintragen.
Schlüssel widerrufen
Braucht ein Programm keinen Zugang mehr, widerrufst du seinen Schlüssel. Er gilt dann sofort nicht mehr.
Wofür Admins die Schnittstellen nutzen
Ein Skript, das bei jedem Eintritt aus der Personalsoftware ein Ticket anlegt. Ein Webhook, der bei jedem neuen Ticket ein kleines Programm anstößt, das die Ticketnummer in einen Teams-Kanal schreibt. Eine Abfrage, die Tickets mit Status und Datum in die eigene Auswertung holt. Ein KI-Assistent, der morgens die neuen Tickets zusammenfasst.
- REST-API
- Tickets lesen, anlegen und öffentlich beantworten, mit Schlüsseln je Firma. Bis zu 60 Anfragen pro Minute je Schlüssel und 300 je Firma.
- Rechte je Schlüssel
- Tickets lesen, Tickets anlegen und öffentliche Antworten schreiben lassen sich einzeln erlauben. Ein Schlüssel nur zum Lesen ist also möglich.
- Webhooks
- 404desk meldet drei Ereignisse an eine HTTPS-Adresse, die du festlegst: Ticket angelegt, Status geändert und öffentliche Antwort. Die Nachricht ist signiert und enthält Ticketnummer und Status, aber keine Tickettexte, Namen oder Dateien.
- MCP-Server
- Tickets auflisten, ein Ticket lesen, ein Ticket anlegen und öffentlich antworten, für Assistenten mit MCP.
- Preis
- Im Grundpreis, ohne Aufschlag je Aufruf.
Schlüssel sicher verwalten
Gib jedem Programm einen eigenen Schlüssel, dann kannst du einen einzelnen widerrufen, ohne alles umzustellen. Leg Schlüssel nicht in Skripte, die im Netzlaufwerk liegen, sondern in einen Kennwortmanager oder einen Tresor für Geheimnisse. Gib jedem Schlüssel nur die Rechte, die er braucht. Weil Schlüssel nach spätestens 90 Tagen ablaufen, siehst du beim Ersetzen von selbst, welche noch gebraucht werden.
Für wen die Schnittstellen gedacht sind
Für Admins, die ein bisschen skripten und keine Lust haben, auf Funktionen zu warten. Wer PowerShell kann, kann mit der REST-API arbeiten. Wer schon mit einem KI-Assistenten arbeitet, der MCP spricht, hat mit dem MCP-Server die Tickets im selben Fenster.
Wer gar nicht programmieren will, kommt mit Automationen in Klartext sehr weit.
Fragen zu API, Webhooks und MCP
Was ist ein MCP-Server?
MCP steht für Model Context Protocol, einen offenen Standard, über den KI-Assistenten Werkzeuge anderer Programme benutzen. Der MCP-Server von 404desk stellt Tickets lesen, anlegen und beantworten als solche Werkzeuge bereit.
Braucht der MCP-Server den KI-Baustein?
Nein. Der MCP-Server gehört zur Schnittstelle und ist im Grundpreis. Die KI läuft dabei in eurem eigenen Assistenten, nicht in 404desk.
Welche Assistenten kann ich verbinden?
Jeden, der MCP über HTTP spricht und dabei einen festen Schlüssel im Kopf der Anfrage mitschicken kann. Eine Anmeldung über OAuth gibt es am MCP-Server nicht.
Wo ist die Dokumentation?
In der Konsole unter Anbindungen stehen die Adressen, ein Schnellstart und die Grenzen. Die vollständige Beschreibung der REST-API ruft dein Werkzeug mit seinem Schlüssel unter /api/v1/openapi.json ab.