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 7 native KI — KI in der Zammad-Oberfläche
• Zammad MCP — externe Assistenten (Claude, Cursor)
• Open Ticket AI — eigene trainierte Modelle On-Prem

---

Voraussetzungen

• Python 3.11+ oder uvx
• Laufende Zammad-Instanz
• Personal Access Token aus dem Zammad-Profil

---

Schritt 1 — API-Token anlegen

Profil öffnen

Benutzer-Icon unten links → Profile.

Token Access

Token Access wählen → Create.

Name und Berechtigungen

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

Token kopieren

Token nur einmal sichtbar — kopieren und als ZAMMAD_HTTP_TOKEN speichern.

---

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)

1. health_check — Verbindung OK
2. Offene Tickets in Gruppe Support listen
3. Langen Thread zusammenfassen für Eskalation
4. 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.