---
url: https://next.zammad.org/de/documentation/use/guides/mcp-server.md
---

# 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](/de/documentation/use/personal-settings#token-zugriff)) 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:

```json
{
  "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](/de/reference/mcp-tools).

* Ö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.
