JRMT — MCP-Integration

JobRouter-Prozesse mit KI bauen

Sag deinem KI-Chat-Programm, was du brauchst — fertige JR-Prozesse, Dialoge und Reporting-Ansichten ohne den klassischen Designer. Diese Seite erklärt, wie das technisch zusammenpasst und wie du es in 5 Minuten einrichtest.

Adresse, die du brauchst: https://jrmt.winkels.io/mcp/rpc

Wie funktioniert das eigentlich?

Damit du verstehst, was du da gleich einrichtest — drei Komponenten arbeiten zusammen. Jede hat ihre eigene Aufgabe:

👤

Du schreibst in normaler Sprache, was du willst: „Bau mir einen Urlaubsantrag mit drei Schritten".

↓

🧠

Der KI-Assistent (Claude) versteht deinen Wunsch und überlegt, was er bauen muss. Er kennt selbst kein JobRouter — er braucht jemanden, der ihm dabei hilft.

↓

🌉

Der MCP-Server (jrmt.winkels.io) ist die Brücke zwischen Claude und dem JR-Werkzeugkasten. Er stellt Claude einen Werkzeugkasten mit ca. 80 fertigen Werkzeugen bereit — „Erstelle Prozess", „Füge Feld hinzu", „Compile zu ZIP", …

↓

⚙️

Die JRMT-Bibliothek Hinter den Werkzeugen steckt eine Software, die das eigentlich Schwere macht: sie kennt das exakte XML-Format von JobRouter und prüft jeden Schritt, bevor sie eine importfähige Datei erzeugt.

↓

📦

Die fertige ZIP- oder XML-Datei landet bei dir — und du importierst sie in deinem JobRouter unter Administration → Prozesse → Import. Fertig.

Kurz gesagt: Claude ist der schlaue Mitarbeiter, der MCP-Server ist sein Telefon zu unserer Werkstatt, und JRMT ist die Werkstatt selbst. Du redest mit Claude — den Rest erledigen die anderen für dich.

MCP — was ist das? Model Context Protocol, ein offener Standard von Anthropic. Ähnlich wie USB für KI-Werkzeuge: jeder KI-Chat (Claude, Cursor, Continue, Cline, ...), der MCP unterstützt, kann sich an einen MCP-Server „anstecken" und bekommt sofort dessen Werkzeuge. Du musst nichts programmieren.

Schnellstart in 5 Minuten

Drei Schritte. Wähle weiter unten die Anleitung, die zu deinem Chat-Programm passt.

KI-Chat-Programm installieren

Empfohlen: Claude Desktop (kostenlos, läuft auf Mac/Windows/Linux). Alternativ funktioniert auch Claude Code, Cursor, Continue, Cline u.a.

JRMT als „MCP-Server" eintragen

Einmalig die URL https://jrmt.winkels.io/mcp/rpc in deinem Chat-Programm hinterlegen — siehe Anleitung pro Programm weiter unten.

Chatten und Prozess bauen lassen

„Erstelle einen Urlaubsantrag mit zwei Schritten und gib mir die ZIP." Claude ruft im Hintergrund die JRMT-Werkzeuge auf und schickt dir die fertige Datei.

Anleitung: Claude Desktop

Wenn du noch nie programmiert hast — das ist die beste Option. Du brauchst nur eine Textdatei zu öffnen und ein paar Zeilen reinzukopieren.

Claude Desktop herunterladen und installieren

Auf claude.ai/download gehen, die Version für dein Betriebssystem herunterladen und ganz normal installieren. Anschließend einmal starten und mit deinem Anthropic-Konto anmelden.

Konfigurationsdatei öffnen

Claude Desktop liest seine Einstellungen aus einer Datei namens claude_desktop_config.json. Wo die liegt, hängt von deinem Betriebssystem ab:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Tipp: In Finder ⌘+Shift+G drücken und den Pfad einfügen.
Windows: %APPDATA%\Claude\claude_desktop_config.json
Tipp: Im Explorer in die Adresszeile %APPDATA%\Claude eingeben.
Linux: ~/.config/Claude/claude_desktop_config.json

Existiert die Datei noch nicht, lege sie an. Öffne sie in einem Texteditor (Notepad, TextEdit, VS Code — alles geht).

Folgenden Inhalt einfügen und speichern

Wenn die Datei leer ist, kopiere den kompletten Block. Wenn sie schon Inhalt hat, ergänze nur den "jrmt"-Eintrag im bestehenden "mcpServers"-Block:

{
  "mcpServers": {
    "jrmt": {
      "url": "https://jrmt.winkels.io/mcp/rpc",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer DEIN_API_KEY"
      }
    }
  }
}

API-Key: Ersetze DEIN_API_KEY durch deinen persönlichen Key (Format jrmt_…). Noch keinen? Hier kostenlos registrieren — E-Mail bestätigen, Key wird einmalig angezeigt. Aktuell läuft eine Übergangsphase, in der der Server auch ohne Key antwortet; das wird in Kürze abgeschaltet.

Claude Desktop neu starten

Komplett beenden (Mac: ⌘+Q, nicht nur Fenster zu) und wieder öffnen. Claude liest die Konfiguration nur beim Start.

Prüfen, ob es klappt

Im Chat-Fenster siehst du unten ein kleines Werkzeug-Symbol 🔌. Klick es an — dort sollte jrmt erscheinen mit dem Hinweis „connected" und der Liste der verfügbaren Werkzeuge. Oder schreib einfach in den Chat: „Welche JRMT-Tools hast du?"

Ältere Claude-Desktop-Version? Wenn der "transport": "http"-Eintrag keine Wirkung hat, ist deine Version zu alt. Update auf die aktuelle Version (Menüleiste → Claude → Check for Updates) — HTTP-MCP-Support kam erst Ende 2025.

Anleitung: Claude Code (für Entwickler)

Wenn du Claude im Terminal nutzt: ein einzelner Befehl.

claude mcp add --transport http jrmt https://jrmt.winkels.io/mcp/rpc \
  --header "Authorization: Bearer DEIN_API_KEY"

Danach im Chat /mcp tippen — JRMT sollte als verbunden erscheinen. DEIN_API_KEY bekommst du über die Registrierung.

Anleitung: andere KI-Programme

Cursor, Continue, Cline, Goose, Zed und viele weitere KI-Tools unterstützen MCP. Die Einrichtung ist überall ähnlich — du brauchst nur drei Informationen:

Name: jrmt (frei wählbar)
URL: https://jrmt.winkels.io/mcp/rpc
Transport: http oder streamable-http
Header: Authorization: Bearer DEIN_API_KEY (Key registrieren)

Schau in die MCP-Doku deines Programms — es gibt überall einen Konfigurationsbereich dafür.

Was passiert eigentlich im Chat?

Damit du eine Vorstellung bekommst — hier ein typischer Ablauf, wenn du Claude um einen Prozess bittest:

Du schreibst: „Erstelle einen Urlaubsantrag-Prozess. Felder: Mitarbeiter, Von-Datum, Bis-Datum, Begründung. Zwei Schritte: Antrag und Genehmigung. Compile und gib mir die ZIP."
Claude denkt nach — er erkennt: das ist eine JR-Sache, dafür hat er den MCP-Server.
Claude ruft Werkzeuge auf — typisch wären: create_process, add_field (vier Mal), add_step (zwei Mal), bind_role, dann compile_process. Du siehst diese Aufrufe im Chat.
Der MCP-Server antwortet nach jedem Werkzeug-Aufruf mit einer Bestätigung oder mit Hinweisen, falls etwas fehlt („Du hast noch keine Rolle gebunden — soll ich eine anlegen?").
Die ZIP-Datei landet bei dir — entweder direkt im Chat als Download oder Claude zeigt dir einen Link, den du klicken kannst.

Du musst keine Werkzeug-Namen kennen oder verstehen. Beschreib einfach, was du brauchst — Claude findet selbst heraus, welche Werkzeuge nötig sind.

Beispiele zum Mitnehmen

Diese Sätze kannst du eins-zu-eins in den Chat kopieren. Sie zeigen, wie ausführlich oder knapp du sein kannst:

„Erstelle einen Prozess für Urlaubsanträge. Felder: Mitarbeiter, Abteilung, Von-Datum, Bis-Datum, Anzahl Tage, Begründung. Drei Schritte: Antrag, Genehmigung, Information. Compile und gib mir die ZIP."

„Bau ein Mitarbeiter-Onboarding mit getrennten Bearbeiterschritten für HR, IT und Geschäftsführung. HR füllt Stammdaten, IT richtet Accounts ein, die Geschäftsführung gibt frei. Bei Ablehnung zurück zur Erfassung."

„Erstelle einen Bestellfreigabeprozess mit einer Tabelle für Positionen (Artikel, Menge, Einzelpreis). Über 1000 € braucht es die Geschäftsführung, sonst genügt die Abteilungsleitung."

„Bau mir eine Reporting-Ansicht (jobselect), die alle Aufträge der letzten 12 Monate aus der Tabelle order_demo zeigt: Auftragsnummer, Kundenname, Betrag, Datum. Filter für Kunde und Datumsbereich. Die DB-Verbindung heißt JRMT_DEMO, Rolle admins."

„Lies meine bestehende Prozess-ZIP ein, hänge zwei neue Felder ans Eingabeformular und ergänze eine englische Übersetzung für alle Step-Labels. Dann gib mir die neue ZIP."

Was du alles bauen kannst

Der MCP-Server hat zwei große Themenbereiche — Prozesse (Antragsformulare und Workflows) und Reporting (Datenbank-Auswertungen):

Prozesse / Anträge

Komplette Prozesse — von leerem Skelett bis fertige JR-ZIP, in einem Rutsch oder Schritt für Schritt
62+ Felder aller Typen: Text, Zahl, Datum, Dezimal, Datei, Long-Text
Workflow-Schritte: Start-, User-, Gateway-, Parallel-Split-Steps mit Rollen-Bindung, Buttons (Rückfrage, Zuweisen) und Empfänger-Konfiguration
Komplexes Routing: Forwarding-Regeln mit bis zu 3 Klauseln und AND/OR-Verknüpfung, Wert-Zuweisungen, Termination-Regeln
Auswahllisten als Dropdowns, Radio-Gruppen, SQL-gestützt
Vollständige Dialoge: Multi-Page-Layouts mit Sections, Rows und Columns, 31 Element-Typen (Textfelder, Datumspicker, Datei-Upload, Unterschrift, Subtable-Views, …)
PHP- und JS/CSS-Logik: PHP-Funktionen für Rule-Conditions / Initialisierung, Dialog-Skripte je Dialog oder global
Mehrsprachigkeit: Label-Translations pro Sprache für Felder, Steps, Dropdown-Werte
Import vorhandener Prozesse: bestehende JR-ZIP einlesen, bearbeiten, neu kompilieren — Round-Trip-stabil

Reporting / jobselect-Ansichten

Komplette Reporting-Ansichten für JR-Listenübersichten — vom leeren Skelett bis zur importfähigen XML
Datenquellen: freie SQL-Abfragen oder Tabellen-Builder mit WHERE/ORDER BY
9 Spalten-Typen: Text, Dezimal, Datum, Prozent, Bild, Vorgangsdetails, JobArchive, DW-WebClient und klickbare Skript-Aktionen
6 Filter-Typen: Text, Dezimal (mit Wertebereich), Datum, Timestamp, statische Auswahl und SQL-gestützte Auswahl, optional Mehrfachauswahl
Eigene Mini-Sprache (DSL): Wer ein paar Ansichten am Stück bauen will, kann die in einer kompakten Text-Syntax beschreiben — Claude versteht sowohl die granularen Werkzeuge als auch das Tool compile_query_dsl, das eine komplette DSL-Source entgegennimmt.
Rollen-Bindung: Pflicht, damit die Ansicht im JR-Menü erscheint
Validierung der JR-Eigenheiten, die im Designer leicht durchrutschen: Filter ohne passende Result-Spalte, leere Select-Dropdowns, vergessene DB-Verbindungen

Werkzeug-Katalog (für Neugierige)

Der MCP-Server stellt insgesamt ca. 80 Werkzeuge bereit. Du musst keines davon kennen — Claude wählt sie selbst aus. Wenn du trotzdem unter die Haube schauen willst, hier die Übersicht:

Alle Werkzeuge anzeigen

Prozess-Lebenszyklus

create_process — neuen Prozess anlegen (Skelett oder voll mit JSON)
get_process — vollständiges Prozess-JSON abrufen
get_process_summary — kompakte Übersicht (Counts, Rollen, Validator-Issues) ohne volles JSON
update_process — Prozess vollständig ersetzen
compile_process — zu importfähiger JR-ZIP übersetzen; ZIP wird vom MCP-Client automatisch heruntergeladen (resource_link)
import_process · import_uploaded_process — bestehende JR-ZIP einlesen
delete_process — Prozess entfernen

Metadaten & Rollen

set_process_meta — Titel, Kategorie, Default-Sprache, Inbox-Zusammenfassung, Beschreibung (partial-update)
bind_role — Rolle (JobFunction) am Prozess freischalten

Felder & Listen

add_field — Prozessfeld anlegen (varchar/int/date/text/decimal)
add_list — Auswahlliste anlegen, optional mit allen Einträgen in einem Call
add_list_entry — einzelnen Eintrag ergänzen (mit Translations)

Workflow: Steps & Regeln

add_step — Start-/User-/Gateway-/Parallel-Steps mit optionalem Auto-Dialog
add_rule — Forwarding (mit Multi-Klauseln, AND/OR, nextUser, stopRuleExecution), Always-, Value-Assignment-, Termination-Regeln
set_action_recipients — Empfänger für Rückfrage/Zuweisen-Buttons setzen und Buttons gleichzeitig aktivieren

Dialog-Struktur

add_dialog — leeren Dialog anlegen
add_dialog_page · add_dialog_section · add_dialog_row · add_dialog_column — Hierarchie aufbauen oder per Auto-Create wachsen lassen
add_dialog_elements — Batch: mehrere Elemente in einer Column in einem Call
remove_dialog_element — Element entfernen
get_dialog_structure — Klartext-Baum eines Dialogs (Pages → Sections → Rows → Columns → Elements mit Labels und Feldbindungen)

Dialog-Elemente (je ein Tool pro Typ)

Eingabe: add_dialog_textbox, add_dialog_textarea, add_dialog_date, add_dialog_decimal, add_dialog_email, add_dialog_note, add_dialog_checkbox
Auswahl: add_dialog_list, add_dialog_radio
Anzeige (read-only): add_dialog_text, add_dialog_attachment
Anhänge & Spezial: add_dialog_file, add_dialog_signature, add_dialog_barcode_scanner, add_dialog_phone_call, add_dialog_sms, add_dialog_users, add_dialog_job_functions, add_dialog_hidden
SQL-gestützte Felder: add_dialog_sql_textbox, add_dialog_sql_list, add_dialog_sql_checkbox, add_dialog_sql_table
Dekorativ & Aktion: add_dialog_description, add_dialog_button, add_dialog_blank, add_dialog_image, add_dialog_link, add_dialog_subtable_view
DMS-Viewer: add_dialog_dw_web_client_show_document, add_dialog_job_archive_show_document

Skripte & Logik

add_php_function · get_php_function · update_php_function · delete_php_function · list_php_functions — PHP-Funktionen für Rule-Conditions/Initialisierung/Box-Actions
add_dialog_script · get_dialog_script · update_dialog_script · delete_dialog_script · list_dialog_scripts — JS/CSS pro Dialog oder global

Reporting / jobselect-Ansichten

create_query · set_query_meta · set_query_sql · set_query_table — Ansicht anlegen und SQL/Tabelle konfigurieren
add_filter_field_text · _decimal · _date · _timestamp · _static_select · _sql_select — die 6 Filter-Typen
add_result_column — Ergebnis-Spalten (text/decimal/date/percent/image/ processdetails/jobarchive/dwwebclient)
add_result_column_script · add_result_script_param — klickbare Skript-Aktion in der Tabelle
bind_query_role — Rolle freischalten
get_query_collection · validate_collection · compile_collection — Stand prüfen, kompilieren, XML herunterladen
compile_query_dsl — komplette Ansicht als kompakte DSL-Source einreichen

Sonstiges

health — Verfügbarkeit prüfen

Wo landet die fertige Datei?

Modernere Chat-Programme (Claude Desktop ab Ende 2025, Claude Code, Cursor, …) zeigen die ZIP- oder XML-Datei direkt im Chat als Download-Button an — ein Klick, Datei ist im Download-Ordner. Du musst nichts kopieren oder Befehle eintippen.

Falls dein Chat-Programm das nicht beherrscht: Claude bekommt zusätzlich einen Download-Link in den Text und zeigt ihn dir. Der Link ist 60 Minuten gültig — anklicken, Datei landet im Browser-Download-Ordner.

Anschließend in deinem JobRouter unter Administration → Prozesse → Import bzw. Datenmanagement → Import einspielen.

Häufige Probleme

Im Chat erscheinen keine JRMT-Werkzeuge

Claude Desktop wirklich neu gestartet? Komplett beenden (Mac: ⌘+Q, Windows: Rechtsklick auf Taskleisten-Icon → Beenden) und wieder öffnen. Fenster schließen reicht oft nicht.
Datei am richtigen Ort? Die claude_desktop_config.json muss exakt im genannten Pfad liegen. Bei Zweifeln: in Claude Desktop unter Settings → Developer kannst du den genauen Pfad einsehen und sogar direkt öffnen.
JSON sauber formatiert? Ein fehlendes Komma oder eine fehlende Klammer bricht die ganze Datei. Wenn andere MCP-Server auch nicht mehr funktionieren, ist das oft die Ursache. Online-JSON-Validator (z.B. jsonlint.com) hilft beim Prüfen.
Version aktuell? HTTP-MCP-Support gibt's bei Claude Desktop erst seit Ende 2025. Update prüfen.

Claude sagt „Verbindung fehlgeschlagen"

Internetzugang vorhanden? Im Browser https://jrmt.winkels.io aufrufen — wenn die Seite kommt, erreichst du den Server.
Firewall? Manche Firmen-Netzwerke blocken ausgehende Verbindungen zu unbekannten Domains. Frag deine IT, ob jrmt.winkels.io auf Port 443 (HTTPS) erlaubt ist.
Server gerade nicht erreichbar? Wir sind ein Forschungsprojekt mit gelegentlichen Wartungen. Im Chat „Prüfe mit dem health-Tool, ob der JRMT-Server läuft" probieren.

Claude baut den Prozess, aber der Import in JR scheitert

JR-Version? JRMT erzeugt JR-2025.2-konforme Exports. Ältere JR-Versionen können einige Konstrukte ablehnen.
Validator-Hinweise gelesen? Claude sollte beim Compile sagen, ob der Validator Fehler oder Warnungen meldet. Frag explizit nach: „Sind beim Validator irgendwelche Issues aufgetaucht?"
Bestimmte Konstrukte noch experimentell? Manche Reporting-Spaltentypen (image, processdetails) sind nur rudimentär getestet. Falls etwas im Import streikt, schreib uns.

Antworten dauern sehr lange oder kommen nicht

Faire-Nutzungs-Limit: 300 Anfragen und 60 Compile-Vorgänge pro Minute und IP. Bei Überschreitung kommt eine 429-Antwort — eine Minute warten, dann geht es weiter.
Großer Prozess? Wenn du z.B. „Bau mir 50 Felder und 10 Schritte" sagst, dauert der Aufbau natürlich länger als ein Mini-Prozess.

Faire Nutzung & Datenschutz

Nutzungslimits: 300 API-Anfragen und 60 Compile-Vorgänge pro Minute und IP-Adresse. Bei Überschreitung kommt HTTP 429 zurück — kurz warten, dann geht es weiter. Melde dich, wenn du mehr brauchst.

Was wird gespeichert? Während du baust, hält der Server den aktuellen Stand deines Prozesses bzw. deiner Reporting-Ansicht in einer lokalen SQLite-Datenbank — damit du im Chat auch über mehrere Tage hinweg an dem gleichen Prozess arbeiten kannst. Keine Weitergabe an Dritte. Inhalte werden nicht von Anthropic gespeichert, sondern nur für die Werkzeug-Aufrufe an unsere API geschickt.

Forschungsprojekt: JRMT ist kein offiziell unterstütztes JobRouter-Produkt. Nutzung auf eigenes Risiko. Keine Verbindung zu Herstellern oder Markeninhabern verwandter Produkte.

Wer steckt dahinter

JRMT ist ein Gemeinschaftsprojekt von Daniel Winkels und Bernd Hüster. Es soll zeigen, was möglich ist, wenn JR konsequent als API-first behandelt und mit LLM-gestützten Werkzeugen kombiniert wird — vom leeren Skelett bis zur importfähigen ZIP, ohne den klassischen Designer.