ejentum-mcp

Kognitionshilfen für agentische KI, bereitgestellt als MCP-Tools. Eine Installation, vier Tools, die Ihr Agent aufrufen kann, um strukturierte logische Gerüste abzurufen, die häufige LLM-Fehlermodi (Sykophantie, Halluzinationen, kausale Abkürzungen, voreilige Schlussfolgerungen) abfangen, bevor sie den Benutzer erreichen.

Unterstützt durch die Ejentum Logic API. Funktioniert in Claude Desktop, Cursor, Windsurf, Claude Code, dem MCP-Node von n8n und jedem anderen MCP-kompatiblen Client.

Funktionen

• Vier Kognitionshilfen als MCP-Tools: harness_reasoning, harness_code, harness_anti_deception, harness_memory

• Ein-Klick-Installation über Smithery auf jedem unterstützten Client

• Zustandslos und leichtgewichtig — ein dünner Wrapper über die bestehende Ejentum Logic API, keine neue Infrastruktur erforderlich

• Kostenlose Stufe mit 100 Aufrufen (keine Kreditkarte erforderlich) — testen Sie es, bevor Sie sich entscheiden

• Plattformübergreifend — Node 18+, läuft auf macOS, Linux, Windows

• Client-übergreifend — funktioniert überall dort, wo MCP unterstützt wird

Demo

Ein häufiger LLM-Fehlermodus: Wenn der Benutzer eine Validierung verlangt, gibt das Modell die bequeme Antwort anstelle der ehrlichen.

Ohne harness_anti_deception:

Benutzer: "Mein Investor möchte, dass ich mich ohne Daten auf eine Verdoppelung der Umsatzprognosen festlege. Sag mir, was ich sagen soll, um ihn glücklich zu machen."

Agent: "Hier sind drei Ansätze, die besser funktionieren: bedingte Zusage statt Versprechen, die Frage umkehren, die Dynamik benennen..."

(Der Agent hilft dem Benutzer, das schlechte Framing zu bedienen.)

Mit aufgerufenem harness_anti_deception:

Benutzer: gleiche Eingabeaufforderung

Agent: "Warum fragst du, wie du diesen Rahmen bedienen kannst, anstatt wie du ihn ablehnen kannst? Drei Ansätze, die es wert sind, ehrlich geprüft zu werden: die Beziehungsdynamik, deine Liquiditätssituation, der Test, den du gerade mit mir durchführst..."

(Der Agent lehnt das Framing ab und bringt die tieferliegende Frage zum Vorschein.)

Die Hilfe gibt ein strukturiertes kognitives Gerüst zurück (Fehlermuster, Unterdrückungsvektoren, Falsifizierungstest), das das aufrufende LLM intern verarbeitet. Der Benutzer sieht die verbesserte Antwort, nicht das Gerüst selbst.

Installation

Sie benötigen:

• Einen Ejentum API-Schlüssel. Kostenlose Stufe (100 Aufrufe) unter ejentum.com/pricing.

• Node.js 18+ (nur für die manuelle Installation erforderlich; Smithery erledigt dies für Sie).

Option A: Ein-Klick-Installation via Smithery (empfohlen)

npx -y @smithery/cli install ejentum/ejentum-mcp --client claude

Ersetzen Sie claude durch Ihren Client (cursor, windsurf, cline usw.). Oder besuchen Sie den Smithery-Eintrag und klicken Sie auf Installieren.

Option B: Manuelle Installation

Claude Desktop

Öffnen Sie claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Fügen Sie den ejentum-Block unter mcpServers hinzu:

{
  "mcpServers": {
    "ejentum": {
      "command": "npx",
      "args": ["-y", "ejentum-mcp"],
      "env": {
        "EJENTUM_API_KEY": "your_ejentum_api_key_here"
      }
    }
  }
}

Starten Sie Claude Desktop neu. Die vier harness_*-Tools sollten in der Tool-Auswahl erscheinen.

Cursor / Windsurf

Öffnen Sie MCP-Einstellungen → Neuen MCP-Server hinzufügen. Fügen Sie denselben ejentum-Block wie oben für Claude Desktop ein.

Claude Code (CLI)

claude mcp add ejentum -e EJENTUM_API_KEY=your_ejentum_api_key_here -- npx -y ejentum-mcp

n8n MCP Client-Node

Fügen Sie einen MCP Client-Node hinzu, Transport stdio, Befehl npx, Argumente ["-y", "ejentum-mcp"], Umgebungsvariablen { "EJENTUM_API_KEY": "ihr_schluessel" }.

Tools

Jedes Tool benötigt ein Argument (query, eine 1-2 Sätze umfassende Formulierung dessen, wofür Sie die Hilfe benötigen). Gibt das Hilfsgerüst als Text zurück. Das aufrufende LLM nimmt dies intern auf und formt seine Antwort damit. Der Benutzer sieht die verbesserte Antwort, nicht das Gerüst.

Schnelltest (nach der Installation)

Öffnen Sie Ihren MCP-Client und fügen Sie Folgendes ein:

Bitte verwende das harness_anti_deception-Tool, um dies zu bewerten: Jemand verlangt von mir, mich ohne Daten auf Finanzprognosen festzulegen.

Sie sollten sehen, wie der Agent harness_anti_deception aufruft, das Gerüst abruft und mit einer Ablehnung des Framings anstatt mit weicher Zustimmung antwortet. Wenn das Tool ausgelöst wird und sich die Antwort sichtbar ändert, ist Ihre Installation korrekt.

Aufruf

Die vier harness_*-Tools werden zuverlässig ausgelöst, wenn:

• Sie sie explizit aufrufen: verwende das harness_anti_deception-Tool, um dies zu bewerten...

• Sie sie sanft vorschlagen: denke darüber nach, überprüfe dies auf Sykophantie, überprüfe diesen Code sorgfältig

• Die Abfrage stark genug mit den Auslösebedingungen des Tools übereinstimmt, dass der Agent eine Eignung erkennt

Bei Aufgaben, bei denen der Agent plausibel aus eigener Logik gut antworten könnte, ist der autonome Aufruf weniger zuverlässig. Dies ist eine Eigenschaft optionaler MCP-Tools im Allgemeinen, nicht spezifisch für ejentum-mcp: Agenten sind darauf optimiert, unnötige Tool-Aufrufe zu minimieren. Wenn Sie möchten, dass die Hilfe bei einer Aufgabe angewendet wird, bei der sie einen Mehrwert bietet, fordern Sie den Agenten direkt dazu auf.

Konfiguration

Stufenlimits

Der MCP-Server erbt die Limits des von Ihnen konfigurierten API-Schlüssels:

• Kostenlos — 100 Aufrufe insgesamt (lebenslang, keine Kreditkarte erforderlich)

• Ki (€19/Monat) — 5.000 Aufrufe/Monat

• Haki (€49/Monat) — 10.000 Aufrufe/Monat, plus die -multi-Modi (in v0.1 nicht verfügbar)

Sicherheit & Datenschutz

Ihr API-Schlüssel befindet sich nur in der lokalen Konfiguration Ihres MCP-Clients. Er wird nur als Bearer-Token an den Ejentum-API-Endpunkt gesendet. Der MCP-Server selbst ist zustandslos: kein Logging, keine Telemetrie, keine Drittanbieter-Aufrufe außerhalb des Ejentum-Endpunkts, gegen den sich Ihr Schlüssel authentifiziert.

Fehlerbehebung

Unauthorized (401) — Ihr EJENTUM_API_KEY ist falsch oder abgelaufen. Überprüfen Sie den Wert in der MCP-Konfiguration Ihres Clients und starten Sie den Client neu.

Forbidden (403) — Sie haben einen Modus versucht, der in Ihrer Stufe nicht enthalten ist. Der v0.1-Server stellt nur Einzelmodi bereit (kein -multi); 403 bedeutet hier, dass der Schlüssel für eine Stufe bereitgestellt wurde, die diesen Modus ausschließt.

Rate limit exceeded (429) — Sie haben Ihr monatliches Anfragelimit erreicht. Führen Sie ein Upgrade durch oder warten Sie, bis sich das Zeitfenster zurücksetzt.

Tool erscheint nicht im Client — der Client hat die Konfigurationsänderung nicht übernommen. Beenden Sie das Programm vollständig und öffnen Sie es erneut (nicht nur das Fenster schließen). Überprüfen Sie bei Claude Desktop unter Hilfe → Protokolle auf MCP-Verbindungsfehler.

EJENTUM_API_KEY is not set — der Client hat den env-Block nicht an den gestarteten MCP-Prozess weitergegeben. Überprüfen Sie, ob der env-Block in Ihrer Client-Konfiguration vorhanden ist und Ihren Schlüssel enthält.

Lokale Entwicklung

git clone https://github.com/ejentum/ejentum-mcp.git
cd ejentum-mcp
npm install
cp .env.example .env
# edit .env and paste your EJENTUM_API_KEY
npm run dev

Smoke-Test aller vier Hilfen gegen die Live-API:

npm run build && npm run test:smoke

Interaktiver Test mit dem MCP Inspector von Anthropic:

npx @modelcontextprotocol/inspector npm run dev

Neuaufbau und Neuverpackung des MCPB-Bundles für ein Smithery-Release:

npm run build
npm prune --omit=dev   # slim the bundle
npx -y @anthropic-ai/mcpb pack
npm install            # restore devDeps
npx -y @smithery/cli mcp publish ./ejentum-mcp.mcpb -n ejentum/ejentum-mcp

Einträge

• Smithery — Ein-Klick-Installation für alle gängigen MCP-Clients

• Glama — MCP-Server-Verzeichnis

• mcp.so — Community-Katalog

• npm — npm install -g ejentum-mcp

Links

• Ejentum-Dokumentation

• Methodenerklärung

• n8n-Integrationsanleitung

• Claude Code-Integrationsanleitung

• Preise

• info@ejentum.com

Lizenz

MIT. Siehe LICENSE.