Matrix42 MCP-Server

Der Matrix42 MCP-Server verbindet KI-Assistenten über das Model Context Protocol mit einer Matrix42-Instanz. Der Assistent findet den passenden Webservice, liest das Datenmodell, fragt Datensätze ab und durchsucht den Service Desk. Er liest nur, solange das Schreiben nicht eingeschaltet ist, und jede Änderung wird zuerst als Vorschau gezeigt.

npx -y matrix42-mcp
Matrix42 MCP-Server

Warum ein Assistent ihn braucht

Eine typische Matrix42-Instanz hat rund 190 Webservices mit etwa 1.100 Operationen, ein Datenmodell mit rund 800 Datendefinitionen und 240 Configuration Items. Ein KI-Assistent kann nicht wissen, welche davon es in Ihrer Instanz gibt, also rät er URLs, Attributnamen und Filter. Der Server gibt ihm die Möglichkeit nachzusehen: Er findet den passenden Webservice, liest das tatsächliche Datenmodell und prüft jede Spalte gegen Ihr Schema, bevor eine Abfrage läuft.

Was er kann

  • Die API erkunden: alle Operationen mit ihren Anfrage- und Antwortformaten
  • Das Datenmodell verstehen: Datendefinitionen, Configuration Items, Auswahlwerte und Beziehungen
  • Datensätze lesen: ASQL-Abfragen mit Paging, gespeicherte Ansichten, Journaleinträge, Anhänge und Links in die Matrix42-Weboberfläche
  • Im Service Desk arbeiten: Tickets jeder Art suchen, Fragen zu Service Levels beantworten, Assets, Verträge, Katalogservices und Wissensartikel durchsuchen
  • Tickets bearbeiten, wenn Sie es erlauben: anlegen, schließen, übernehmen, weiterleiten, pausieren, wieder öffnen, Fristen setzen und Zeiten erfassen

Eine Frage wie "Welche offenen Hardware-Tickets haben ihr Service Level überschritten?" wird beantwortet, ohne dass jemand eine ID nachschlagen muss.

Standardmäßig sicher

  • Der Server liest nur. Werkzeuge, die Daten ändern, werden dem Assistenten gar nicht angeboten, solange Sie das Schreiben nicht einschalten.
  • Jede Änderung wird zuerst als Vorschau gezeigt und erst nach der Bestätigung ausgeführt.
  • Die Zugangsdaten bleiben im Server. Der Assistent sieht sie nie.
  • Tickets, die über den Server angelegt werden, bekommen eine interne Notiz darüber. Benachrichtigungsmails sind aus und Journaleinträge standardmäßig intern.

Einrichtung

Sie brauchen Node.js 22.19 oder neuer und ein Matrix42-API-Token, angelegt in der Matrix42-Administration für das Konto, unter dem der Assistent arbeiten soll. Der Server läuft über stdio, Ihr KI-Client startet ihn also mit npx und vorher muss nichts installiert werden. Für Claude Code:

claude mcp add matrix42 \
  --env M42_HOST=https://matrix42.example.com \
  --env M42_API_TOKEN=your-api-token \
  -- npx -y matrix42-mcp

Claude Desktop, Cursor, VS Code mit GitHub Copilot und andere MCP-Clients verwenden denselben Befehl in ihrer eigenen Konfigurationsdatei. Die README auf GitHub hat für jeden ein Beispiel.

Gut zu wissen

Der Server ist in der offiziellen MCP Registry als io.github.sus-tech-gmbh/matrix42-mcp eingetragen, dort finden ihn MCP-Clients und Verzeichnisse.

Der Server ist eine frühe Version und ein unabhängiges Community-Projekt unter der MIT-Lizenz. Er steht in keiner Verbindung zu Matrix42 und wird von Matrix42 nicht unterstützt, wenden Sie sich deshalb bitte nicht an den Matrix42-Support. Fragen und Fehlermeldungen gehen an die Issues des Repositorys auf GitHub.

Für Automatisierung ohne Assistenten bringt der Matrix42-Node für n8n dieselbe Matrix42-Instanz in n8n-Workflows.

Beispiele und Hintergründe stehen in unserem Beitrag Matrix42 MCP-Server: Den Service Desk in normaler Sprache fragen.

Im Unternehmen einsetzen?

Der Code ist frei. Wir helfen bei Einrichtung, Anpassung und der Anbindung an Ihre Prozesse.