M42 Utils Dokumentation
M42 Utils ist die Browser-Extension für Matrix42 ESM Consultants — vom ersten Projekt bis zum Senior Developer.
Tier-Übersicht
M42 Utils hat drei Lizenz-Tier. Während des 30-Tage-Trials sind alle Features freigeschaltet.
| Feature | Entry €19,35 / J | Pro €133,50 / J | Dev €193,50 / J |
|---|---|---|---|
| Prozess-Checklisten | ✓ | ✓ | ✓ |
| Matrix42 Lexikon | ✓ | ✓ | ✓ |
| Matrix42 Release Radar | ✓ | ✓ | ✓ |
| Ticket- & Notiz-Templates | ✓ | ✓ | ✓ |
| Docs Sidebar | ✓ | ✓ | ✓ |
| Instance Switcher | ✓ | ✓ | ✓ |
| AI Workflow-Assistent | — | ✓ | ✓ |
| Client-Report Generator | — | ✓ | ✓ |
| API Debugger | — | ✓ | ✓ |
| Doku-KI „Ask M42" | — | ✓ | ✓ |
| ASQL Runner + Monaco | — | — | ✓ |
| Slash Command Palette | — | — | ✓ |
| Deep-Link Builder | — | — | ✓ |
| Tech-Namen Overlay | — | — | ✓ |
| Custom URL Patterns | — | — | ✓ |
Alle Preise verstehen sich pro Nutzer und Jahr, zzgl. MwSt. Alle Updates innerhalb der Laufzeit sind inklusive. Upgrade auf einen höheren Tier jederzeit möglich — die Restlaufzeit wird angerechnet. Mengen- und Laufzeitrabatte (siehe unten und in den AGB) sind verfügbar.
Installation
Chrome / Edge
- ZIP herunterladen für deinen Browser.
- ZIP in einen dauerhaften Ordner entpacken (z.B.
~/extensions/m42utils/). chrome://extensionsöffnen → Entwicklermodus aktivieren.- „Entpackte Extension laden" klicken → Ordner auswählen.
- M42 Utils anheften (Extensions-Toolbar → Pin).
Firefox
- .xpi-Datei herunterladen.
about:addons→ Zahnrad → Add-on aus Datei installieren.- .xpi-Datei auswählen und bestätigen.
Anmelden
Nach der Installation M42 Utils-Icon klicken → E-Mail und Passwort eingeben. Der Lizenzstatus wird alle 24 Stunden geprüft und lokal gecacht.
Prozess-Checklisten Entry+
Panel öffnen → Tab „Checkliste". Vier Prozess-Typen verfügbar:
- Incident — Erstmeldung bis Abschluss, 8 Schritte
- Change — Antrag bis Abschlussbericht, 7 Schritte
- Onboarding — Benutzer einrichten, 7 Schritte
- Problem — Root Cause bis Known Error, 6 Schritte
Jeder Schritt hat einen konkreten Hinweis was zu tun ist. Fortschrittsbalken oben zeigt den aktuellen Stand. Der Zustand bleibt während der Browser-Session erhalten.
Matrix42 Lexikon Entry+
Panel → Tab „Lexikon". Alle wichtigen CI-Typen, Felder und Konzepte durchsuchbar.
Zusätzlich: Wenn du mit der Maus über ein bekanntes M42-Feld (z.B. SPSActivity, Status) auf einer Matrix42-Seite hoverst, erscheint automatisch ein Erklärungs-Tooltip — ohne Panel zu öffnen.
Matrix42 Release Radar Entry+
Panel → Tab „Lexikon" → Abschnitt „Matrix42 Release Radar". Ein kuratierter Überblick der jüngsten Matrix42-Releases (Highlights + Link zu den offiziellen Release Notes) plus eine Feature-Verfügbarkeits-Matrix: welche Funktion ab welcher Version verfügbar ist (z.B. AI-Native Workflow Designer ab 25.4, Configurable AI ab 2025.2, parametrisierte REST-Filter ab 12.0.3).
Trag optional deine Instanz-Version ein (z.B. 2025.2) — die Matrix markiert dann pro Feature verfügbar / noch nicht, damit du vor dem Konzipieren weißt, worauf du dich beim Kunden verlassen kannst.
M42_REST_FILTER_MODE=parametrized.Templates Entry+
Panel → Tab „Templates". Vorgefertigte Texte für:
- Incident — Erstmeldung, Abschluss-E-Mail
- Change — Ankündigung, Abschlussbericht
- Übergabe — Projekt-Übergabe an Kunden
- ASQL — Häufige Abfragen (Incidents, Changes, Benutzer)
„Kopieren" klicken → Text ist in der Zwischenablage, direkt in Matrix42 einfügen.
AI-Assistent Pro+
Panel → Tab „KI-Assistent". Chat-Interface mit einem KI-Assistenten der die Matrix42-Dokumentation und Best Practices kennt.
Beispielfragen
- „Wie konfiguriere ich einen Eskalations-Workflow?"
- „Was ist der Unterschied zwischen SPSActivity und SPSActivityType?"
- „Wie triggere ich eine Benachrichtigung bei Priority 1 Incidents?"
- „Erkläre mir wie Calculated Fields funktionieren."
Eingabe mit Ctrl+Enter absenden. Antworten sind auf Deutsch.
Client-Report Generator Pro+
Wochenbericht oder Monatsbericht als PDF oder Word-Dokument auf Knopfdruck. Zeitraum wählen, Highlights eintragen — M42 Utils generiert ein professionelles Dokument.
API Debugger Pro+
Matrix42 REST API Calls direkt im Browser testen. Requests speichern und als Collection für das Team bereitstellen.
ASQL Runner Dev
Panel → Tab „ASQL". Vollständiger ASQL-Workbench.
- Monaco Editor mit Syntax-Highlighting
Ctrl+Enterzum Ausführen- Ergebnisse sortierbar per Spaltenklick
- CSV-Export
- Query-Verlauf
Beispiel
SELECT TOP 100 ID, Name, Status, Priority, CreationDate
FROM SPSActivity
WHERE Status NOT IN (4, 5)
ORDER BY Priority ASC, CreationDate DESC
Slash Command Palette Dev
Ctrl+Shift+Space überall in Matrix42. Fuzzy-durchsuchbar.
| Befehl | Shortcut | Beschreibung |
|---|---|---|
| /asql [query] | Ctrl+Shift+A | ASQL Runner öffnen |
| /tech | Ctrl+Shift+T | Tech-Namen Overlay ein/aus |
| /link [typ] | — | Deep-Link Builder |
| /inst | — | Instance Switcher |
| /go <typ> | — | CI-Typ-Liste öffnen |
| /dd <name> | — | Data Definition öffnen |
| /user <suche> | — | Benutzer suchen |
| /wf <name> | — | Workflow suchen |
| /api [pfad] | — | REST API Explorer |
Tech-Namen Overlay Dev
Ctrl+Shift+T schaltet auf jedem Formular die internen Feldnamen ein. Unverzichtbar beim ASQL schreiben und Solution Builder konfigurieren.
Deep-Link Builder Dev
Panel → Tab „Deep Links". CI-Typ wählen, ID eingeben, Ansicht auswählen → URL generieren und kopieren.
Monaco Editor Injection Dev
Monaco wird automatisch in ASQL-Textfelder in Matrix42 injiziert (Calculated Fields, Script Actions). Zeilen-Nummern, Code-Folding, Ctrl+H (Find & Replace), Multi-Cursor.
Custom URL-Muster
M42 Utils erkennt Matrix42 automatisch über 5 Signale (URL enthält /wm/, Meta-Tag, window.M42, DOM-Klassen, Custom Patterns). Eigene Muster unter Einstellungen → Custom URL-Muster:
# Glob (Wildcard)
*.m42cloud.com/wm/*
intranet.company.de/matrix42/*
# Regex (in / ... / einwickeln)
/^https?:\/\/[^\/]+\/m42\//
Instance Switcher
Popup → Instance Switcher oder /inst. Mehrere Matrix42-Instanzen konfigurieren mit Namen, URL und Farb-Tag. Schnell zwischen Kunden wechseln.
M42UtilsMCP Server Kostenlos
Der M42UtilsMCP Server bringt Matrix42 in deinen KI-Assistenten — außerhalb des Browsers. Über das Model Context Protocol nutzen Claude Desktop, Claude Code oder Cursor deine Matrix42-Instanz direkt: ASQL ausführen, CMDB-Objekte lesen/schreiben, Typ-Metadaten abfragen, Deep-Links bauen.
Voraussetzungen
- Node.js ≥ 20
- Matrix42-Instanz + API-Token (oder Benutzer/Passwort für Basic Auth)
- Optional: Netzwerkzugriff auf die Matrix42-MSSQL-DB (nur lesend, für On-Prem-Reporting)
Einrichtung (Claude Desktop)
In claude_desktop_config.json eintragen:
{
"mcpServers": {
"m42utils": {
"command": "node",
"args": ["/pfad/zu/m42utils/mcp/src/index.js"],
"env": {
"M42_BASE_URL": "https://kunde.m42cloud.com",
"M42_API_TOKEN": "dein-token"
}
}
}
}
Vorher einmalig cd mcp && npm install. Claude Code / .mcp.json nutzen dasselbe Schema.
Tools & Beispiel-Prompts
Einfach in natürlicher Sprache fragen — der Assistent wählt das passende Tool:
| Prompt | Tool |
|---|---|
| „Zeig mir die 20 zuletzt geänderten offenen Incidents." | m42_asql_query |
| „Welche Assets hat Hersteller Dell? Nur Name + Seriennummer." | m42_get_objects |
| „Hol das Objekt mit ID 5f2c…" | m42_get_object_by_id |
| „Welche Attribute hat der CI-Typ SPSComputerClassBase?" | m42_describe_type |
| „Gib mir den Deep-Link zum Asset 5f2c… (Edit)." | m42_build_deep_link |
| „Leg einen neuen Standort ‚Berlin' an." | m42_create_object * |
| „Setze bei Incident 5f2c… die Priorität auf 1." | m42_update_object * |
| „Wie viele Assets pro Hersteller?" (MSSQL) | m42_sql_query |
* Schreibende Tools laufen über die REST-API und verlangen eine Bestätigung (confirm) — der Assistent fragt vorher nach.
INSERT/UPDATE/DELETE/DDL werden abgelehnt. Mit M42_MCP_READONLY=true lassen sich alle Schreib-Tools komplett deaktivieren.Trial & Abonnement
30-Tage-Trial mit allen Features. Keine Kreditkarte. Nach dem Trial wählst du einen Tier und schließt ein Jahres-Abonnement ab.
| Tier | Preis (pro Nutzer) | Für wen |
|---|---|---|
| Entry | €19,35 / Jahr | Implementation Consultants, tägliche M42-Arbeit |
| Pro | €133,50 / Jahr | Senior Consultants, KI-Unterstützung, Reporting |
| Dev | €193,50 / Jahr | Technische Experten, ASQL, Solution Builder |
Laufzeit- und Mengenrabatte
- Laufzeitrabatt: 24 Monate = 10 % Rabatt, 36 Monate = 20 % Rabatt auf den Gesamtpreis.
- Mengenrabatt pro Unternehmen: ab 5 Lizenzen 5 %, ab 10 Lizenzen 10 %, ab 15 Lizenzen 15 % auf den Gesamtbetrag. Größere Teams verhandeln wir individuell.
FAQ
Funktioniert es mit On-Premise Matrix42?
Ja. URL-Muster unter Einstellungen → Custom URL-Muster eintragen. Selbst-signierte Zertifikate werden behandelt.
Kann ich die Extension auf mehreren Geräten nutzen?
Ja. Die Lizenz ist an dein Konto (E-Mail) gebunden, nicht an ein Gerät.
Was passiert nach dem Trial?
Ohne aktives Abo werden alle kostenpflichtigen Features gesperrt. Mit einem aktiven Entry-, Pro- oder Dev-Abonnement bleiben die Features des jeweiligen Tiers während der Laufzeit freigeschaltet.
Welche Matrix42-Versionen werden unterstützt?
Matrix42 ESM 2021 und neuer, SaaS und On-Premise.
Speichert M42 Utils Matrix42-Daten?
Nein. Alle ASQL-Abfragen und Ergebnisse verbleiben im Browser. Auf unseren Servern werden nur E-Mail, bcrypt-gehashtes Passwort und Lizenzstatus gespeichert.
Changelog
v0.1.1 — Release Notes
- Extended Lexicon
- Extended Templates
- Add Schema Browser
- Fix Copy Raw, Copy to Template & Copy Smart
- Add UUID detection + id-link rendering in showAsqlResults
- Intellisense for ASQL: helps to write queries faster
v0.1.0 — Erste Version
- 3-Tier Jahres-Abo: Entry (€19,35/J) · Pro (€133,50/J) · Dev (€193,50/J)
- 30-Tage-Trial mit vollem Zugang
- Entry: Prozess-Checklisten (Incident, Change, Onboarding, Problem)
- Entry: Matrix42 Lexikon mit Feld-Tooltips
- Entry: Ticket- & Notiz-Templates + ASQL-Starter-Queries
- Pro: AI Workflow-Assistent (Claude-powered)
- Dev: ASQL Runner mit Monaco Editor
- Dev: Slash Command Palette (Ctrl+Shift+Space)
- Dev: Tech-Namen Overlay (Ctrl+Shift+T)
- Dev: Deep-Link Builder
- 5 Sprachen: DE, EN, FR, IT, ES
- Chrome, Firefox, Edge