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:

  1. Zammad Personal Access Token — Quick Start mit Screenshots
  2. Zammad-Basis-URL (https://helpdesk.example.com)

Cursor — Schritt für Schritt

  1. Cursor-Einstellungen (Zahnrad) → MCP
  2. MCP-Server hinzufügen oder JSON-Konfiguration bearbeiten
  3. Konfiguration unten einfügen — ZAMMAD_URL und ZAMMAD_HTTP_TOKEN ersetzen
  4. Speichern und MCP neu laden (oder Cursor neu starten)
  5. Im Chat: „Führe health_check auf 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)

SchrittAktion in Zammad
1Profil → Token Access → Create
2Name, ticket.agent (+ user_preferences)
3Secret einmal kopieren

Details: Quick Start Schritte 1–4.

Claude Desktop

SystemPfad
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-VersionMCP
7.1.3Getestet — Sicherheitsupdates einspielen
7.1.x / 7.0.xGetestet; PostgreSQL auf Zammad-Seite
6.5.x – 6.0Kompatibel

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

SymptomLösung
MCP erscheint nicht in CursorCursor neu starten; JSON prüfen
401 / 403Token neu; ticket.agent prüfen
VerbindungsfehlerZAMMAD_URL mit https://
Tool fehltMCP_DENIED_TOOLS; get_allowed_tools

Hinweise