eluna-gateway · Tool-Katalog

Was dieser Gateway an MCP-Tools bereitstellt. Live aus dem Server abgefragt.

Nur-Lese-Übersicht. Diese Seite verwaltet nichts — kein Admin, keine Auth-Konfiguration, keine Schreibaktion. Der Gateway entscheidet und routet; Autorität liegt bewusst nicht in dieser Oberfläche.
MCP-Endpunkt (Streamable HTTP): POST /mcp — hier sprechen Clients das Protokoll. Diese Seite ist nur die menschliche Übersicht.

elunaapp read-only 22 Tools

elunaapp_list_bereicheBereiche auflisten

Bereiche des Tenants (id, name, modus). Ohne Parameter.

keine Parameter
elunaapp_list_automationsAutomationen eines Bereichs

Automationen, die an einen Bereich gebunden sind.

ParameterTypBeschreibung
bereichId• string Bereichs-ID (Pflicht)
detail boolean
elunaapp_get_automationAutomation lesen

Eine Automation inkl. instruction, prePromptSnapshot, lastRun.

ParameterTypBeschreibung
id• string Automations-ID
elunaapp_automation_runsAutomations-Runs

Tatsächliche Läufe (Traces) mit Status, artifactUrl, Verbrauch.

ParameterTypBeschreibung
id• string Automations-ID
limit integer
offset integer
elunaapp_automation_runAutomations-Run-Detail

Ein einzelner Lauf: output, events, Live-Verbrauch.

ParameterTypBeschreibung
id• string Automations-ID
traceId• string Trace-/Run-ID
elunaapp_automation_sopsSOPs einer Automation

SOPs, die eine Automation nutzt (Volltext, bereich vs. company).

ParameterTypBeschreibung
id• string Automations-ID
elunaapp_list_sopsSOPs auflisten (kompakt)

SOPs des Tenants, kompakt (ohne Volltext).

ParameterTypBeschreibung
bereichId string optional auf einen Bereich einschränken
elunaapp_get_sopSOP lesen

Eine SOP mit Volltext.

ParameterTypBeschreibung
id• string SOP-ID
elunaapp_create_bereichBereich anlegen (WRITE)

Legt einen Bereich für den Tenant an. Nur bei aktiviertem Write-Modus.

ParameterTypBeschreibung
name• string Name (Pflicht)
modus string simulation/supervised/production/live
elunaapp_create_automationAutomation anlegen (WRITE)

Erzeugt aus einer NL-Anweisung eine fertige, aktivierte Automation. Nur bei aktiviertem Write-Modus.

ParameterTypBeschreibung
bereichId• string Bereichs-ID (Pflicht)
instruction• string natürlichsprachige Anweisung (Pflicht)
cron string optionaler Zeitplan
elunaapp_update_automationAutomation aktualisieren (WRITE)

Ändert instruction/Zeitplan/aktiviert. Mindestens ein Feld. Nur bei aktiviertem Write-Modus.

ParameterTypBeschreibung
id• string Automations-ID
instruction string
cron string | null null = Zeitplan entfernen
isEnabled boolean
elunaapp_trigger_automationAutomation auslösen (WRITE)

Startet einen Automations-Lauf manuell (async). Nur bei aktiviertem Write-Modus.

ParameterTypBeschreibung
id• string Automations-ID
elunaapp_optimize_automationAutomation optimieren (WRITE)

KI-optimiert die Automation und wendet SOP-Änderungen direkt an. Nur bei aktiviertem Write-Modus.

ParameterTypBeschreibung
id• string Automations-ID
instruction• string Optimierungs-Anweisung (Pflicht)
elunaapp_create_sopSOP anlegen (WRITE)

Legt eine SOP an, bindet sie an einen Bereich, rendert Pre-Prompts neu. Nur bei aktiviertem Write-Modus.

ParameterTypBeschreibung
bereichId• string Bereichs-ID (Pflicht)
name• string Name (Pflicht)
content• string Markdown-Inhalt (Pflicht)
summary string
tags array
elunaapp_update_sopSOP aktualisieren (WRITE)

Teil-Update einer SOP. Mindestens ein Feld. Nur bei aktiviertem Write-Modus.

ParameterTypBeschreibung
id• string SOP-ID
name string
summary string
content string
tags array
elunaapp_update_bereichBereich ändern (WRITE)

Ändert einen Bereich (Name, Modus, Typ, Eltern-Gruppe, SOP-Einstellungen). Modus-Wechsel triggert Pre-Prompt-Resync. Nur bei aktiviertem Write-Modus.

ParameterTypBeschreibung
id• string Bereichs-ID
name string
modus string
typ string
parentId string | null Eltern-Gruppe; null = aus Gruppe lösen
sopScopeMode string
includeCompanySops boolean
includePersonalSops boolean
elunaapp_delete_bereichBereich löschen (WRITE)

Löscht einen Bereich. SCHUTZ: ohne exaktes `confirmName` (= Bereichsname) wird abgelehnt. `dryRun:true` liefert nur die Vorschau. `strategy` steuert Unterbereiche (cascade=mitlöschen, reparent=hochziehen). Nur bei aktiviertem Write-Modus.

ParameterTypBeschreibung
id• string Bereichs-ID
confirmName string exakter Bereichsname (Pflicht zum echten Löschen)
dryRun boolean true = nur Vorschau, nicht löschen
strategy string Default cascade
elunaapp_automation_linksBereich-Automation-Links prüfen

Prüft die am Bereich verlinkten Automationen live (ok/missing/error) und meldet verwaiste IDs (orphanedAutomationIds).

ParameterTypBeschreibung
id• string Bereichs-ID
elunaapp_automation_links_cleanupVerwaiste Automation-Links entfernen (WRITE)

Entfernt verwaiste Automation-Verknüpfungen eines Bereichs. Ohne automationIds werden alle fehlenden entfernt; mit Liste nur diese (müssen verlinkt sein). Nur bei aktiviertem Write-Modus.

ParameterTypBeschreibung
id• string Bereichs-ID
automationIds array gezielt diese IDs; weglassen = alle fehlenden
elunaapp_connectionsBereich-Connections auflisten

Alle bekannten Connections mit Markierung, welche am Bereich verlinkt sind (linked). Optionaler Suchfilter q.

ParameterTypBeschreibung
id• string Bereichs-ID
q string Suchfilter
elunaapp_set_connectionsBereich-Connections setzen (WRITE)

Setzt die verlinkten Connections eines Bereichs als VOLLSTÄNDIGE Liste (nicht additiv). Triggert Pre-Prompt-Resync der Bereichs-Automationen. Zum Hinzufügen/Entfernen einzelner: erst elunaapp_connections lesen, Liste anpassen, hier setzen. Nur bei aktiviertem Write-Modus.

ParameterTypBeschreibung
id• string Bereichs-ID
connectionIds• array vollständige Liste der zu verlinkenden Connection-IDs
elunaapp_trigger_automation_with_contextAutomation mit Kontext auslösen (WRITE)

Startet einen Automations-Lauf mit einmalig injiziertem Kontext (Feld `context`, Pflicht). Nur bei aktiviertem Write-Modus.

ParameterTypBeschreibung
id• string Automations-ID
context• string einmaliger Kontext für diesen Lauf (Pflicht)

artifacts read-only 6 Tools

artifacts_listArtefakte auflisten

Liste der Artefakte (paginiert, Inhalt gekürzt als Vorschau).

ParameterTypBeschreibung
limit integer max. Treffer (Default 20)
offset integer Offset für Paginierung
artifacts_getArtefakt lesen

Ein Artefakt mit vollem Inhalt über seine ID.

ParameterTypBeschreibung
id• string Artefakt-ID
artifacts_versionsArtefakt-Versionen

Alle Versionen eines Artefakts.

ParameterTypBeschreibung
id• string Artefakt-ID
artifacts_get_versionArtefakt-Version lesen

Snapshot einer bestimmten Version eines Artefakts.

ParameterTypBeschreibung
id• string Artefakt-ID
version• integer Versionsnummer
artifacts_createArtefakt anlegen (WRITE)

Legt ein Artefakt an. Braucht content ODER link. Live-Artefakt: contentType live, vollständiges HTML als content, Datenquellen in metadata.live. Nur wirksam bei aktiviertem Write-Modus (ELUNA_ALLOW_WRITES).

ParameterTypBeschreibung
name• string Anzeigename (Pflicht)
content string Inhalt (content ODER link Pflicht)
link string externe URL statt Inhalt
contentType string MIME-Klasse des Inhalts; live = HTML-Seite, die bei jedem Aufruf aktuelle Daten liest (braucht metadata.live)
fileName string
metadata object beliebige JSON-Metadaten. Bei contentType live Pflicht: {"live":{"version":1,"sources":{"<schlüssel>":{"module":"workloads"|"app","path":"…","query":{…}}}}}. Erlaubte Pfade: workloads /api/v1/workloads, /api/v1/types, /api/v1/workloads/{id}; app /api/ext/v1/bereiche/{id}/vorgaenge|prozess-laeufe|hitl-gates. Höchstens 10 Quellen, nur GET.
isPublic boolean öffentlich zugänglich machen
artifacts_updateArtefakt aktualisieren (WRITE)

Teil-Update eines Artefakts. Nur bei aktiviertem Write-Modus.

ParameterTypBeschreibung
id• string Artefakt-ID
name string
content string
link string
contentType string MIME-Klasse des Inhalts; live = HTML-Seite, die bei jedem Aufruf aktuelle Daten liest (braucht metadata.live)
fileName string
metadata object beliebige JSON-Metadaten. Bei contentType live Pflicht: {"live":{"version":1,"sources":{"<schlüssel>":{"module":"workloads"|"app","path":"…","query":{…}}}}}. Erlaubte Pfade: workloads /api/v1/workloads, /api/v1/types, /api/v1/workloads/{id}; app /api/ext/v1/bereiche/{id}/vorgaenge|prozess-laeufe|hitl-gates. Höchstens 10 Quellen, nur GET.
isPublic boolean

sandbox read-only 11 Tools

sandbox_contextSandbox-Kontext

Kontext der Sandbox des Tenants (Apps/Übersicht). Ohne Parameter.

keine Parameter
sandbox_appsSandbox-Apps auflisten

Alle Sandbox-Apps des Tenants. Ohne Parameter.

keine Parameter
sandbox_app_getSandbox-App lesen

Eine Sandbox-App über ihre ID.

ParameterTypBeschreibung
id• string App-ID
sandbox_app_documentsSandbox-App-Dokumente

Dokumente einer Sandbox-App.

ParameterTypBeschreibung
id• string App-ID
sandbox_document_contentSandbox-Dokument-Inhalt

Inhalt eines Sandbox-Dokuments über seine ID.

ParameterTypBeschreibung
id• string Dokument-ID
sandbox_app_createSandbox-App anlegen (WRITE)

Legt eine Sandbox-App an. Nur bei aktiviertem Write-Modus.

ParameterTypBeschreibung
name• string Name (Pflicht)
description string
icon string Icon-Key (Default 'custom')
sandbox_app_updateSandbox-App aktualisieren (WRITE)

Teil-Update einer Sandbox-App. Nur bei aktiviertem Write-Modus.

ParameterTypBeschreibung
id• string App-ID
name string
description string
icon string
sandbox_app_deleteSandbox-App löschen (WRITE)

Löscht eine Sandbox-App inkl. ihrer Dokumente. Nur bei aktiviertem Write-Modus.

ParameterTypBeschreibung
id• string App-ID
sandbox_add_text_documentSandbox-Text-Dokument anlegen (WRITE)

Legt ein Text-Dokument in einer Sandbox-App an (max 5 MB). Nur bei aktiviertem Write-Modus.

ParameterTypBeschreibung
id• string App-ID
name• string Dokumentname (Pflicht)
content• string Textinhalt (Pflicht)
description string
sandbox_document_updateSandbox-Dokument aktualisieren (WRITE)

Teil-Update eines Sandbox-Dokuments (content nur bei Text-Dokumenten). Nur bei aktiviertem Write-Modus.

ParameterTypBeschreibung
id• string Dokument-ID
name string
description string
content string
sandbox_document_deleteSandbox-Dokument löschen (WRITE)

Löscht ein Sandbox-Dokument. Nur bei aktiviertem Write-Modus.

ParameterTypBeschreibung
id• string Dokument-ID

apps read-only 16 Tools

apps_listApps auflisten

Alle eluna Apps des Tenants (mit Adresse, Art, aktiver Version, Rollen). Ohne Parameter.

keine Parameter
apps_getApp lesen

Eine App inkl. Laufzeit-Status, Adresse (url) und Prozess-Deklaration. Öffnen kann sie nur eine Person im Browser über die url.

ParameterTypBeschreibung
id• string App-ID (aus apps_list)
apps_statusApp-Status

Laufzeit-Status: starting, running, failed, stopped, not_deployed. Nach einer Veröffentlichung einer Server-App warten, bis "running".

ParameterTypBeschreibung
id• string App-ID (aus apps_list)
apps_logsApp-Logs

stdout/stderr einer Node/Python-App (statische Apps haben keine).

ParameterTypBeschreibung
id• string App-ID (aus apps_list)
tail integer letzte N Zeilen (Default 200)
apps_versionsApp-Versionen

Alle hochgeladenen Versionen und die aktive.

ParameterTypBeschreibung
id• string App-ID (aus apps_list)
apps_eventsApp-Ereignisse

Audit-Spur: wer hat angelegt, hochgeladen, veröffentlicht, gestoppt, wiederhergestellt.

ParameterTypBeschreibung
id• string App-ID (aus apps_list)
limit integer
apps_backupsApp-Sicherungen

Sicherungen des Datenverzeichnisses einer Server-App (nächtlich, vor jeder Version, manuell). Wiederherstellen nur durch eine Person im Browser.

ParameterTypBeschreibung
id• string App-ID (aus apps_list)
apps_limitsApp-Limits

Grenzen des Moduls (Apps je Tenant, Bundle-Größe, Laufzeit). Ohne Parameter.

keine Parameter
apps_publishApp veröffentlichen (WRITE)

Legt die App beim ersten Aufruf an (slug neu) und veröffentlicht jede weitere Version. Dateien als {Pfad: Inhalt}; statisch: index.html oben; Server: eluna-app.json ({runtime: node|python, start, healthPath}), Port aus PORT, Daten nur in $DATA_DIR (SQLite). Keine Geheimnisse in Dateien oder env. Antwort enthält url und deployed. Nur bei aktiviertem Write-Modus.

ParameterTypBeschreibung
slug• string Kurzname: a–z, 0–9, '-', max. 40; stabil je App (darüber wird sie aktualisiert)
name string Anzeigename, nur beim Anlegen relevant (Default: slug)
description string Beschreibung, nur beim Anlegen
files object Textdateien {Pfad: Inhalt}, z. B. {"index.html": "<!doctype html>…"}
filesBase64 object Binärdateien {Pfad: Base64} (Bilder, Fonts)
note string Notiz zur Version
deploy boolean false = nur speichern, nicht veröffentlichen
apps_createApp anlegen ohne Upload (WRITE)

Legt eine leere App an (Adresse reserviert); Inhalt später mit apps_publish (gleicher slug). Nur bei aktiviertem Write-Modus.

ParameterTypBeschreibung
name• string
slug string Kurzname: a–z, 0–9, '-', max. 40; stabil je App (darüber wird sie aktualisiert)
description string
allowedRoles array Tenant-Rollen, die die App öffnen dürfen: [] = alle Mitglieder, ["admin"] = nur Admins, z. B. ["member"]. Admins dürfen immer.
network string ausgehender Zugriff einer Server-App (Default none)
size string
apps_updateApp-Einstellungen ändern (WRITE)

Teil-Update: Name, Beschreibung, Rollen (wer die App öffnen darf), Netzwerk, Größe, env (nicht geheime Konfiguration). network/allowedRoles nur ändern, wenn die Person genau das will. Nur bei aktiviertem Write-Modus.

ParameterTypBeschreibung
id• string App-ID (aus apps_list)
name string
description string
allowedRoles array Tenant-Rollen, die die App öffnen dürfen: [] = alle Mitglieder, ["admin"] = nur Admins, z. B. ["member"]. Admins dürfen immer.
network string
size string
env object ersetzt alle env-Overrides; Namen A–Z, 0–9, _; keine Geheimnisse
apps_deployVersion veröffentlichen / zurückrollen (WRITE)

Setzt eine gespeicherte Version live (Rollback = ältere Version). Nur bei aktiviertem Write-Modus.

ParameterTypBeschreibung
id• string App-ID (aus apps_list)
version• integer Versionsnummer aus apps_versions
apps_startServer-App starten (WRITE)

Startet eine gestoppte Node/Python-App. Nur bei aktiviertem Write-Modus.

ParameterTypBeschreibung
id• string App-ID (aus apps_list)
apps_stopServer-App stoppen (WRITE)

Stoppt eine Node/Python-App; Daten bleiben erhalten. Nur bei aktiviertem Write-Modus.

ParameterTypBeschreibung
id• string App-ID (aus apps_list)
apps_backup_createSicherung anlegen (WRITE)

Sichert das Datenverzeichnis einer Server-App jetzt. Nur bei aktiviertem Write-Modus.

ParameterTypBeschreibung
id• string App-ID (aus apps_list)
apps_deleteApp löschen (WRITE)

Löscht App, alle Versionen, Daten und Sicherungen endgültig — nur wenn die Person das ausdrücklich will. confirm = slug der App. Nur bei aktiviertem Write-Modus.

ParameterTypBeschreibung
id• string App-ID (aus apps_list)
confirm• string Kurzname (slug) der App zur Bestätigung

connections read-only 7 Tools

connections_v2_listConnections (v2) auflisten

Alle v2-Connections des Tenants (third_party, eluna_module, mcp_server) plus das Tenant-Dokument agentMd. Ohne Parameter.

keine Parameter
connections_v2_getConnection (v2) lesen

Eine v2-Connection per ID.

ParameterTypBeschreibung
id• string
connections_v2_by_keyConnection (v2) per stabilem Key

Aktive v2-Connection per connectionKey; 404 unbekannt, 410 nur gelöschte vorhanden.

ParameterTypBeschreibung
key• string stabiler connectionKey
connections_v2_createConnection (v2) anlegen (WRITE)

Legt eine v2-Connection an. mcp_server: name = Servername (a–z, 0–9, '-', max. 40), mcp Pflicht. eluna_module: moduleId Pflicht. Geheimnisse nur über Vault-Bindungen (env/vaultSecretIds). Nur bei aktiviertem Write-Modus.

ParameterTypBeschreibung
name• string
connectionType string
description• string
status string
moduleId string | null Pflicht für eluna_module (z. B. eluna-apps)
version string | null
endpoint string | null
env array env-Bindungen: envName → Vault-Eintrag (vaultSecretId). Nie Geheimnisse im Klartext.
vaultSecretIds array Kurzform: env-Namen werden erzeugt; env gewinnt, wenn beides kommt
mcp object nur für mcp_server; auth.envName muss eine env-Bindung mit vaultSecretId sein. Ersetzt beim Update das ganze Objekt.
additionalInfo any
connectionInstructionsMd string Anleitung für den Agenten (Markdown); bei third_party sonst generiert
agentMdContext string
connections_v2_updateConnection (v2) ändern (WRITE)

Teil-Update. Entfernen: status "deletion_pending"; pausieren: "disabled". mcp ersetzt das ganze Objekt. Nur bei aktiviertem Write-Modus.

ParameterTypBeschreibung
id• string
name string
description string
status string
moduleId string | null Pflicht für eluna_module (z. B. eluna-apps)
version string | null
endpoint string | null
env array env-Bindungen: envName → Vault-Eintrag (vaultSecretId). Nie Geheimnisse im Klartext.
vaultSecretIds array Kurzform: env-Namen werden erzeugt; env gewinnt, wenn beides kommt
mcp object nur für mcp_server; auth.envName muss eine env-Bindung mit vaultSecretId sein. Ersetzt beim Update das ganze Objekt.
additionalInfo any
connectionInstructionsMd string Anleitung für den Agenten (Markdown); bei third_party sonst generiert
agentMdContext string
connections_v2_regenerateConnection-Anleitung neu erzeugen (WRITE)

Erzeugt Anleitung und Kontext neu (eluna-Modul: aus dem Modul-Manifest; third_party: generiert). Nur bei aktiviertem Write-Modus.

ParameterTypBeschreibung
id• string
connections_v2_set_agent_mdTenant-Agent-Dokument setzen (WRITE)

Setzt das tenantweite, handgeschriebene Markdown für den Agenten (unabhängig von einzelnen Connections); null löscht es. Nur bei aktiviertem Write-Modus.

ParameterTypBeschreibung
agentMd• string | null Markdown; null = löschen

tenant read-only 2 Tools

tenant_listMeine Tenants

Listet die Tenants, in denen der angemeldete Nutzer Mitglied ist, mit Rolle — und markiert den aktuell aktiven (auf den der Gateway standardmäßig zugreift). Ohne Parameter.

keine Parameter
tenant_switchTenant wechseln

Setzt den aktiven Tenant des angemeldeten Nutzers (nur eigene Mitgliedschaften — sonst abgelehnt). Wirkt auf ALLE folgenden Zugriffe dieses Nutzers, auch außerhalb dieses Chats (user-weit). tenant_list zeigt die möglichen IDs.

ParameterTypBeschreibung
tenantId• string Ziel-Tenant-ID (aus tenant_list)