freshservice-mcp

Ein MCP-Server (Model Context Protocol), der KI-Assistenten mit Ihrer Freshservice ITSM-Instanz verbindet. Verwalten Sie Tickets, Assets, Änderungen, Probleme, den Servicekatalog, die Wissensdatenbank und mehr mittels natürlicher Sprache.

Funktionen

53 Tools in 9 Kategorien:

Kategorie	Tools	Beschreibung
Tickets	9	Auflisten, abrufen, erstellen, aktualisieren, löschen, antworten, Notizen hinzufügen, Konversationen, suchen
Assets	5	Auflisten, abrufen, erstellen, aktualisieren, löschen
Personen	8	Anfragende, Agenten, Gruppen, Abteilungen (auflisten + abrufen)
Ticket-Aufgaben	5	Unteraufgaben für Tickets auflisten, abrufen, erstellen, aktualisieren, löschen
Zeiteinträge	4	Zeitprotokolle auflisten, erstellen, aktualisieren, löschen
Änderungen	5	Änderungsanfragen auflisten, abrufen, erstellen, aktualisieren, löschen
Probleme	5	Problem-Datensätze auflisten, abrufen, erstellen, aktualisieren, löschen
Servicekatalog	3	Katalogelemente durchsuchen, Details abrufen, Serviceanfragen stellen
Wissensdatenbank	9	Kategorien, Ordner, Artikel (vollständiges CRUD)

Schnellstart

Voraussetzungen

Node.js 18+
Ein Freshservice-Konto mit API-Zugriff
Ihr Freshservice-API-Schlüssel (Profilsymbol > Profileinstellungen > API-Schlüssel im rechten Bereich)

Installation via npx (empfohlen)

Keine Installation erforderlich. Konfigurieren Sie Ihren MCP-Client für die Ausführung von:

{
  "mcpServers": {
    "freshservice": {
      "command": "npx",
      "args": ["-y", "freshservice-mcp"],
      "env": {
        "FRESHSERVICE_DOMAIN": "yourcompany",
        "FRESHSERVICE_API_KEY": "your-api-key"
      }
    }
  }
}

Global installieren

npm install -g freshservice-mcp

Konfigurieren Sie dann Ihren MCP-Client:

{
  "mcpServers": {
    "freshservice": {
      "command": "freshservice-mcp",
      "env": {
        "FRESHSERVICE_DOMAIN": "yourcompany",
        "FRESHSERVICE_API_KEY": "your-api-key"
      }
    }
  }
}

Aus dem Quellcode installieren

git clone https://github.com/tannertm0/freshservice-mcp.git
cd freshservice-mcp
npm install

{
  "mcpServers": {
    "freshservice": {
      "command": "node",
      "args": ["/path/to/freshservice-mcp/src/index.js"],
      "env": {
        "FRESHSERVICE_DOMAIN": "yourcompany",
        "FRESHSERVICE_API_KEY": "your-api-key"
      }
    }
  }
}

Konfiguration

Variable	Erforderlich	Beschreibung
`FRESHSERVICE_DOMAIN`	Ja	Ihre Freshservice-Subdomain (z. B. `ihrefirma` für `ihrefirma.freshservice.com`)
`FRESHSERVICE_API_KEY`	Ja	Ihr Freshservice-API-Schlüssel

MCP-Client-Einrichtung

Claude Desktop - Hinzufügen zu ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows)

Claude Code - Führen Sie claude mcp add freshservice -- npx -y freshservice-mcp aus und setzen Sie dann die Umgebungsvariablen

Cursor / VS Code - Fügen Sie es gemäß der Dokumentation Ihres Editors zu Ihren MCP-Einstellungen hinzu

Verfügbare Tools

Tickets

Tool	Beschreibung
`list_tickets`	Tickets mit Filtern auflisten (Status, Priorität, Anfragender, Datum)
`get_ticket`	Vollständige Ticketdetails abrufen
`create_ticket`	Ein neues Ticket erstellen
`update_ticket`	Ticketfelder aktualisieren (Status, Priorität, Zuweisung usw.)
`delete_ticket`	Ein Ticket löschen (verschiebt es in den Papierkorb)
`reply_to_ticket`	Auf ein Ticket antworten
`add_note_to_ticket`	Eine öffentliche oder private Notiz hinzufügen
`get_ticket_conversations`	Alle Antworten und Notizen anzeigen
`search_tickets`	Tickets mit Abfragesyntax filtern

Assets

Tool	Beschreibung
`list_assets`	Alle Assets/CIs auflisten
`get_asset`	Asset-Details mit benutzerdefinierten Feldern abrufen
`create_asset`	Ein neues Asset registrieren
`update_asset`	Asset-Felder aktualisieren
`delete_asset`	Ein Asset entfernen

Personen & Organisation

Tool	Beschreibung
`list_requesters` / `get_requester`	Endbenutzer
`list_agents` / `get_agent`	Support-Mitarbeiter
`list_groups` / `get_group`	Agentengruppen mit Mitgliedern
`list_departments` / `get_department`	Abteilungen

Ticket-Aufgaben

Tool	Beschreibung
`list_ticket_tasks`	Unteraufgaben eines Tickets auflisten
`get_ticket_task`	Aufgabendetails abrufen
`create_ticket_task`	Eine Aufgabe zu einem Ticket hinzufügen
`update_ticket_task`	Aufgabenstatus/Zuweisung aktualisieren
`delete_ticket_task`	Eine Aufgabe entfernen

Zeiteinträge

Tool	Beschreibung
`list_time_entries`	Protokollierte Zeit für ein Ticket anzeigen
`create_time_entry`	Aufgewendete Zeit protokollieren
`update_time_entry`	Einen Zeiteintrag ändern
`delete_time_entry`	Einen Zeiteintrag entfernen

Änderungen

Tool	Beschreibung
`list_changes`	Änderungsanfragen auflisten
`get_change`	Änderungsdetails abrufen (Typ, Risiko, Zeitplan)
`create_change`	Eine Änderungsanfrage erstellen
`update_change`	Änderungsfelder aktualisieren
`delete_change`	Eine Änderung löschen

Probleme

Tool	Beschreibung
`list_problems`	Problem-Datensätze auflisten
`get_problem`	Problemdetails abrufen
`create_problem`	Einen Problem-Datensatz erstellen
`update_problem`	Problemfelder aktualisieren
`delete_problem`	Ein Problem löschen

Servicekatalog

Tool	Beschreibung
`list_service_catalog_items`	Verfügbare Services durchsuchen
`get_service_catalog_item`	Servicedetails und erforderliche Felder abrufen
`place_service_request`	Eine Serviceanfrage einreichen

Wissensdatenbank

Tool	Beschreibung
`list_solution_categories` / `get_solution_category`	KB-Kategorien durchsuchen
`list_solution_folders` / `get_solution_folder`	KB-Ordner durchsuchen
`list_solution_articles` / `get_solution_article`	Artikel lesen
`create_solution_article`	Einen neuen Artikel schreiben
`update_solution_article`	Einen Artikel bearbeiten
`delete_solution_article`	Einen Artikel entfernen

Beispiel-Prompts

Sobald die Konfiguration abgeschlossen ist, können Sie Ihren KI-Assistenten Dinge fragen wie:

"Zeige mir alle offenen P1-Tickets"
"Erstelle ein Ticket für den Drucker im 3. Stock, der offline ist"
"Welche Assets sind John Smith zugewiesen?"
"Füge eine private Notiz zu Ticket #5678 hinzu, dass wir auf den Anbieter warten"
"Erstelle eine Änderungsanfrage für das Firewall-Upgrade, das für nächsten Dienstag geplant ist"
"Durchsuche die Wissensdatenbank nach Anweisungen zur VPN-Einrichtung"
"Protokolliere 2 Stunden für Ticket #1234 zur Behebung des Netzwerkproblems"
"Zeige mir alle offenen Probleme und deren Auswirkungsstufen"
"Stelle eine neue Laptop-Anfrage aus dem Servicekatalog"

Suchabfrage-Syntax

Das Tool search_tickets verwendet die Filter-Abfragesyntax von Freshservice:

"priority:4 AND status:2"          - Urgent + Open tickets
"group_id:12345"                   - Tickets assigned to a specific group
"agent_id:67890"                   - Tickets assigned to a specific agent
"created_at:>'2024-01-01'"         - Tickets created after a date

Entwicklung

git clone https://github.com/tannertm0/freshservice-mcp.git
cd freshservice-mcp
npm install
npm test

Lizenz

MIT

Freshservice MCP Server