Zammad MCP Server: Einrichtung, Nutzung und was Sie mit MCP tun können

📖 10 Minuten Lesezeit • Aktualisiert 20. Mai 2026

Wer nach Zammad MCP sucht, möchte Zammad mit einem KI-Assistenten verbinden — ohne eigene REST-Integration. Der Zammad MCP Server (MIT, Open Source) stellt Tickets, Nutzer, Organisationen und Gruppen als Model Context Protocol-Tools für Claude Desktop, Cursor und andere MCP-Clients bereit.

Dieser Artikel erklärt die Einrichtung, typische Nutzung und Verweise auf die vollständige Doku: Zammad MCP Server Dokumentation.

GitHub: github.com/Softoft-Orga/zammad-mcp-server
PyPI: zammad-mcp-server

Was ist der Zammad MCP Server?

Der Server verbindet Ihren MCP-Client mit der Zammad REST API und bietet über 30 typisierte Tools, Prompts (Zusammenfassung, Kundenkommunikation, Eskalation) sowie Zugriffskontrolle (z. B. Lösch-Tools sperren).

Zammad MCP im Vergleich zu anderen Lösungen

Wenn Sie KI-Unterstützung für Ihr Helpdesk evaluieren, hängen die Optionen stark davon ab, wo die Intelligenz ausgeführt werden soll:

Ansatz	Optimaler Einsatzbereich	Vorteile / Features	Werkzeuge & Tools
Zammad 7.1 Native KI	In-App-Assistenz direkt im Zammad Web-Interface	Nahtlose Sidebar-Integration, grundlegender Schreibassistent	Zusammenfassung, Tonfall-Anpassung (In-UI)
Zammad MCP Server (Open-Core)	Externe KI-Assistenten (Claude Desktop, Cursor, Custom Agents)	Basiert auf FastMCP 2.0+, granulare Sicherheits-Policies, Caching, 90%+ Testabdeckung	Über 30 typisierte Tools (Tickets, Nutzer, Gruppen, Organisationen, System-Checks)
Community MCP-Skripte	Kurze, private Experimente und lokale Skripte	Minimale Abhängigkeiten, schnelle lokale Hacks	Nur grundlegende Lese-/Schreibvorgänge, keine Sicherheitskontrollen
Open Ticket AI Runtime	Vollautomatische, datenschutzkonforme On-Premise Automatisierung	Eigene trainierte KI-Modelle, 100% lokale Ausführung auf eigener Hardware, unbegrenzte Ticket-Klassifizierung	Vollständige Hintergrund-Automatisierung und Routing (Schnittstellen-Ebene)

Unser Zammad MCP-Server wurde speziell für professionelle und sicherheitsbewusste Teams entwickelt. Im Gegensatz zu einfachen Community-Skripten bietet er ein durchdachtes Sicherheitsmodell, deckt alle 9 zentralen Zammad-Ressourcen ab und schützt Ihre Instanz vor versehentlichen Datenlöschungen.

Voraussetzungen

Python 3.11+ oder uvx
Laufende Zammad-Instanz (6.0+; getestet mit 7.1)
Personal Access Token aus dem Zammad-Profil

Schritt 1 — API-Token anlegen

Profil öffnen

Benutzer-Icon unten links → Profile.

Zammad Profil über das Avatar-Menü öffnen.

Token Access

Token Access wählen → Create.

Zammad Token Access mit Create-Button.

Name und Berechtigungen

Namen vergeben (z. B. MCP_Cursor)
Optional Ablaufdatum
Mindestens ticket.agent und user_preferences aktivieren

Personal Access Token anlegen.

Token kopieren

Token nur einmal sichtbar — kopieren und als ZAMMAD_HTTP_TOKEN speichern.

Neuen Token vor dem Schließen des Dialogs kopieren.

Schritt 2 — MCP Server installieren

uvx zammad-mcp-server

Alternativ: pip install zammad-mcp-server

Schritt 3 — Claude oder Cursor verbinden

{
  "mcpServers": {
    "zammad": {
      "command": "uvx",
      "args": ["zammad-mcp-server"],
      "env": {
        "ZAMMAD_URL": "https://ihre-zammad-instanz.example.com",
        "ZAMMAD_HTTP_TOKEN": "ihr_token",
        "MCP_DENIED_TOOLS": "delete_ticket,delete_user,delete_organization"
      }
    }
  }
}

Test: „Führe health_check für Zammad aus.“

Details: Claude & Cursor · Konfiguration

Was Sie damit tun können — Beispiele

Tickets

Anfrage	Tool / Effekt
„Zeige meine offenen Tickets.“	`search_tickets`
„Fasse Ticket #12345 zusammen.“	Artikel lesen + Zusammenfassung
„Tickets zu VPN in Support.“	Suche mit Filter
„Interne Notiz zu Ticket 99.“	`create_article` (manuell prüfen)
„Statistik letzte Woche.“	`get_ticket_stats`

Nutzer und Organisationen

Kundendaten zu einem Ticket abrufen (get_user)
Nutzer und Organisationen suchen

Sicherheit

get_allowed_tools — welche Tools aktiv sind
Lösch-Tools per MCP_DENIED_TOOLS deaktivieren → Sicherheit

Vollständige Liste: Tools-Referenz

Beispiel-Ablauf (Cursor)

health_check — Verbindung OK
Offene Tickets in Gruppe Support listen
Langen Thread zusammenfassen für Eskalation
Antwortentwurf — ohne automatisches Senden an Kunden

Fehlerbehebung

Problem	Lösung
401 / 403	Token und Berechtigungen prüfen
Verbindungsfehler	`ZAMMAD_URL` mit `https://`, Erreichbarkeit testen
Tool fehlt	`MCP_DENIED_TOOLS` / `get_allowed_tools`

Weiterführend

Zammad MCP Server Doku
GitHub
Open Ticket AI für Zammad — individuelle KI-Modelle On-Prem

Kostenloser Open-Source-Beitrag (MIT) von Open Ticket AI. Implementierung und Beratung: softoft.de.