Company logoOpen Ticket AI

Zammad MCP Server — Schnellstart

Zammad MCP Server installieren und mit health_check in wenigen Minuten testen.

Schnellstart

Voraussetzungen

  • Python 3.11+ oder uvx
  • Laufende Zammad-Instanz (6.0+; getestet mit 7.1)
  • HTTP-API-Token (siehe unten)

Zammad API-Token anlegen

Der MCP-Server nutzt einen Personal Access Token aus Ihrem Zammad-Profil. Offizielle Referenz: Token access (Zammad Admin-Doku).

Schritt 1 — Profil öffnen

Klicken Sie unten links auf Ihr Benutzer-Icon, dann auf Profile (Profil).

Zammad-Benutzermenü — Profil über das Avatar-Menü unten links öffnen.

Schritt 2 — Token Access öffnen

In der Profil-Navigation Token Access (Token-Zugang) wählen. Unter Add a Personal Access Token auf Create klicken.

Zammad Profil — Seite Token Access mit der Schaltfläche Create für einen neuen Token.

Schritt 3 — Name und Berechtigungen

Im Dialog Add a Personal Access Token:

  1. Einen Namen vergeben (z. B. MCP_TOKEN oder Cursor Zammad).
  2. Optional ein Ablaufdatum setzen.
  3. Die benötigten Berechtigungen aktivieren. Für typische Ticket- und Nutzer-Workflows mindestens:
    • ticket.agent
    • user_preferences

Weitere Scopes nur bei Bedarf ergänzen (z. B. wenn ein MCP-Tool „access denied“ meldet).

Personal Access Token anlegen — Name, optional Ablauf, Berechtigungen per Checkbox.

Schritt 4 — Token einmalig kopieren

Der Token wird nur einmal angezeigt. Sofort kopieren (Kopieren-Button), sicher speichern oder in die MCP-env-Konfiguration eintragen, dann OK, I’ve copied my token bestätigen.

Den Wert im nächsten Abschnitt als ZAMMAD_HTTP_TOKEN verwenden. Bei Verlust: Token löschen und neu anlegen.

Neuer Personal Access Token — Token-String vor dem Schließen des Dialogs kopieren.

Installation

uvx zammad-mcp-server

Alternativ: pip install zammad-mcp-server oder uv tool install zammad-mcp-server.

Konfiguration

ZAMMAD_URL=https://ihre-zammad-instanz.example.com
ZAMMAD_HTTP_TOKEN=ihr_api_token

MCP_DENIED_TOOLS=delete_ticket,delete_user,delete_organization

Server starten

zammad-mcp-server

Standard: stdio — der MCP-Client startet den Prozess.

Test im MCP-Client

Nach Claude- oder Cursor-Einrichtung:

Führe health_check für Zammad aus.

Weitere Einstiegs-Prompts:

  • „Suche Tickets mit state.name:open AND group.name:Support.”
  • „Fasse Ticket 12345 mit summarize_ticket zusammen.”
  • „Rufe get_allowed_tools auf.”

HTTP (optional, Remote-MCP)

Version 0.2.0 nutzt im Docker-Image standardmäßig Streamable HTTP:

zammad-mcp-server --transport http --host 0.0.0.0 --port 8000

MCP-Pfad: /mcp/. Es gibt keine /health-Route — Port 8000 muss erreichbar sein.

Legacy SSE (ältere MCP-Clients):

zammad-mcp-server --transport sse --host 0.0.0.0 --port 8000

Nur in vertrauenswürdigen Netzen. Siehe Deployment und Agent-Workflows.

Weiter