Zendesk MCP Server

Einrichtungshandbuch für die Zendesk MCP-Integration

Repository-Einrichtung

1. Klonen Sie das Repository:
   git clone https://your-repo-url/mcp-experiments.git cd mcp-experiments/zd-mcp-server
2. Installieren Sie Abhängigkeiten:
   npm install
3. Konfigurieren Sie Umgebungsvariablen in Ihrer Entwicklungsumgebung:
   export ZENDESK_EMAIL="your-email@example.com" export ZENDESK_TOKEN="your-zendesk-api-token" export ZENDESK_SUBDOMAIN="your-zendesk-subdomain"

Erstellen des Projekts

1. Erstellen Sie das TypeScript-Projekt:
   npm run build
   Dadurch werden die TypeScript-Dateien im Verzeichnis dist in JavaScript kompiliert.
2. Für die Entwicklung können Sie Folgendes verwenden:
   npm run dev

Installation mit der Claude Desktop App

1. Aktualisieren Sie die Claude Desktop-Konfigurationsdatei ( claude_desktop_config.json ):
   { "tools": { "zendesk": { "command": "node", "env": { "ZENDESK_EMAIL": "internal@z3nmail.com", "ZENDESK_TOKEN": "your-zendesk-api-token", "ZENDESK_SUBDOMAIN": "your-zendesk-subdomain" }, "args": [ "/path/to/mcp-experiments/zd-mcp-server/dist/index.js" ] } } }
2. Ersetzen Sie die Umgebungsvariablen durch Ihre tatsächlichen Zendesk-Anmeldeinformationen.
3. Aktualisieren Sie den Pfad, sodass er mit dem Speicherort Ihrer erstellten index.js-Datei übereinstimmt.
4. Starten Sie die Claude Desktop-Anwendung neu, damit die Änderungen wirksam werden.

Verfügbare Zendesk-Tools

Die MCP Zendesk-Integration bietet die folgenden Funktionen:

1. zendesk_get_ticket – Ruft ein Ticket anhand der ID ab
2. zendesk_get_ticket_details – Ruft Ticketdetails einschließlich Kommentare ab
3. zendesk_search – Durchsucht Tickets mit der Zendesk-Abfragesyntax
4. zendesk_create_ticket – Erstellt ein neues Ticket
5. zendesk_update_ticket – Aktualisiert Ticketeigenschaften
6. zendesk_add_private_note – Fügt einem Ticket eine interne Notiz hinzu
7. zendesk_add_public_note – Fügt einem Ticket einen öffentlichen Kommentar hinzu
8. zendesk_get_linked_incidents – Ruft alle Vorfalltickets ab, die mit einem bestimmten Ticket verknüpft sind

Authentifizierungs-Setup

1. Generieren Sie ein API-Token in Ihrem Zendesk Admin Center:
   • Gehen Sie zu Admin Center > Apps und Integrationen > APIs > Zendesk API
   • Fügen Sie ein API-Token hinzu und kopieren Sie es
2. Verwenden Sie Ihre E-Mail-Adresse und das API-Token in Ihrer MCP-Konfiguration

Fehlerbehebung

• Wenn Autorisierungsfehler auftreten, überprüfen Sie, ob Ihr API-Token gültig ist
• Stellen Sie sicher, dass Ihre Zendesk-Subdomäne korrekt ist
• Überprüfen Sie, ob die Umgebungsvariablen richtig eingestellt sind
• Starten Sie den MCP-Server neu, nachdem Sie Änderungen vorgenommen haben