M42 Utils Dokumentation

M42 Utils ist die Browser-Extension für Matrix42 ESM Consultants — vom ersten Projekt bis zum Senior Developer.

💡 M42 Utils erfordert ein kostenloses Konto. 30-Tage-Trial starten — alle Tier, keine Kreditkarte.

Tier-Übersicht

M42 Utils hat drei Lizenz-Tier. Während des 30-Tage-Trials sind alle Features freigeschaltet.

FeatureEntry €19,35 / JPro €133,50 / JDev €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

  1. ZIP herunterladen für deinen Browser.
  2. ZIP in einen dauerhaften Ordner entpacken (z.B. ~/extensions/m42utils/).
  3. chrome://extensions öffnen → Entwicklermodus aktivieren.
  4. Entpackte Extension laden" klicken → Ordner auswählen.
  5. M42 Utils anheften (Extensions-Toolbar → Pin).
⚠️ Den Ordner nach dem Laden nicht verschieben oder löschen — Chrome lädt von diesem Pfad.

Firefox

  1. .xpi-Datei herunterladen.
  2. about:addons → Zahnrad → Add-on aus Datei installieren.
  3. .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.

✓ 7-Tage Offline-Gnadenfrist wenn der Server nicht erreichbar ist.

Prozess-Checklisten Entry+

Panel öffnen → Tab „Checkliste". Vier Prozess-Typen verfügbar:

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.

💡 Besonders relevant für den M42UtilsMCP Server: Ist „less secure filtering" deaktiviert (ab 12.0.3), nutze M42_REST_FILTER_MODE=parametrized.

Templates Entry+

Panel → Tab „Templates". Vorgefertigte Texte für:

„Kopieren" klicken → Text ist in der Zwischenablage, direkt in Matrix42 einfügen.

Docs Sidebar Entry+

Panel → Tab „Docs". Die Matrix42-Dokumentation ist direkt durchsuchbar ohne den Tab wechseln zu müssen.

AI-Assistent Pro+

Panel → Tab „KI-Assistent". Chat-Interface mit einem KI-Assistenten der die Matrix42-Dokumentation und Best Practices kennt.

Beispielfragen

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.

💡 Der Report Generator ist in der aktuellen Version v0.1.0 in Entwicklung. Er ist im Panel sichtbar aber noch nicht vollständig implementiert.

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.

Beispiel

SELECT TOP 100 ID, Name, Status, Priority, CreationDate
FROM SPSActivity
WHERE Status NOT IN (4, 5)
ORDER BY Priority ASC, CreationDate DESC
⚠️ Der ASQL Runner führt Abfragen mit deiner aktuellen Benutzersession aus. Alle Matrix42-Zugriffskontrollen werden respektiert.

Slash Command Palette Dev

Ctrl+Shift+Space überall in Matrix42. Fuzzy-durchsuchbar.

BefehlShortcutBeschreibung
/asql [query]Ctrl+Shift+AASQL Runner öffnen
/techCtrl+Shift+TTech-Namen Overlay ein/aus
/link [typ]Deep-Link Builder
/instInstance 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.

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.

Kostenloser Download — keine Lizenz, kein Tier-Gate. Läuft lokal über stdio; deine Matrix42-Zugangsdaten bleiben auf deinem Rechner, nichts geht an m42utils.com.

Voraussetzungen

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:

PromptTool
„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.

⚠️ Schreibzugriff: Mutationen gehen immer über die Matrix42-REST-API (Geschäftslogik bleibt erhalten). Der optionale MSSQL-Modus ist strikt lesendINSERT/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.

TierPreis (pro Nutzer)Für wen
Entry€19,35 / JahrImplementation Consultants, tägliche M42-Arbeit
Pro€133,50 / JahrSenior Consultants, KI-Unterstützung, Reporting
Dev€193,50 / JahrTechnische Experten, ASQL, Solution Builder

Laufzeit- und Mengenrabatte

💡 Automatische Verlängerung um jeweils 12 Monate. Kündigungsfrist 3 Monate zum Ende der Laufzeit. Alle Updates innerhalb der Laufzeit sind kostenlos enthalten. Details in den AGB.

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

v0.1.0 — Erste Version