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