Freshservice MCP-Server

Freshservice MCP Server

Überblick

Eine leistungsstarke MCP-Serverimplementierung (Model Control Protocol), die sich nahtlos in Freshservice integriert. KI-Modelle können mit Freshservice-Modulen interagieren und verschiedene IT-Service-Management-Vorgänge durchführen. Diese Integrationsbrücke ermöglicht Ihren KI-Assistenten die Verwaltung und Lösung von IT-Servicetickets und optimiert so Ihren Support-Workflow.

Hauptmerkmale

Freshservice-Integration auf Unternehmensniveau : Direkte, sichere Kommunikation mit Freshservice-API-Endpunkten
Kompatibilität mit KI-Modellen : Ermöglicht Claude und anderen KI-Modellen die Ausführung von Service-Desk-Operationen über Freshservice
Automatisiertes ITSM-Management : Effiziente Abwicklung von Ticketerstellung, Aktualisierungen, Antworten und Asset-Management
Beschleunigung des Arbeitsablaufs : Reduzieren Sie manuelle Eingriffe bei routinemäßigen IT-Serviceaufgaben

Unterstützte Freshservice-Module

Dieser MCP-Server unterstützt derzeit Vorgänge für eine breite Palette von Freshservice-Modulen :

Tickets
Gespräche
Produkte
Anforderer
Agenten
Agentengruppen
Anforderergruppen
Vorgefertigte Antworten
Vorgefertigte Antwortordner
Arbeitsbereiche
Lösungskategorien
Lösungsordner
Lösungsartikel

Komponenten & Werkzeuge

Der Server bietet ein umfassendes Toolkit für Freshservice-Vorgänge:

Ticketverwaltung

Werkzeug	Beschreibung	Schlüsselparameter
`create_ticket`	Neue Servicetickets erstellen	`subject` , `description` , `source` , `priority` , `status` , `email`
`update_ticket`	Vorhandene Tickets aktualisieren	`ticket_id` , `updates`
`delete_ticket`	Tickets entfernen	`ticket_id`
`search_tickets`	Tickets finden, die den Kriterien entsprechen	`query`
`get_ticket_fields`	Abrufen von Ticketfelddefinitionen	Keiner
`get_tickets`	Alle Tickets mit Seitennummerierung auflisten	`page` , `per_page`
`get_ticket`	Abrufen einzelner Ticketdetails	`ticket_id`

Erste Schritte

Installation über Smithery

So installieren Sie freshservice_mcp automatisch über Smithery:

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

Voraussetzungen

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

Konfiguration

Generieren Sie Ihren Freshservice-API-Schlüssel im Admin-Bereich:
- Navigieren Sie zu Profileinstellungen → API-Einstellungen
- Kopieren Sie Ihren API-Schlüssel zur Konfiguration
Richten Sie Ihre Domäne und Authentifizierungsdetails wie unten gezeigt ein

Verwendung mit Claude Desktop

Installieren Sie Claude Desktop von der offiziellen Website
Fügen Sie Ihrer claude_desktop_config.json die folgende Konfiguration hinzu:

"mcpServers": {
  "freshservice-mcp": {
    "command": "uvx",
    "args": [
        "freshservice-mcp"
    ],
    "env": {
      "FRESHSERVICE_API_KEY": "<YOUR_FRESHSERVICE_API_KEY>",
      "FRESHSERVICE_DOMAIN": "<YOUR_FRESHSERVICE_DOMAIN>"
    }
  }
}

Wichtig : Ersetzen Sie <YOUR_FRESHSERVICE_API_KEY> durch Ihren tatsächlichen API-Schlüssel und <YOUR_FRESHSERVICE_DOMAIN> durch Ihre Domäne (z. B. yourcompany.freshservice.com ).

Beispieloperationen

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

„Erstellen Sie ein neues Incident-Ticket mit dem Betreff ‚Netzwerkverbindungsproblem in der Marketingabteilung‘ und der Beschreibung ‚Benutzer können im Marketingbereich keine Verbindung zum WLAN herstellen‘ und legen Sie die Priorität auf „Hoch“ fest.“
„Aktualisieren Sie den Status der Änderungsanforderung Nr. 45678 auf ‚Genehmigt‘.“
„Liste aller kritischen Vorfälle auf, die in den letzten 24 Stunden gemeldet wurden“
„Asset-Details für Laptop mit Asset-Tag ‚LT-2023-087‘ anzeigen“
„Erstellen Sie eine Änderungsanforderung für die geplante Serverwartung nächsten Dienstag um 2 Uhr morgens.“

Testen

Zu Testzwecken können Sie den Server manuell starten:

uvx freshservice-mcp --env FRESHSERVICE_API_KEY=<your_api_key> --env FRESHSERVICE_DOMAIN=<your_domain>

Fehlerbehebung

Überprüfen Sie, ob Ihr Freshservice-API-Schlüssel und Ihre Domäne korrekt sind
Stellen Sie eine ordnungsgemäße Netzwerkverbindung zu den Freshservice-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.

Freshservice MCP server