ELO ECM

io.github.Herzog-GmbHPublished by GitHub account Herzog-GmbHv0.6.0Updated Nov 1, 2026

ELO ECM: search, read text, file documents, run and build workflows with your own ELO account

VerifiedSTDIODesktop onlyProductivity & WorkflowKnowledge & Memory

Overview

AI-generated overview

Local MCP server for the ELO ECM Suite that lets an assistant search, read, file documents and run or build workflows using the user's own ELO account.

What you can do
  • Search and inspect the archive: full-text and field search, folder listings, object metadata, versions and effective user rights
  • Extract text from PDF, Office, e-mail and text files, with paging through long documents
  • Read workflows: templates, running and finished workflows, workflows of one object, own tasks, and export a template as a JSON plan
  • File and change documents (write level): create folders, file local files, add versions, set index fields
  • Run workflows (write level): start a workflow from a template and forward tasks
  • Build (build level): create or replace workflow templates, create and update ELOas rules, IX scripts and form pages with syntax checks
When to use it
Useful when an ELO ECM archive is in daily use and you want an assistant to answer questions about documents, tasks and workflows, or to file and index documents and drive approvals under your own permissions. Building workflows and scripts is meant for test archives first.
Requirements
Windows 10/11 with Windows PowerShell 5.1, an installed ELO Client 25 or ELO Java Client, and an ELO index server (tested with 25.00). The IX URL is passed as a switch or via the ELO_IX_URL environment variable; credentials are stored once with a separate script, encrypted with DPAPI. For https the server certificate must be trusted in the Windows certificate store. Write and build tools only appear when enabled with switches.
Before you install
The server signs in with your own ELO account, so the assistant can do whatever that account may do; each session opens its own IX connection, which may consume an additional ELO licence. Write and build levels change archive data, and build changes are best tried on a test archive. Every write needs a preview plus a one-time token, but previews should be read before confirming. Document text can contain prompt injection. Executions are logged locally with account, tool and arguments…

Installation

In SourceWeft

  1. Open ELO ECM in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

ELO-MCP-Server

ELO für jede KI: suchen, lesen, ablegen, Workflows steuern und bauen, mit den Rechten des eigenen ELO-Kontos.

[Getestet mit ELO 25] [MCP stdio] [22 Werkzeuge] [Vorschau und Token]
[Windows] [Lizenz MIT]

Schnellstart · Werkzeuge · Sicherheit · Clients · Bauplan · IX-Fallen

[!NOTE] English: MCP server for the ELO ECM Suite (ELO Digital Office). Runs locally next to the ELO Client (ELO 25) or ELO Java Client and signs in with the user's own ELO account, so ELO enforces that user's permissions. Beyond search and text extraction it can file documents, set index fields, start and forward workflows, and (optionally) build workflow templates and ELOas rules/IX scripts with syntax checks. Every write is a two-step preview + one-time token. Docs are in German because ELO's user base is mostly DACH; issues in English are welcome.

Ein MCP-Server für das ELO ECM der ELO Digital Office GmbH. Ihr fragt in normaler Sprache, etwa „Zeig mir die offenen Aufgaben zu Rechnung 4711" oder „Bau mir eine Freigabe-Vorlage mit zwei parallelen Prüfern", und die KI arbeitet direkt mit eurem Archiv.

Auf einen Blick

  • Jeder MCP-Client: Claude Code, Claude Desktop, Codex, GitHub Copilot, Gemini CLI, Cursor, … (docs/CLIENTS.md)
  • Rechte je Person: Der Server läuft lokal beim Anwender und meldet sich mit dessen eigenem ELO-Konto an. ELO prüft jeden Zugriff selbst. Kein Dienstkonto, kein Nachbau von Rechten.
  • Mehr als Suchen: Volltext- und Feldsuche, Textauszug aus PDF/Office/E-Mail, wirksame Rechte mit Herkunft, Workflows lesen, starten und weiterleiten.
  • Bauen mit Prüfungen: Workflow-Vorlagen als JSON-Bauplan exportieren, ändern und zurückschreiben. ELOas-Regeln, IX-Skripte und Formularseiten hochladen, vorher kompiliert und auf bekannte Fallen geprüft.
  • Drei Stufen: Lesen ist immer an. Schreiben (-Schreiben) und Bauen (-Bauen) schaltet ihr einzeln frei. Ohne Schalter sieht die KI die Werkzeuge gar nicht.
  • Zweistufig schreiben: Jede Änderung liefert zuerst eine Vorschau und ein Einmal-Token. Erst ein zweiter Aufruf mit Token führt aus.
  • Schonend für den Indexserver: eine Anfrage zur Zeit, harte Obergrenzen, keine Massenabfragen über Workflows.
  • Keine zusätzlichen Downloads: nutzt Java, Rhino, IX-Client-Bibliothek, PDFBox und POI aus dem installierten ELO Client bzw. ELO Java Client.

Voraussetzungen

Getestet bzw. vorausgesetzt
ELO-ServerIndexserver 25.00 (ELO 25). Ältere Versionen mit Java-API sollten gehen, sind aber nicht geprüft.
ELO Clientinstalliert auf dem Rechner, auf dem die KI läuft: der ELO Client 25 oder der ältere ELO Java Client. Getestet gegen Indexserver 25.00 mit dem ELO Client 25 (IX-Client-Bibliothek 25.00, Rhino 1.9, PDFBox 3) und mit dem ELO Java Client (IX-Client-Bibliothek 20.09). Gesucht wird unter Programme\ELO Client, dann Programme\ELO Java Client, sonst -ClientDir.
WindowsWindows 10/11 mit Windows PowerShell 5.1 (powershell.exe). PowerShell 7 reicht nicht, der Vorschalt braucht System.Web.Extensions.
ELO-Kontoein normales Benutzerkonto. Die KI kann genau das, was das Konto darf.
ZertifikatBei https muss das Server-Zertifikat im Windows-Zertifikatsspeicher vertrauenswürdig sein (Java nutzt Windows-ROOT).

[!IMPORTANT] Jede Sitzung baut eine eigene IX-Verbindung mit eurem Konto auf (Client-Name elo-mcp). Ob das bei euch eine zusätzliche ELO-Lizenz belegt, klärt bitte mit eurem ELO-Partner.

Schnellstart

  1. Holen, z. B. nach C:\Tools\elo-mcp:
    powershell
    git clone https://github.com/Herzog-GmbH/elo-mcp.git C:\Tools\elo-mcp
  2. Zugangsdaten hinterlegen, einmalig und selbst im Terminal (nicht von der KI eintippen lassen). Das Passwort wird per DPAPI für euer Windows-Konto verschlüsselt:
    powershell
    powershell -NoProfile -ExecutionPolicy Bypass -File C:\Tools\elo-mcp\Set-EloCredential.ps1
  3. Prüfen, ohne ELO-Verbindung:
    powershell
    powershell -NoProfile -ExecutionPolicy Bypass -File C:\Tools\elo-mcp\test\offline.ps1
  4. Eintragen, hier in Claude Code (andere Clients: docs/CLIENTS.md). Die IX-URL steht im Anmeldeprofil des ELO Java Client oder kommt von eurem ELO-Administrator:
    powershell
    claude mcp add elo --scope user -- powershell -NoProfile -ExecutionPolicy Bypass -File "C:\Tools\elo-mcp\elo-mcp.ps1" -IxUrl "https://elo.example.com:9093/ix-Archiv/ix"
  5. Testen: In einer neuen Sitzung „Wer bin ich in ELO?" fragen. Das ruft elo_whoami auf und zeigt Konto, Server, IX-Version und freigeschaltete Stufen.

Ihr wollt, dass eure KI das selbst einrichtet? Gebt ihr diesen Satz: „Richte den ELO-MCP-Server nach der AGENTS.md in diesem Ordner ein."

Claude Desktop: als Paket installieren

Für Claude Desktop gibt es den Server auch als Paket (MCPB), ohne Git und ohne Konfigurationsdatei:

  1. Aus dem neuesten Release elo-mcp-<version>.mcpb und Set-EloCredential.ps1 laden.
  2. Zugangsdaten hinterlegen, selbst im Terminal:
    powershell
    powershell -NoProfile -ExecutionPolicy Bypass -File "$env:USERPROFILE\Downloads\Set-EloCredential.ps1"
  3. In Claude Desktop unter Einstellungen → Erweiterungen → Erweiterte Einstellungen → Erweiterung installieren (Settings → Extensions → Advanced settings → Install Extension) die .mcpb-Datei wählen.
  4. IX-URL eintragen. Schreiben und Bauen nur bei Bedarf einschalten. Zugangsdatei und Client-Ordner bleiben leer, solange ihr die Standards nutzt. Für ein zweites Archiv (z. B. Test) die Felder „Archiv 2“ ausfüllen und beiden Archiven einen Kurznamen geben, siehe Zwei Archive.
  5. In einem neuen Chat „Wer bin ich in ELO?" fragen.

Im Paket stecken nur die Skripte aus diesem Repo (rund 70 KB). Java und die ELO-Bibliotheken kommen wie sonst aus dem installierten ELO Client. Für ein Update installiert ihr einfach die neue .mcpb.

Schalter

Alle Schalter stehen hinter dem Skriptpfad in der Client-Konfiguration.

SchalterWirkung
-IxUrl <url>IX-URL des ELO-Servers (Pflicht, alternativ Umgebungsvariable ELO_IX_URL)
-SchreibenStufe 2 freischalten: ablegen, neue Version, Indexfelder, Workflow starten, Aufgabe weiterleiten
-BauenStufe 3 freischalten: Workflow-Vorlagen, Skripte, ELOas-Regeln, Formularseiten. Am besten nur gegen ein Testarchiv.
-CredentialFile <pfad>andere Zugangsdaten, z. B. ein zweites Konto für das Testarchiv. Standard %LOCALAPPDATA%\elo-mcp\elo-credential.xml
-ClientDir <pfad>Ordner des ELO Client bzw. ELO Java Client, wenn er nicht unter Programme liegt
-Archiv "<name>"Name des Archivs in den Hinweisen an die KI, z. B. "der Muster GmbH (Test)"
-TextDatumJJJJMMTTHausregel mancher Archive: Textfelder, deren Name auf DAT/DATUM endet, bekommen Datumsangaben als JJJJMMTT
-LeerlaufMinuten <n>Java nach so vielen Minuten ohne Aufruf beenden (Standard 10, nicht unter 5)
-Direktohne Vorschalt, Java sofort starten (Rückfall bei Problemen, nur ein Archiv)
-IxUrl2 <url>zweites Archiv, z. B. das Testarchiv (siehe unten)
-Name <name>, -Name2 <name>Kurznamen der beiden Archive für den Parameter archiv, z. B. Produktiv und Test (Standard 1 und 2)
-Schreiben2, -Bauen2Stufen nur für das zweite Archiv
-CredentialFile2 <pfad>, -Archiv2 "<name>"Zugangsdaten (Standard: dieselben wie fürs erste) und Archivname für das zweite Archiv

Zwei Archive

Ein Eintrag kann zwei Archive bedienen, z. B. Produktiv nur lesend und Test mit allen Stufen:

powershell
claude mcp add elo --scope user -- powershell -NoProfile -ExecutionPolicy Bypass -File "C:\Tools\elo-mcp\elo-mcp.ps1" -IxUrl "https://elo.example.com:9093/ix-Archiv/ix" -Name Produktiv -IxUrl2 "https://elo-test.example.com:9093/ix-Archiv/ix" -Name2 Test -Schreiben2 -Bauen2
  • Jedes Werkzeug hat dann den Parameter archiv (Produktiv oder Test). Ohne Angabe gilt das erste Archiv. Ihr sagt der KI einfach „im Test“ oder „in Produktiv“.
  • Die Stufen gelten je Archiv. Im Beispiel kann die KI in Produktiv nichts ändern, auch wenn sie es versucht. Schreib- und Bauwerkzeuge sagen in ihrer Beschreibung, in welchem Archiv sie gehen.
  • Jedes Archiv läuft in einem eigenen Java-Prozess, der erst beim ersten Aufruf startet. Verbindungen, Zwischenspeicher und Tokens mischen sich nicht. Ein Token aus einer Vorschau im Test wirkt nie in Produktiv.
  • elo_whoami, jede Vorschau und das Protokoll nennen das Archiv. Objekt-IDs, Masken und Vorlagen gelten nur im jeweiligen Archiv.

Werkzeuge

Stufe 1: lesen (immer an)

WerkzeugZweck
elo_whoamiKonto, Server, IX-Version, freigeschaltete Stufen
elo_searchiSearch über Titel, Volltext und Indexfelder, optional auf einen Ordner samt Unterordnern begrenzt, höchstens 50 Treffer
elo_find_by_fieldsDatenbanksuche über Maske und Indexfelder, Platzhalter *. Ohne Feld oder Namen abgelehnt
elo_listOrdnerinhalt, eine Ebene, höchstens 300
elo_get_objectMetadaten, Indexfelder mit Bezeichnung, Pfad, aktuelle Version, elodms://-Link
elo_get_versionsVersionsliste, neueste zuerst
elo_get_textText aus PDF (mit Textebene), DOCX, XLSX, PPTX, XLS, EML und Textdateien, höchstens 50.000 Zeichen je Aufruf, Weiterlesen mit abZeichen
elo_user_rightsWirksame Funktionsrechte eines Benutzers mit Herkunft (direkt oder über welche Gruppe, auch verschachtelt)
elo_workflow_templatesAlle Workflow-Vorlagen
elo_workflowVorlage oder laufender/beendeter Workflow im Detail: Knoten, Bearbeiter, Skripte, Formular, JSON-Konfiguration, Verbindungen
elo_workflows_of_objectLaufende (mit aktiven Knoten) oder beendete Workflows zu genau einem Objekt
elo_my_tasksEigene Aufgaben, auch über Gruppen
elo_workflow_exportVorlage als JSON-Bauplan (Format)

Stufe 2: arbeiten (-Schreiben)

WerkzeugZweck
elo_create_folderOrdner anlegen (nur Ordnermasken), warnt bei gleichem Namen und leeren Pflichtfeldern
elo_create_documentLokale Datei als Dokument ablegen (nur Dokumentmasken), höchstens 50 MB
elo_new_versionNeue Version. Lehnt eine identische Datei ab, warnt bei anderer Endung
elo_set_fieldsIndexfelder und Kurzbezeichnung setzen, Vorschau bisher → neu
elo_start_workflowWorkflow aus Vorlage starten, warnt, wenn dieselbe Vorlage schon läuft
elo_forward_taskAufgabe weiterleiten. Bei mehreren Nachfolgern Pflichtangabe. Knoten mit Formular nur mit trotzFormular, weil Formularprüfungen über die API nicht laufen

Feldwerte werden vorher gegen die Maske geprüft: Feld vorhanden, Länge, Zahl, Datum (31.02. wird abgelehnt), Stichwortliste bei „nur Liste". Datumsfelder schreibt der Server im ELO-Format JJJJMMTT000000.

Stufe 3: bauen (-Bauen)

WerkzeugZweck
elo_workflow_buildVorlage aus Bauplan anlegen oder ersetzen (ID und Name bleiben). Vorschau mit Änderungsliste, Sicherung .ewf vorher und nachher
elo_script_updateNeue Version eines Dokuments unter Administration (ELOas-Regel, IX-Skript, Formularseite …), Vorschau mit Zeilenvergleich, Kodierung bleibt
elo_script_createNeues Dokument unter Administration, Maske, Rechte und Typ vom Vorbild

Die Prüfungen beim Bauen stammen alle aus echten Störungen:

  • Workflows: genau ein Start, mindestens ein Ende, alle Kanten auf vorhandene Knoten, jeder Knoten erreichbar und mit Weg zum Ende, jeder Knoten außer Ende hat einen Nachfolger (sonst bleibt der Vorgang hängen), Entscheidung mit Bedingung, Sammler mit festem Zähler (0 leitet beim ersten Vorgänger weiter, -1 bleibt nach übersprungenen IF-Zweigen hängen), Bearbeiter und Formulare existieren.
  • ELOas-Regeln: XML wohlgeformt, jeder Skriptteil wird mit Rhino kompiliert.
  • IX-Skripte: kompiliert, jeder //@include ist auflösbar, @include steht nur in den Kopfzeilen, nur ASCII. Ein nicht auflösbarer Include stoppt sonst den ganzen Skript-Motor des Indexservers.

Neu laden (ELOas, IX-Skripte) und „Aktualisieren" im Formulardesigner bleiben Handarbeit. Das sagt der Server nach jeder Änderung dazu.

Sicherheit

  • Eigenes Konto: ELO prüft jeden Zugriff mit den Rechten der angemeldeten Person. Ein zentraler Server bräuchte ein Dienstkonto mit Hauptadministrator-Recht: Die Anmeldung im Namen anderer (runAsUser) lehnt der Indexserver für normale Konten ab. Ein solches Konto vermeidet dieser Server bewusst, er läuft lokal mit dem Konto der Person.
  • Zugangsdaten: per DPAPI verschlüsselt, nur für euer Windows-Konto lesbar. Der Vorschalt entschlüsselt sie erst beim Java-Start und gibt sie nur an den Java-Prozess weiter.
  • Zweistufig: Erster Aufruf = Prüfung + Vorschau + Token. Das Token gilt 5 Minuten, einmal, nur für exakt dieselben Argumente und nur, wenn sich das Objekt seit der Vorschau nicht verändert hat (Fingerabdruck aus Name, Maske, Indexfeldern, Sperre, Version). Die Hinweise an die KI verlangen, die Vorschau zu zeigen und auf Zustimmung zu warten.
  • Nicht im Code: Löschen, Verschieben, Rechte und Masken ändern. Das ist nicht abgeschaltet, das gibt es schlicht nicht.
  • Protokoll: Jede Ausführung, auch fehlgeschlagene, steht in %LOCALAPPDATA%\elo-mcp\protokoll-JJJJ-MM.jsonl (Zeit, Konto, Server, Werkzeug, Argumente, Ergebnis).
  • Keine Wiederholung beim Schreiben: Lesewerkzeuge melden sich nach einer abgelaufenen Sitzung einmal neu an. Schreibende nie, damit nichts doppelt passiert.
  • Fremder Text: Dokumentinhalte (elo_get_text) können Anweisungen an die KI enthalten (Prompt-Injection). Lest deshalb jede Vorschau, bevor ihr zustimmt.

Start und Speicher

MCP-Clients starten jeden Server einmal je Sitzung. Eine JVM je Sitzung kostet rund 650 MB, auch wenn ELO nie gebraucht wird. Deshalb steht elo-mcp.ps1 als schlanker Vorschalt (rund 75 MB) vor Java:

  • initialize, tools/list und ping beantwortet der Vorschalt aus %LOCALAPPDATA%\elo-mcp\werkzeuge-<hash>.txt. Nach einer Änderung an Code oder Schaltern holt die erste Sitzung die Liste einmal von Java.
  • Java startet erst beim ersten Werkzeugaufruf (2–8 s) und endet nach 10 Minuten ohne Aufruf. Die JVM läuft mit -XX:+UseSerialGC -Xms32m -XX:TieredStopAtLevel=1 (rund 90–130 MB). Bei zwei Archiven gilt das je Archiv.

Grenzen

  • Nur Windows und nur stdio (kein HTTP-Server). Der Kern unter src\ läuft überall, wo Rhino und die IX-Client-Bibliothek laufen. Ein Startskript für andere Systeme gibt es noch nicht.
  • Kein Text aus .doc, .msg und Scans ohne Textebene (kein OCR).
  • Links nur als elodms://(GUID) für den Java Client, noch nicht für den Web Client.
  • Beim Bauen nur die Knotentypen 1–6 (Start, Person, Verteiler, Entscheidung, Sammler, Ende). Vorlagen mit Zyklus, Serverübergabe oder Subworkflow lassen sich exportieren, aber nicht zurückschreiben.
  • Kein Neuladen von ELOas/IX-Skripten und kein Veröffentlichen.

Aufbau

DateiZweck
elo-mcp.ps1Startskript und Vorschalt
Set-EloCredential.ps1Zugangsdaten verschlüsselt hinterlegen
src/elo.jsIX-Verbindung, Archivpfade
src/elo-mcp.jsKern, Protokoll, Textauszug, Stufe 1
src/elo-mcp-schreiben.jsStufe 2, Vorschau/Token, Feldprüfung, Protokoll
src/elo-mcp-bauen.jsStufe 3, Bauplan, Skriptprüfungen
src/elo-mcp-start.jsHauptschleife
test/offline.ps1Prüfungen ohne ELO (Protokoll, Stufen, Bauplan, Skripte)
test/test-mcp.pyAufrufe gegen ein echtes ELO, z. B. python -I test\test-mcp.py test\beispiel-lesen.json -- -IxUrl <url>
mcpb/Paket für Claude Desktop: manifest.json, Startskript mcpb-start.ps1 (Einstellungen → Schalter), Symbol
tools/build-mcpb.ps1baut dist\elo-mcp-<version>.mcpb und trägt Prüfsumme und Download-URL in server.json ein
server.jsonEintrag für die MCP Registry
test/test-mcpb.pystartet das gebaute Paket wie Claude Desktop, z. B. python -I test\test-mcpb.py dist\elo-mcp-0.5.0.mcpb -- ix_url=<url>

Fallen der IX-API, auf die wir beim Bau gestoßen sind, stehen in docs/FALLEN.md.

Mitmachen

Issues und Pull Requests sind willkommen, gern auch mit Erfahrungen aus anderen ELO-Versionen. Bitte keine internen Daten (Hostnamen, Benutzer, Objekt-IDs, Mandantennamen) in Issues, Logs oder Testdateien. Vor einem Pull Request test\offline.ps1 laufen lassen. Sicherheitslücken bitte nicht öffentlich melden, sondern wie in SECURITY.md beschrieben.

Lizenz und Marken

MIT, siehe LICENSE. Ohne Gewähr: Probiert Schreiben und Bauen zuerst an einem Testarchiv aus.

Dies ist kein Produkt der ELO Digital Office GmbH und wird von ihr weder unterstützt noch geprüft. ELO ist eine Marke der ELO Digital Office GmbH. Die ELO-Bibliotheken sind nicht Teil dieses Repos und nicht im Paket. Sie kommen aus eurem lizenzierten ELO Java Client.

Source: README.md at commit c76c80e

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.6.0LatestOct 18, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts