Zammad MCP Server: Open-Source-Setup für Claude und Cursor

Installieren und nutzen Sie den Open-Source Zammad MCP Server für Claude, Cursor und MCP-Clients mit typisierten Ticket-Tools, Zugriffsschutz und Zammad API-Token.

Zammad MCP Server

Der Zammad MCP Server ist ein kostenloser, Open-Source-Model Context Protocol (MCP)-Server für Zammad. Er verbindet Claude Desktop, Cursor und andere MCP-Clients mit Ihrem Zammad-Helpdesk, damit KI-Agenten Tickets suchen, Konversationen zusammenfassen, Antwortentwürfe erstellen und Nutzer, Organisationen, Gruppen sowie Systemdaten über typisierte Tools auslesen können.

Diese Seite ist der zentrale Einstieg für den Zammad MCP Server. Nutzen Sie sie, wenn Sie zammad-mcp-server installieren, Claude oder Cursor anbinden, Zammad MCP mit nativer Zammad-KI vergleichen oder prüfen möchten, ob MCP die passende Integrationsschicht für Ihre Helpdesk-Automatisierung ist.

Lizenz: MIT
Paket: zammad-mcp-server auf PyPI
Quellcode: github.com/Softoft-Orga/zammad-mcp-server
Hauptanwendungsfall: externe KI-Assistenten arbeiten über die Zammad REST API mit Zammad
Zammad-Kompatibilität: 6.0+ über REST API — siehe Matrix unten

Zammad-Versionskompatibilität

Das MCP-Paket (zammad-mcp-server) ist unabhängig von Zammad versioniert. Ein PyPI-Release funktioniert mit allen Zeilen in der Tabelle; ZAMMAD_URL zeigt auf Ihre Instanz.

Zammad	Status	Hinweise
7.1	Getestet (primär)	Standard im gebündelten Docker-Dev-Stack
7.0	Getestet	PostgreSQL auf Zammad-Seite erforderlich
6.5.x	Kompatibel	Letzte 6.x-Linie
6.0 – 6.4.x	Kompatibel	Unterstützte Mindestversion
< 6.0	Nicht unterstützt

Lokaler Dev-Stack: Repository zammad-mcp-server/docker, .env.example → .env, ZAMMAD_VERSION setzen (7.1, 7.0, 6.5 oder 6.3). Details: COMPATIBILITY.md auf GitHub.

Nach health_check liefert get_server_info die verbundene Zammad-Version.

Für wen ist das gedacht?

Rolle	Typischer Nutzen
Zammad-Admins	KI auf Tickets testen ohne eigene API-Integration
Support-Leitung	Schnellere Suche, Zusammenfassungen, Antwortentwürfe via Claude/Cursor
KI-/Automatisierungs-Teams	Standard-MCP statt Einmal-Skripte
Berater	Wiederholbares Zammad-+-MCP-Setup beim Kunden

Zammad MCP Server installieren

Für lokale MCP-Clients ist uvx meist der schnellste Weg:

uvx zammad-mcp-server

Alternativ installieren Sie den Server dauerhaft:

pip install zammad-mcp-server
uv tool install zammad-mcp-server

Der Server benötigt eine Zammad-URL und einen Personal Access Token. Starten Sie mit dem Schnellstart für Screenshots des Token-Flows in Zammad und binden Sie den Server anschließend in Claude Desktop oder Cursor ein.

Einordnung in die Zammad-KI-Landschaft

Zammad 7.1 native KI — Zusammenfassungen und Schreibassistent in der Zammad-Oberfläche.
Zammad MCP Server (dieses Projekt) — verbindet externe MCP-Clients (Claude Desktop, Cursor, eigene Agenten) mit Zammad.
Open Ticket AI Runtime — On-Prem-Inferenz mit eigen trainierten Modellen über das OTAI-Zammad-Plugin (Integrationsleitfaden).

Alle drei können parallel genutzt werden. MCP ist der schnellste Weg: „Mit Claude über mein Helpdesk sprechen.“

Was Sie mit Zammad MCP tun können

Der Zammad MCP Server stellt Zammad als strukturierte Tools bereit, statt dass Sie rohe REST-Aufrufe schreiben müssen. Typische Workflows sind:

Workflow	MCP-Funktion
Offene Tickets triagieren	Tickets nach Status, Gruppe, Kunde, Priorität oder Suchbegriff finden
Lange Verläufe zusammenfassen	Ticket-Artikel laden und den eingebauten Summary-Prompt nutzen
Support-Antworten entwerfen	Kundenkommunikation vorbereiten, bevor ein Mensch sie prüft
Kundenkontext auslesen	Nutzer und Organisationen zu einem Ticket nachschlagen
Agentenrechte prüfen	Aktivierte Tools anzeigen und destruktive Aktionen per Env-Variable sperren
Systemstatus testen	`health_check` ausführen und die verbundene Zammad-Version prüfen

Dokumentation

Seite	Inhalt
Schnellstart	Installation und `health_check`
Claude & Cursor	MCP-Client-Konfiguration
Konfiguration	Umgebungsvariablen und Rechte
Tools-Referenz	Alle MCP-Tools
Sicherheit	Token, Least Privilege, Checkliste
Deployment	Docker, SSE, Produktion

Zammad MCP Server im Vergleich

Option	Geeignet für	Unterschied
Zammad MCP Server	Teams, die Claude, Cursor oder eigene Agenten mit Zammad verbinden möchten	Externe MCP-Clients, typisierte Tools, Zugriffskontrolle per API-Token
Zammad 7.1 native KI	Teams, die KI direkt in der Zammad-Oberfläche nutzen möchten	In Zammad integriert, aber keine allgemeine MCP-Brücke für externe Agenten
Eigene REST-Skripte	Einzelne interne Automatisierungen	Flexibel, aber Auth, Datenmodelle, Fehlerbehandlung und Sicherheit bleiben Eigenaufwand
Open Ticket AI Runtime	Produktive Ticket-Klassifizierung und Routing mit privaten Modellen	Hintergrundautomatisierung mit trainierten Modellen, kein interaktiver MCP-Client

Wählen Sie den Zammad MCP Server, wenn die Absicht lautet: “Meinen KI-Assistenten jetzt mit Zammad verbinden.” Wählen Sie Open Ticket AI Runtime, wenn Sie autonome Queue-Zuordnung, Klassifizierung oder eigene Modelle auf historischen Ticketdaten benötigen.

FAQ

Ist der Zammad MCP Server Open Source?

Ja. Der Server ist MIT-lizenziert, als zammad-mcp-server auf PyPI veröffentlicht und der Quellcode liegt auf GitHub.

Funktioniert er mit Claude Desktop und Cursor?

Ja. Claude Desktop und Cursor können den Zammad MCP Server mit uvx zammad-mcp-server starten und ZAMMAD_URL sowie ZAMMAD_HTTP_TOKEN über die MCP-Konfiguration übergeben.

Brauche ich Admin-Rechte in Zammad?

Nicht für jeden Workflow. Für typische Support-Abläufe reicht ein Personal Access Token mit Ticket-Rechten. Admin-Tools benötigen passende Zammad-Berechtigungen und sollten eng begrenzt sein.

Kann der MCP Server Tickets löschen?

Destruktive Tools können über MCP_DENIED_TOOLS gesperrt werden. Für produktive und gemeinsam genutzte Assistenten sollten Löschaktionen deaktiviert bleiben, solange kein klarer Review-Prozess existiert.

Welche Zammad-Versionen werden unterstützt?

Siehe die Kompatibilitätsmatrix auf GitHub. Kurz: 6.0+ wird unterstützt; 7.0 und 7.1 sind getestet. Der Dev-Stack standardmäßig 7.1; über ZAMMAD_VERSION in docker/.env auch 7.0, 6.5 oder 6.3.

Ist das dasselbe wie die native Zammad-KI?

Nein. Native Zammad-KI läuft in der Zammad-Oberfläche. Der Zammad MCP Server ist eine Integrationsschicht für externe MCP-Clients wie Claude, Cursor und eigene Agenten.

Mehr erfahren

Tutorial: Zammad MCP Server — Einrichtung und Nutzung (Blog)
Repository: Softoft-Orga/zammad-mcp-server
Paket: zammad-mcp-server auf PyPI

Nächste Schritte

Schnellstart durchgehen.
Sicherheit vor Team-Rollout prüfen.
Individuelle Modelle auf Ihren Warteschlangen? Open Ticket AI für Zammad.