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

Related MCP server: mcp-jira-server

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 :

npx -y @smithery/cli install @effytech/freshdesk_mcp --client claude

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:

"mcpServers": {
  "freshdesk-mcp": {
    "command": "uvx",
    "args": [
        "freshdesk-mcp"
    ],
    "env": {
      "FRESHDESK_API_KEY": "<YOUR_FRESHDESK_API_KEY>",
      "FRESHDESK_DOMAIN": "<YOUR_FRESHDESK_DOMAIN>"
    }
  }
}

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:

uvx freshdesk-mcp --env FRESHDESK_API_KEY=<your_api_key> --env FRESHDESK_DOMAIN=<your_domain>

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.