MCP-Server
Zammad verfügt über einen eigenen Server für das Model Context Protocol (MCP). Verbinden Sie einen KI-Client, den Sie bereits nutzen – beispielsweise eine Chat-Anwendung oder ein Programmierwerkzeug – mit diesem Server, und lesen, suchen und führen Sie Aktualisierungen Ihrer Tickets von dort aus. Der Server ist Bestandteil jeder Installation; Sie müssen nichts zusätzlich installieren oder ausführen.
Ob der Server Verbindungen akzeptiert, entscheidet Ihr Administrator. Sollte eine Verbindung zu https://zammad.example.com/mcp fehlschlagen, fragen Sie Ihren Administrator, ob der Server aktiviert ist.
Einen KI-Client verbinden
Für die Verbindung sind ein persönlicher Zugangs-Token und die Adresse des Servers in Ihrem Client erforderlich.
Persönliches Zugangs-Token erstellen
Der Client stellt eine Verbindung mit einem persönlichen Zugangs-Token Ihres Kontos her. Öffnen Sie Ihr Profil und den Abschnitt Token-Zugriff (siehe persönliche Einstellungen) und erstellen Sie ein Token mit der Berechtigung ticket.agent, damit der Client mit Tickets arbeiten kann. Sie können dem Token ein Ablaufdatum zuweisen. Kopieren Sie das Token, das Zammad Ihnen bei der Erstellung des Tokens anzeigt.
Zammad zu Ihrem Client hinzufügen
Fügen Sie dem Client Zammad als MCP-Server hinzu. Der Client benötigt die Fähigkeit Streamable HTTP für den MCP-Transport sowie die Möglichkeit, bei jeder Anfrage einen festen Authorization: Bearer Header zu senden. Die bloße Unterstützung des Transports reicht nicht aus. Eine solche Konfiguration erfordert diese drei Einträge:
- Die Serveradresse: Die Domain, über die Sie Zammad aufrufen mit angehängtem
/mcp, z.B.https://zammad.example.com/mcp - Den Transport, Streamable HTTP
- Das Token, das mit jeder Anfrage als HTTP-Header gesendet wird:
Authorization: Bearer {ihr_token}
Clients, die eine JSON-Konfiguration lesen (was viele tun), betrachten Zammad als Server mit der angegebenen Adresse und dem angegebenen Header. Ersetzen Sie zammad.example.com durch die Domain, unter der Sie Zammad erreichen, und {ihr token} durch das von Ihnen kopierte Token:
{
"mcpServers": {
"zammad": {
"type": "http",
"url": "https://zammad.example.com/mcp",
"headers": {
"Authorization": "Bearer {ihr_token}"
}
}
}
}WARNING
Das Token funktioniert wie Ihr Passwort. Speichern Sie es nicht in einer Konfigurationsdatei, die andere lesen können oder die in einem Repository landen könnte. Bewahren Sie die Datei vertraulich auf oder verweisen Sie auf ein gespeichertes Secret, sofern Ihr Client dies unterstützt.
Andere Clients fordern dieselben drei Einträge in ihrem eigenen Formular an. Sobald die Verbindung hergestellt ist, zeigt eine erste Anfrage wie "Zeige meine zugewiesenen Tickets" an, ob der Client Zammad erreicht.
Zammad antwortet ausschließlich unter der Adresse, für die es konfiguriert ist – also der Adresse, unter der Sie Zammad öffnen. Sollte die Verbindung fehlschlagen, überprüfen Sie bitte, ob der Client genau diese Adresse verwendet.
Was der Client tun kann
Der verbundene Client arbeitet mit Ihren Berechtigungen: Er kann genau das tun, wozu das Token und Ihr Konto berechtigt sind – und nicht mehr. Außerdem werden Änderungen so protokolliert, als wären sie von Ihnen direkt vorgenommen worden. Ein Benutzer ohne Agenten-Berechtigungen, wie beispielsweise ein Kunde, hat keinen Zugriff auf Werkzeuge. Die vollständige Liste der Werkzeugen mit den jeweiligen Zugriffsrechten und deren Einschränkungen finden Sie in der MCP-Referenz zu den MCP-Werkzeugen.
- Öffnen Sie ein Ticket anhand seiner Nummer, seiner ID oder eines eingefügten Links und lesen Sie die Nachrichten, internen Notizen, Anhänge, die Historie und den gemeinsamen Entwurf.
- Lesen Sie den Kunden und die Organisation eines Tickets aus.
- Suchen Sie nach Tickets anhand von Begriffen und Bezeichnungen, wie beispielsweise dem Kunden, der Organisation, dem Status, dem Besitzer, der Gruppe oder der Priorität eines Tickets.
- Listen Sie Ihre eigenen Übersichten und die dazugehörigen Tickets auf und sortieren Sie die Listen beispielsweise nach Erstellungsdatum oder letzter Aktualisierung, damit der Client mit dem ältesten Ticket beginnen kann.
- Suchen Sie nach Benutzern, Organisationen und in der Knowledge Base.
- Lesen Sie den Text aus im Anhang einer Nachricht enthaltenen Dateien: Textdateien bis zu 10 MB; andere Dateien werden als Download-Link zur Verfügung gestellt.
- Ändern Sie Ticket-Attribute, legen Sie Tags fest und fügen Sie interne Notizen hinzu.
- Speichern und verschicken Sie gemeinsame Entwürfe und verknüpfen Sie Tickets und Antworten aus der Knowledge Base.
- Erstellen Sie Tickets und verfassen Sie Nachrichten.
Nachrichten, Notizen und Entwürfe können als reiner Text oder als HTML verfasst werden. Zammad entfernt bei Letzterem unsicheres Markup. SMS, Telegram, WhatsApp und Facebook akzeptieren ausschließlich reinen Text; HTML wird dort nicht zugelassen. Dateien können nicht über den Client versendet werden: Wenn Sie eine Datei versenden möchten, fügen Sie diese bitte direkt in Zammad selbst zur Nachricht hinzu.
Wenn in einem Ticket eine Zeiterfassung verlangt wird, fragt der Client Sie nach der Zeit und erfasst diese. Sie können auch angeben, dass Sie keine Zeit erfassen wollen, woraufhin Zammad die Nachricht ohne erfasste Zeit speichert.
Freigabe ausgehender Nachrichten
Sofern der Client dies unterstützt, fordert Zammad Sie auf, eine Nachricht zu genehmigen, bevor sie an einen Kunden geht. Die Genehmigungsanfrage enthält den vollständigen Text der Nachricht, die Empfänger und die Sichtbarkeitseinstellungen, und Zammad versendet die Nachricht erst, nachdem Sie diese akzeptiert haben.
Sollten Sie dies ablehnen, versendet Zammad nichts und nimmt keine Änderungen am Ticket vor. Der Client kann Ihnen dann anbieten, den Text als gemeinsamen Entwurf des Tickets zu speichern, sofern die Gruppe gemeinsame Entwürfe zulässt, damit Sie ihn anschließend aus Zammad heraus versenden können.
Ein Client, der eine Genehmigungsanfrage nicht anzeigen kann, stützt sich auf seine eigenen internen Genehmigungsprozesse in Verbindung mit dem Tool-Aufruf, und Zammad fragt kein zweites Mal nach. Zammad benötigt jedoch weiterhin Ihre Zustimmung für zwei Änderungen: das Ersetzen eines bereits gespeicherten gemeinsamen Entwurfs und das Schließen eines Tickets, dessen Checkliste unvollständig ist. Lassen Sie die Bestätigung von Tool-Aufrufen in Ihrem Client aktiviert, da ein Client, der diese ohne Abfrage ausführt, eine Nachricht ohne weitere Rückfrage versendet.