TOPdesk über MCP mit KI nutzen
Im Servicemanagement kostet nicht die Lösung die meiste Zeit, sondern das Zusammentragen des Kontexts. Für TOPdesk gibt es einen Community-MCP-Server auf Basis der REST-API, den wir als Container in Ihrer CompanyGPT-Umgebung betreiben – so bleiben Servicedaten in Ihrem eigenen Tenant.
Was ist TOPdesk?
TOPdesk ist eine Servicemanagement-Plattform des niederländischen Anbieters TOPdesk aus Delft, der auch im deutschsprachigen Raum stark vertreten ist. Abgedeckt werden IT-Servicemanagement mit Incidents, Changes und Assets ebenso wie Facility- und Personal-Services – häufig genutzt von Hochschulen, Kommunen, Kliniken und mittelständischen IT-Organisationen. Betrieben wird die Plattform als SaaS oder als Installation im eigenen Rechenzentrum.
Für KI-Agenten sind vor allem die Vorgangsdaten interessant: Meldungen mit Verlauf, Zuordnung, Kategorie und Anhängen. Diese Informationen sind über die dokumentierte REST-Schnittstelle abrufbar, sodass sich Fragen zum Bearbeitungsstand oder zu ähnlichen früheren Fällen im Dialog klären lassen, statt sich durch Übersichten zu filtern.
Anbindung auf einen Blick
- MCP-Server
- Community (dbsanfte/topdesk-mcp), Self-hosted – kein offizieller Server
- Paket
- topdesk-mcp (PyPI)
- Authentifizierung
- API-Konto mit Application Password (Basic Auth)
- Betriebsmodell
- SaaS oder On-Premises / virtuelle Appliance
- Schnittstellen
- TOPdesk REST-API, OData-Endpunkte, Webhooks
- Datenfluss
- MCP-Container in Ihrer CompanyGPT-Umgebung
So verbinden Sie TOPdesk mit CompanyGPT
Einen offiziellen MCP-Server bietet TOPdesk nicht an. Verfügbar ist der Community-Server dbsanfte/topdesk-mcp (auf PyPI als topdesk-mcp), der Incidents anlegen, aktualisieren und eskalieren kann und Anhänge für die Weiterverarbeitung nach Markdown konvertiert. Er arbeitet vollständig über die offene REST-API und setzt keine Erweiterung in TOPdesk voraus.
Betrieben wird der Server als Container innerhalb Ihrer CompanyGPT-Umgebung. Die Anmeldung erfolgt über ein TOPdesk-API-Konto mit Application Password per Basic Auth, konfiguriert über TOPDESK_BASE_URL und TOPDESK_API_TOKEN. Wir legen dafür ein eigenes Konto an, dessen Rechte genau auf die vorgesehenen Vorgangsarten und Datenbereiche zugeschnitten sind – damit steuern Sie den Zugriff bereits im Quellsystem.
Der Weg zur Instanz hängt vom Betriebsmodell ab: Nutzen Sie TOPdesk als SaaS, spricht der Container die API direkt an. Läuft die Plattform als On-Premises-Installation oder virtuelle Appliance im eigenen Netz, richten wir die Netzwerkanbindung gemeinsam mit Ihrer IT ein. Alternativ zum Community-Server bauen wir die Integration auch individuell auf der REST- beziehungsweise OData-Schnittstelle auf, wenn Sie einen klar begrenzten Funktionsumfang bevorzugen.
Hinweis für On-Premises-Betrieb: CompanyGPT läuft in Ihrem eigenen Azure-Tenant – dadurch lässt sich Ihr On-Premises-Netz direkt anbinden: über ein Site-to-Site-VPN (Azure VPN Gateway) oder ExpressRoute zwischen Ihrem Firmennetz und dem virtuellen Netzwerk Ihrer CompanyGPT-Umgebung. Das System muss dafür nicht öffentlich erreichbar sein; wir richten die Verbindung gemeinsam mit Ihrer IT ein.
Typische Anwendungsfälle
So arbeiten KI-Agenten in CompanyGPT mit TOPdesk
Kontext zu einem Incident bündeln
Der Servicedesk lässt sich zu einer Meldung den Verlauf, die betroffenen Assets und vergleichbare frühere Vorgänge zusammenstellen, bevor die Bearbeitung startet.
Meldungen sauber erfassen
Aus einer formlosen Beschreibung per Mail oder Telefonnotiz erzeugt der Assistent einen strukturierten Incident mit Kategorie, Beschreibung und Priorisierungsvorschlag.
Auswertung für die Serviceleitung
Für den monatlichen Servicebericht fasst ein Agent Aufkommen, Schwerpunkte und auffällige Häufungen zusammen und liefert eine Textfassung, die nur noch geprüft werden muss.
Häufig gestellte Fragen
TOPdesk und KI – die wichtigsten Antworten
Hat TOPdesk einen offiziellen MCP-Server?
Nein. Es gibt den Community-Server topdesk-mcp, der Incidents anlegen, aktualisieren und eskalieren kann sowie Anhänge nach Markdown konvertiert. Er nutzt ausschließlich die offene REST-API von TOPdesk.
Wo läuft der MCP-Server?
Als Container in Ihrer CompanyGPT-Umgebung. Zugangsdaten und Vorgangsdaten bleiben damit in Ihrem eigenen Cloud-Tenant, ein Dienst eines Drittanbieters ist nicht beteiligt.
Wir setzen TOPdesk als SaaS ein – was ist dann nötig?
Im SaaS-Betrieb genügt ein API-Konto mit Application Password; der Container erreicht die Schnittstelle direkt. Eine gesicherte Netzwerkverbindung wird nur bei On-Premises- oder Appliance-Installationen im eigenen Netz benötigt.
Wie begrenzen wir, worauf die KI zugreift?
Über die Rechte des angelegten API-Kontos in TOPdesk und über die in CompanyGPT freigegebenen Tools. Zusätzlich entscheiden Ihre Administratoren per Rolle und Gruppe, wer die Integration überhaupt nutzen darf.
Kann der Assistent Incidents auch verändern?
Technisch unterstützt der Server das Anlegen, Aktualisieren und Eskalieren. Ob das genutzt wird, entscheiden Sie: Für den Start empfehlen wir ein lesendes Profil und ergänzen schreibende Tools schrittweise.
TOPdesk und Ihre KI – DSGVO-konform mit CompanyGPT
CompanyGPT ist der Enterprise-KI-Assistent in Ihrem eigenen Cloud-Tenant: alle relevanten KI-Modelle, Ihre Unternehmensdaten und Integrationen wie TOPdesk – zentral verwaltet, mit Rollen und Berechtigungen. Wir richten die Anbindung gemeinsam mit Ihnen ein.
TOPdesk ist eine Marke des jeweiligen Inhabers (TOPdesk). Die Nennung beschreibt die Kompatibilität und impliziert keine Partnerschaft oder Empfehlung. Verfügbarkeit und Funktionsumfang der Anbindung richten sich nach dem jeweiligen Anbieter.