Freshdesk MCP server

Freshdesk MCP-Server

Eine MCP-Serverimplementierung, die in Freshdesk integriert ist und es KI-Modellen ermöglicht, mit Freshdesk-Modulen zu interagieren und verschiedene Supportvorgänge auszuführen.

Merkmale

• Freshdesk-Integration : Nahtlose Interaktion mit Freshdesk-API-Endpunkten
• KI-Modell-Support : Ermöglicht KI-Modellen, Supportvorgänge über Freshdesk durchzuführen
• Automatisiertes Ticketmanagement : Verwalten Sie Ticketerstellung, -aktualisierungen und -antworten

Komponenten

Werkzeuge

Der Server bietet mehrere Tools für Freshdesk-Vorgänge:

• create_ticket : Neue Support-Tickets erstellen
  • Eingänge :
    • subject (Zeichenfolge, erforderlich): Ticketbetreff
    • description (Zeichenfolge, erforderlich): Ticketbeschreibung
    • source (Nummer, erforderlich): Ticket-Quellcode
    • priority (Zahl, erforderlich): Ticketprioritätsstufe
    • status (Zahl, erforderlich): Ticket-Statuscode
    • email (Zeichenfolge, optional): E-Mail des Anforderers
    • requester_id (Zahl, optional): ID des Anforderers
    • custom_fields (Objekt, optional): Benutzerdefinierte Felder, die im Ticket festgelegt werden sollen
• update_ticket : Vorhandene Tickets aktualisieren
  • Eingänge :
    • ticket_id (Nummer, erforderlich): ID des zu aktualisierenden Tickets
    • updates (Objekt, erforderlich): Zu aktualisierende Felder
• delete_ticket : Ein Ticket löschen
  • Eingänge :
    • ticket_id (Nummer, erforderlich): ID des zu löschenden Tickets
• search_tickets : Suche nach Tickets basierend auf Kriterien
  • Eingänge :
    • query (Zeichenfolge, erforderlich): Suchabfragezeichenfolge
• get_ticket_fields : Alle Ticketfelder abrufen
  • Eingänge :
    • Keiner
• get_tickets : Alle Tickets abrufen
  • Eingänge :
    • page (Nummer, optional): Zu holende Seitennummer
    • per_page (Zahl, optional): Anzahl der Tickets pro Seite
• get_ticket : Holen Sie sich ein Einzelticket
  • Eingänge :
    • ticket_id (Nummer, erforderlich): ID des abzurufenden Tickets

Erste Schritte

Installation über Smithery

So installieren Sie freshdesk_mcp für Claude Desktop automatisch über Smithery :

Voraussetzungen

• Ein Freshdesk-Konto (Registrierung unter freshdesk.com )
• Freshdesk API-Schlüssel
• uvx installiert ( pip install uv oder brew install uv )

Konfiguration

1. Generieren Sie Ihren Freshdesk-API-Schlüssel über das Freshdesk-Administrationsbereich
2. Richten Sie Ihre Domäne und Authentifizierungsdetails ein

Verwendung mit Claude Desktop

1. Installieren Sie Claude Desktop, falls noch nicht geschehen
2. Fügen Sie Ihrer claude_desktop_config.json die folgende Konfiguration hinzu:

Wichtige Hinweise :

• Ersetzen Sie YOUR_FRESHDESK_API_KEY durch Ihren tatsächlichen Freshdesk-API-Schlüssel
• Ersetzen Sie YOUR_FRESHDESK_DOMAIN durch Ihre Freshdesk-Domäne (z. B. yourcompany.freshdesk.com ).

Beispieloperationen

Nach der Konfiguration können Sie Claude bitten, folgende Vorgänge auszuführen:

• „Erstellen Sie ein neues Ticket mit dem Betreff ‚Zahlungsproblem für Kunde A101‘ und der Beschreibung ‚Kontaktaufnahme wegen eines Zahlungsproblems im letzten Monat für Kunde A101‘, wobei die Kunden-E-Mail-Adresse a101@acme.com lautet und die Priorität auf ‚hoch‘ eingestellt ist.“
• „Aktualisieren Sie den Status des Tickets Nr. 12345 auf ‚Gelöst‘.“
• „Listen Sie alle Tickets mit hoher Priorität auf, die dem Agenten John Doe zugewiesen sind.“
• „Liste der vorherigen Tickets des Kunden A101 in den letzten 30 Tagen auf“

Testen

Zu Testzwecken können Sie den Server manuell starten:

Fehlerbehebung

• Überprüfen Sie, ob Ihr Freshdesk-API-Schlüssel und Ihre Domäne korrekt sind.
• Stellen Sie eine ordnungsgemäße Netzwerkverbindung zu Freshdesk-Servern sicher
• Überprüfen Sie API-Ratenbegrenzungen und -Kontingente
• Überprüfen Sie, ob der Befehl uvx in Ihrem PATH verfügbar ist

Lizenz

Dieser MCP-Server ist unter der MIT-Lizenz lizenziert. Weitere Informationen finden Sie in der LICENSE-Datei im Projekt-Repository.