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).

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

Schritt 3 — Name und Berechtigungen
Im Dialog Add a Personal Access Token:
- Einen Namen vergeben (z. B.
MCP_TOKENoderCursor Zammad). - Optional ein Ablaufdatum setzen.
- 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).

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.

Installation
uvx zammad-mcp-serverAlternativ: pip install zammad-mcp-server oder uv tool install zammad-mcp-server.
Konfiguration
ZAMMAD_URL=https://ihre-zammad-instanz.example.comZAMMAD_HTTP_TOKEN=ihr_api_token
MCP_DENIED_TOOLS=delete_ticket,delete_user,delete_organizationServer starten
zammad-mcp-serverStandard: stdio — der MCP-Client startet den Prozess.
Test im MCP-Client
Nach Claude- oder Cursor-Einrichtung:
Führe
health_checkfür Zammad aus.
Weitere Einstiegs-Prompts:
- „Suche Tickets mit
state.name:open AND group.name:Support.” - „Fasse Ticket 12345 mit
summarize_ticketzusammen.” - „Rufe
get_allowed_toolsauf.”
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 8000MCP-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 8000Nur 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.
git clone https://github.com/openticketai/zammad-mcp-server.gitcd zammad-mcp-server/examples/librechatcp env.example .envIn .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.
docker compose uphttp://localhost:3080 öffnen, ein Konto anlegen, OpenRouter wählen und fragen: Führe health_check für Zammad aus.
Bereits von PyPI installiert:
uvx zammad-mcp-server init librechatcd librechatcp env.example .envdocker compose upMit Open WebUI testen
Dieselben drei Werte. Open WebUI ab v0.6.31 spricht Streamable HTTP.
cd zammad-mcp-server/examples/open-webuicp env.example .envDieselben drei Variablen setzen, dann:
docker compose uphttp://localhost:3000 öffnen. Das erste Konto ist der Admin. Im Chat das Werkzeug Zammad einschalten und nach health_check fragen.
uvx zammad-mcp-server init open-webuicd open-webuicp env.example .envdocker compose upFehlt das Werkzeug: Settings → Integrations → External Tool Servers → Add. Typ MCP (Streamable HTTP), URL http://zammad-mcp:8000/mcp/, Auth None.
