Zammad MCP Server — Tools-Referenz

Übersicht aller MCP-Tools, Prompts und Ressourcen des Zammad MCP Servers (Version 0.2.0).

Tools-Referenz

Tools sind nach Bereich gruppiert. Namen entsprechen der MCP-Client-Anzeige. Berechtigungen folgen der Konfiguration — Delete-Tools sind in Agent-Setups oft gesperrt.

System

Tool	Beschreibung
`health_check`	Zammad-API-Erreichbarkeit prüfen
`get_server_info`	Zammad-Version und Server-Metadaten
`get_allowed_tools`	Erlaubte Tools unter aktueller Policy

Tickets

Tool	Beschreibung
`get_ticket`	Ticket-Details per ID
`search_tickets`	Suche mit Filtern (Status, Gruppe, Query, …)
`create_ticket`	Neues Ticket anlegen
`update_ticket`	Titel, Status, Priorität, Gruppe, Owner ändern
`delete_ticket`	Ticket löschen (Admin, meist gesperrt)
`get_ticket_articles`	Nachrichten / Artikel eines Tickets
`create_article`	Kundennotiz, Agent-Antwort oder interne Notiz
`get_ticket_stats`	Aggregierte Metriken für einen Zeitraum
`get_ticket_states`	Verfügbare Ticket-Status
`get_priorities`	Prioritätsstufen
`list_ticket_tags`	Tags eines Tickets
`add_ticket_tag`	Tag hinzufügen
`remove_ticket_tag`	Tag entfernen
`get_article_attachment`	Anhang laden (Base64 oder Text)
`link_tickets`	Zwei Tickets verknüpfen
`merge_tickets`	Quell-Ticket in Ziel mergen (Admin)
`summarize_ticket`	Plaintext-Verlauf, Tags, letzte Kunden-/Agent-Nachricht

Nutzer

Tool	Beschreibung
`get_user`	Nutzerprofil per ID
`search_users`	Nutzer per Query finden
`create_user`	Nutzer anlegen
`update_user`	Nutzerfelder ändern
`delete_user`	Nutzer löschen (Admin, meist gesperrt)
`get_current_user`	Authentifizierter API-Nutzer

Organisationen

Tool	Beschreibung
`get_organization`	Organisation per ID
`search_organizations`	Organisationen suchen
`create_organization`	Organisation anlegen
`update_organization`	Organisation ändern
`delete_organization`	Organisation löschen (Admin, meist gesperrt)

Gruppen

Tool	Beschreibung
`get_group`	Gruppe per ID
`list_groups`	Alle für den Token sichtbaren Gruppen
`create_group`	Gruppe anlegen (wenn erlaubt)

Tags (Katalog)

Tool	Beschreibung
`list_tags`	Admin-Tag-Katalog

MCP-Prompts (eingebaut)

Prompt	Zweck
`ticket_summary_prompt`	Strukturierte Ticket-Zusammenfassung
`customer_communication_prompt`	Professioneller Kundentext
`escalation_analysis_prompt`	Eskalations- / Überfälligkeitsanalyse
`analyze_ticket`	Historie, Tags und SLA-Hinweise
`draft_response`	Lokalisierter interner oder öffentlicher Entwurf
`triage_queue`	Offene Tickets einer Gruppe priorisieren
`escalation_summary`	Pending-close / überfällige Tickets

MCP-Ressourcen

URI-Muster	Inhalt
`zammad://ticket/{id}`	Ticket-Snapshot für Kontext
`zammad://user/{id}`	Nutzer-Snapshot
`zammad://config/states`	Ticket-Status-Referenz
`zammad://config/priorities`	Prioritäten-Referenz
`zammad://organization/{id}`	Organisations-Snapshot

Beispiele

Such-Syntax

search_tickets akzeptiert Zammad-Suchsyntax:

state.name:open AND group.name:Support
priority.name:3 high AND owner.email:agent@example.com
customer.email:jane@example.com

Tag nach Suche

search_tickets → id wählen
add_ticket_tag(ticket_id, "escalated")
summarize_ticket(ticket_id) vor der Antwort

Siehe Agent-Workflows für End-to-End-Prompts.

Anhang-Upload

Beim Anlegen eines Artikels mit Anhängen pro Element:

{
  "filename": "notes.txt",
  "data": "<base64-kodierte Bytes>",
  "mime_type": "text/plain"
}

Berechtigungen

Tool	Mindest-Berechtigung
`summarize_ticket`	READ
`add_ticket_tag`	WRITE
`link_tickets`	WRITE
`merge_tickets`	ADMIN
`delete_ticket`	ADMIN (meist gesperrt)

API-Details: Zammad API. Implementierung: server.py auf GitHub.