Zammad MCP Server — Claude & Cursor
MCP-Server für Claude Desktop und Cursor konfigurieren — inkl. Verweis auf Token-Screenshots.
Claude & Cursor einrichten
Claude Desktop und Cursor starten den MCP-Server als lokalen Prozess (stdio). Voraussetzungen:
- Zammad Personal Access Token — Quick Start mit Screenshots
- Zammad-Basis-URL (
https://helpdesk.example.com)
Cursor — Schritt für Schritt
- Cursor-Einstellungen (Zahnrad) → MCP
- MCP-Server hinzufügen oder JSON-Konfiguration bearbeiten
- Konfiguration unten einfügen —
ZAMMAD_URLundZAMMAD_HTTP_TOKENersetzen - Speichern und MCP neu laden (oder Cursor neu starten)
- Im Chat: „Führe
health_checkauf Zammad aus.“
{
"mcpServers": {
"zammad": {
"command": "uvx",
"args": ["zammad-mcp-server==0.2.0"],
"env": {
"ZAMMAD_URL": "https://ihre-zammad-instanz.example.com",
"ZAMMAD_HTTP_TOKEN": "ihr_token",
"MCP_DENIED_TOOLS": "delete_ticket,delete_user,delete_organization"
}
}
}
}
Token-Screenshots (gleicher Token für Cursor)
| Schritt | Aktion in Zammad |
|---|---|
| 1 | Profil → Token Access → Create |
| 2 | Name, ticket.agent (+ user_preferences) |
| 3 | Secret einmal kopieren |
Details: Quick Start Schritte 1–4.
Claude Desktop
| System | Pfad |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
Gleiche JSON-Struktur wie oben. Claude Desktop nach dem Speichern neu starten.
Zammad 7.1.x
| Zammad-Version | MCP |
|---|---|
| 7.1.3 | Getestet — Sicherheitsupdates einspielen |
| 7.1.x / 7.0.x | Getestet; PostgreSQL auf Zammad-Seite |
| 6.5.x – 6.0 | Kompatibel |
get_server_info bestätigt die erkannte Zammad-Version.
Lokales Zammad (Docker)
"env": {
"ZAMMAD_URL": "http://localhost:8080",
"ZAMMAD_HTTP_TOKEN": "dev_token"
}
Siehe docker-compose im GitHub-Repo.
Fehlerbehebung
| Symptom | Lösung |
|---|---|
| MCP erscheint nicht in Cursor | Cursor neu starten; JSON prüfen |
| 401 / 403 | Token neu; ticket.agent prüfen |
| Verbindungsfehler | ZAMMAD_URL mit https:// |
| Tool fehlt | MCP_DENIED_TOOLS; get_allowed_tools |
Hinweise
- Keine Tokens in Git committen.
- Konfiguration — Policy-Rezepte
- Sicherheit vor Team-Rollout
