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+; aktuelle Linie 7.2.2, 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 user docs).

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

Bash
uvx zammad-mcp-server

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

Konfiguration

Env
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

Bash
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:

Bash
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):

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

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

Mit LibreChat testen

Das Paket enthält einen Compose-Stack: LibreChat, MongoDB und dieser MCP-Server. Sie brauchen Docker, eine Zammad-URL, ein API-Token und einen OpenRouter-Schlüssel.

Bash
git clone https://github.com/openticketai/zammad-mcp-server.git
cd zammad-mcp-server/examples/librechat
cp env.example .env

In .env setzen Sie ZAMMAD_URL, ZAMMAD_HTTP_TOKEN und OPENROUTER_API_KEY. Läuft Zammad als Dev-Stack auf diesem Rechner (docker/ im Repo, Port 8080), verwenden Sie http://host.docker.internal:8080.

Bash
docker compose up

http://localhost:3080 öffnen, ein Konto anlegen, OpenRouter wählen und fragen: Führe health_check für Zammad aus.

Bereits von PyPI installiert:

Bash
uvx zammad-mcp-server init librechat
cd librechat
cp env.example .env
docker compose up

Mit Open WebUI testen

Dieselben drei Werte. Open WebUI ab v0.6.31 spricht Streamable HTTP.

Bash
cd zammad-mcp-server/examples/open-webui
cp env.example .env

Dieselben drei Variablen setzen, dann:

Bash
docker compose up

http://localhost:3000 öffnen. Das erste Konto ist der Admin. Im Chat das Werkzeug Zammad einschalten und nach health_check fragen.

Bash
uvx zammad-mcp-server init open-webui
cd open-webui
cp env.example .env
docker compose up

Fehlt das Werkzeug: Settings → Integrations → External Tool Servers → Add. Typ MCP (Streamable HTTP), URL http://zammad-mcp:8000/mcp/, Auth None.

Weiter