Zammad MCP Server für Zammad 7.1: Produktions-Setup mit Cursor und Claude

Der Traffic auf unsere Zammad-MCP-Server-Dokumentation wächst — zu Recht. Teams mit Zammad 7.1 wollen KI-Assistenten in Cursor oder Claude Desktop, ohne eine eigene REST-Integration zu bauen. Der Zammad MCP Server (zammad-mcp-server auf PyPI, MIT) ist genau diese Brücke: 30+ typisierte Tools, umgebungsgesteuerte Zugriffskontrolle und Kompatibilität mit Zammad 6.0 bis 7.1.3.

Dieser Leitfaden konzentriert sich auf Zammad 7.x und sicheres MCP in der Produktion.

Paket: zammad-mcp-server 0.1.1
Repository: github.com/Softoft-Orga/zammad-mcp-server
Erstinstallation: Setup-Anleitung für Claude und Cursor

Zammad 7.1 und der MCP-Server — das Wichtigste

Das MCP-Paket ist unabhängig von Zammad versioniert. Ein PyPI-Release spricht mit allen unterstützten Zammad-Versionen über die REST-API — kein Zammad-Plugin nötig.

Zammad-Version	Status	Hinweise
7.1.3	Getestet	Aktuell stabil (Aug 2026) — Sicherheitsupdates zeitnah einspielen
7.1.x	Getestet	Standard im Docker-Dev-Stack
7.0.x	Getestet	PostgreSQL erforderlich (MySQL ab 7.x nicht unterstützt)
6.5.x – 6.0	Kompatibel	Gleiche REST-API

Nach dem Verbinden: get_server_info ausführen lassen — bestätigt die erkannte Zammad-Version.

Zammad-7.1-Native-KI (Zusammenfassungen in der UI) und Zammad MCP lösen unterschiedliche Aufgaben. Native KI bleibt in der Agent-Oberfläche; MCP verbindet externe Clients. Vergleich: Zammad-7-KI-Funktionen. Für Routing und On-Prem-Modelle: Open Ticket AI für Zammad — alle drei können parallel laufen.

Schritt 1 — Zammad-API-Token anlegen (mit Screenshots)

Authentifizierung über Personal Access Token unter Profil → Token Access.

Zammad Token Access — Schaltfläche Create.

Für typischen Support mindestens aktivieren:

ticket.agent
user_preferences

Token einmal kopieren — Zammad zeigt ihn nicht erneut. Screenshots: Quick Start.

Als ZAMMAD_HTTP_TOKEN speichern. Nicht in Git committen.

Schritt 2 — Cursor oder Claude Desktop konfigurieren

MCP-Server in der Client-Konfiguration ergänzen:

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

Client neu starten, dann prüfen:

Führe health_check auf Zammad aus.

Details: Claude & Cursor einrichten.

Schritt 3 — Access Control für die Produktion

Häufigster Fehler: KI-Agenten sofort Delete-Tools geben. Least Privilege per Umgebungsvariablen — Referenz: Konfiguration.

Read-only Triage (empfohlen in Woche 1):

MCP_ALLOWED_CATEGORIES=tickets,search,system
MCP_DENIED_TOOLS=create_ticket,update_ticket,delete_ticket,create_article,delete_user,delete_organization

Support Lead (interne Notizen erlaubt, Deletes verboten):

MCP_ALLOWED_CATEGORIES=all
MCP_DENIED_TOOLS=delete_ticket,delete_user,delete_organization
MCP_ALLOWED_GROUPS=Support

Assistent fragen: “Rufe get_allowed_tools auf” — effektive Policy prüfen.

Schritt 4 — Workflows für den ersten Tag

Anfrage	MCP-Tools
”Offene Tickets in Support, neueste zuerst.”	`search_tickets`
”Ticket #1042 für Eskalation zusammenfassen.”	`get_ticket_articles`, `ticket_summary_prompt`
”Höfliche Verzögerungsantwort entwerfen — nicht posten.”	Prompts + menschliche Freigabe
”Wie viele Tickets letzte Woche geschlossen?”	`get_ticket_stats`

Kunden sichtbare Nachrichten weiterhin manuell aus Zammad senden.

Interner Admin-Chat: Zammad Commander.

Docker und Remote-MCP (optional)

Lokaler Dev-Stack: docker/ — Standard Zammad 7.1
Container: ghcr.io/softoft-orga/zammad-mcp-server
SSE: zammad-mcp-server --transport sse --port 8000 — nur vertrauenswürdige Netze

Siehe Deployment.

Fehlerbehebung auf Zammad 7.x

Problem	Lösung
401 / 403 bei `health_check`	Token neu erzeugen; ticket.agent und Gruppen prüfen
SSL / Proxy	`ZAMMAD_URL` mit `https://`, Erreichbarkeit vom MCP-Host
Tool fehlt nach Update	`MCP_DENIED_TOOLS` prüfen; `get_allowed_tools`
MySQL, Upgrade auf 7.x geplant	Zammad zuerst auf PostgreSQL migrieren

Weiterführend

Zammad MCP Server Dokumentation
Ursprüngliches Setup-Tutorial
Klassifikation auf eigener GPU? Open Ticket AI für Zammad — Full On-Prem nach Free Cloud Trial

Entwickelt von Open Ticket AI. Der Zammad MCP Server ist kostenlos und Open Source (MIT).