# Matrix42 MCP-Server: Den Service Desk in normaler Sprache fragen

> Ein Open-Source-MCP-Server, mit dem Claude, Copilot oder Cursor mit Matrix42 arbeiten: API, Datenmodell und Service Desk. Standardmäßig nur lesend.

- Von: [Alexander Schnabl](https://www.alexschnabl.com/), S&S Technologies
- Veröffentlicht: 1. Oktober 2026
- Kategorie: ITSM
- Quelle: https://www.sus-tech.com/de/blog/matrix42-mcp-server

Wer heute einen KI-Assistenten nach Matrix42 fragt, bekommt eine Vermutung. Der Assistent weiß nicht, welche Webservices Ihre Instanz anbietet, wie Ihre Datendefinitionen heißen oder welche Werte ein Feld annehmen kann. Also erfindet er URLs, Attributnamen und Filter. Die Antwort klingt richtig, bis jemand sie ausprobiert.

Der [Matrix42 MCP-Server](/de/solutions/matrix42-mcp) schließt diese Lücke. Er ist ein Open-Source-Server, der KI-Assistenten wie Claude, GitHub Copilot oder Cursor mit Ihrer Matrix42-Instanz verbindet. Der Assistent schlägt in Ihrem System nach, statt zu raten, und er liest nur, solange Sie nicht mehr erlauben.

## Was das Model Context Protocol ist

Das [Model Context Protocol](https://modelcontextprotocol.io) (MCP) ist ein offener Standard, über den KI-Assistenten Werkzeuge und Daten nutzen. Ein MCP-Server beschreibt, was er kann, als eine Reihe von Werkzeugen. Der Assistent entscheidet, wann er eines aufruft, und der Client zeigt Ihnen, welches Werkzeug er mit welcher Eingabe verwendet.

Für Matrix42 heißt das: Sie stellen eine Frage in normaler Sprache, der Assistent ruft die Werkzeuge des Servers auf und der Server spricht für ihn mit der Matrix42-API.

## Warum ein Assistent ihn für Matrix42 braucht

Eine typische Matrix42-Instanz bietet rund 190 Webservices mit etwa 1 100 Operationen und ein Datenmodell mit rund 800 Datendefinitionen und 240 Configuration Items. Jedes Unternehmen ergänzt eigene. Kein Sprachmodell kann wissen, was es in Ihrer Instanz gibt.

Der Server gibt dem Assistenten einen Weg, es herauszufinden:

- Er durchsucht die Webservices und liest den genauen Vertrag einer Operation, bevor jemand Integrationscode schreibt.
- Er liest das echte Datenmodell: Datendefinitionen, Configuration Items, Attribute, Beziehungen und die Werte, die ein Pickup-Feld annehmen kann.
- Er prüft jede Spalte gegen das aktuelle Schema Ihrer Instanz, bevor eine Abfrage läuft. Ein Feld, das Ihre Instanz nicht hat, wird gemeldet statt gesendet.
- Er bringt vier geschriebene Leitfäden mit: zum Datenmodell, zum Schema, zur Filtersprache ASQL und zu den Konventionen der REST-API.

## Eine Frage in normaler Sprache

Fragen Sie „Welche offenen Hardware-Tickets haben ihr Service Level überschritten?“, und der Assistent findet es selbst heraus. Er sucht die Tickets nach Kategorie und Status, prüft für jedes das Service Level so, wie Matrix42 es selbst berechnet, und erstellt für das gefährdete Ticket einen Link in die Matrix42-Weboberfläche. Sie schlagen keine einzige ID nach und es wird nichts geschrieben.

Andere Fragen beantwortet er auf dieselbe Weise:

- Welche Verträge laufen in diesem Quartal aus?
- Wo ist die Kostenstelle eines Assets gespeichert? Welche Werte kann sie haben?
- Was steht im Journal dieses Incidents?
- Welche Operation der API legt einen Service Request an? Schreib mir ein Skript, das sie aufruft.

## Was er kann

Der Server bietet sechs Werkzeuge. Fünf davon lesen nur:

| Werkzeug | Was es tut |
| --- | --- |
| `server_info` | Zeigt, welche Instanz verbunden ist, und prüft, ob die Zugangsdaten funktionieren |
| `webservice_discovery` | Findet Webservices und Operationen und liest ihre Verträge |
| `schema_discovery` | Erkundet Datendefinitionen, Configuration Items, Attribute und Pickup-Werte |
| `data_query` | Führt ASQL-Abfragen mit Paging aus, liest gespeicherte Ansichten, Journale und Anhänge und erstellt Links in die Weboberfläche |
| `service_desk` | Sucht Tickets jeder Art, beantwortet Fragen zu Service Levels und durchsucht Assets, Verträge, Katalog-Services und Wissensartikel |
| `ticket_actions` | Legt Tickets an, schließt, übernimmt, leitet weiter, pausiert und öffnet sie wieder, setzt Fristen und bucht Zeit. Nur vorhanden, wenn Schreiben eingeschaltet ist |

## Sicher von Anfang an

Wer einem KI-Assistenten Zugriff auf den Service Desk gibt, braucht klare Grenzen. Der Server setzt sie standardmäßig:

- Er liest nur. Die Werkzeuge, die Daten ändern, werden dem Assistenten gar nicht angeboten, solange `M42_ALLOW_WRITES=1` nicht gesetzt ist.
- Jede Änderung zeigt zuerst eine Vorschau: die genaue Anfrage, die gesendet würde. Erst ein zweiter Aufruf mit Bestätigung sendet sie. Die Vorschau ist dasselbe Objekt, das ausgeführt wird.
- Die Zugangsdaten bleiben im Server. Sie werden nie protokolliert und nie an den Assistenten zurückgegeben.
- Tickets, die über den Server entstehen, bekommen eine interne Notiz, die das festhält. Benachrichtigungs-E-Mails sind aus, Journaleinträge bleiben intern und das Schließen verknüpfter Incidents muss eigens verlangt werden.

Der Server erreicht alles, was das konfigurierte Konto lesen darf. Verwenden Sie ein Konto mit genau den Rechten, die der Assistent braucht. Mit `M42_TOOLS` beschränken Sie den Server auf die Werkzeuge, die Sie wollen.

## Einrichtung

Sie brauchen Node.js 22.19 oder neuer und ein API-Token, das Sie in der Matrix42-Administration für das Konto anlegen, in dessen Namen der Assistent handeln soll. Der Server läuft über stdio: Ihr KI-Client startet ihn mit `npx`, vorher muss nichts installiert werden.

In Claude Code:

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

In Claude Desktop tragen Sie den Server in `claude_desktop_config.json` ein:

```json
{
  "mcpServers": {
    "matrix42": {
      "command": "npx",
      "args": ["-y", "matrix42-mcp"],
      "env": {
        "M42_HOST": "https://matrix42.example.com",
        "M42_API_TOKEN": "your-api-token"
      }
    }
  }
}
```

Cursor, VS Code mit GitHub Copilot und andere MCP-Clients verwenden denselben Befehl in ihrer eigenen Konfigurationsdatei; die [README auf GitHub](https://github.com/sus-tech-gmbh/matrix42-mcp) enthält für jeden ein Beispiel. Zum Prüfen der Verbindung bitten Sie den Assistenten, `server_info` aufzurufen.

## Wo er hineinpasst

Der MCP-Server ist für Menschen, die mit einem Assistenten arbeiten. Für Automatisierung ohne Assistenten bringt unser von n8n verifizierter [Matrix42-Node für n8n](/de/solutions/n8n-nodes-matrix42) dieselbe Instanz in n8n-Workflows. Beide zusammen sind die Grundlage unserer [KI-Agenten für den Service Desk](/de/solutions/ai-agents-service-desk): Agenten, die Tickets einordnen, zusammenfassen und weiterleiten, während Menschen die letzte Entscheidung behalten.

## Gut zu wissen

Der Server ist in der offiziellen [MCP Registry](https://registry.modelcontextprotocol.io/) 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 gehören in die [Issues auf GitHub](https://github.com/sus-tech-gmbh/matrix42-mcp/issues); das Paket liegt auf [npm](https://www.npmjs.com/package/matrix42-mcp).

Möchten Sie ihn mit Ihrer eigenen Matrix42-Instanz einsetzen oder Matrix42 mit KI-Agenten verbinden? [Sprechen Sie mit uns](/de/contact).