elunaapp_list_bereicheBereiche auflistenBereiche des Tenants (id, name, modus). Ohne Parameter.
Was dieser Gateway an MCP-Tools bereitstellt. Live aus dem Server abgefragt.
POST /mcp — hier sprechen Clients das Protokoll. Diese Seite ist nur die menschliche Übersicht.elunaapp_list_bereicheBereiche auflistenBereiche des Tenants (id, name, modus). Ohne Parameter.
elunaapp_list_automationsAutomationen eines BereichsAutomationen, die an einen Bereich gebunden sind.
| Parameter | Typ | Beschreibung |
|---|---|---|
| bereichId• | string | Bereichs-ID (Pflicht) |
| detail | boolean |
elunaapp_get_automationAutomation lesenEine Automation inkl. instruction, prePromptSnapshot, lastRun.
| Parameter | Typ | Beschreibung |
|---|---|---|
| id• | string | Automations-ID |
elunaapp_automation_runsAutomations-RunsTatsächliche Läufe (Traces) mit Status, artifactUrl, Verbrauch.
| Parameter | Typ | Beschreibung |
|---|---|---|
| id• | string | Automations-ID |
| limit | integer | |
| offset | integer |
elunaapp_automation_runAutomations-Run-DetailEin einzelner Lauf: output, events, Live-Verbrauch.
| Parameter | Typ | Beschreibung |
|---|---|---|
| id• | string | Automations-ID |
| traceId• | string | Trace-/Run-ID |
elunaapp_automation_sopsSOPs einer AutomationSOPs, die eine Automation nutzt (Volltext, bereich vs. company).
| Parameter | Typ | Beschreibung |
|---|---|---|
| id• | string | Automations-ID |
elunaapp_list_sopsSOPs auflisten (kompakt)SOPs des Tenants, kompakt (ohne Volltext).
| Parameter | Typ | Beschreibung |
|---|---|---|
| bereichId | string | optional auf einen Bereich einschränken |
elunaapp_get_sopSOP lesenEine SOP mit Volltext.
| Parameter | Typ | Beschreibung |
|---|---|---|
| id• | string | SOP-ID |
elunaapp_create_bereichBereich anlegen (WRITE)Legt einen Bereich für den Tenant an. Nur bei aktiviertem Write-Modus.
| Parameter | Typ | Beschreibung |
|---|---|---|
| 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
| 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
| 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
| id• | string | Automations-ID |
elunaapp_optimize_automationAutomation optimieren (WRITE)KI-optimiert die Automation und wendet SOP-Änderungen direkt an. Nur bei aktiviertem Write-Modus.
| Parameter | Typ | Beschreibung |
|---|---|---|
| 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
| 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
| 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
| 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
| 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üfenPrüft die am Bereich verlinkten Automationen live (ok/missing/error) und meldet verwaiste IDs (orphanedAutomationIds).
| Parameter | Typ | Beschreibung |
|---|---|---|
| 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
| id• | string | Bereichs-ID |
| automationIds | array | gezielt diese IDs; weglassen = alle fehlenden |
elunaapp_connectionsBereich-Connections auflistenAlle bekannten Connections mit Markierung, welche am Bereich verlinkt sind (linked). Optionaler Suchfilter q.
| Parameter | Typ | Beschreibung |
|---|---|---|
| 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
| 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
| id• | string | Automations-ID |
| context• | string | einmaliger Kontext für diesen Lauf (Pflicht) |
artifacts_listArtefakte auflistenListe der Artefakte (paginiert, Inhalt gekürzt als Vorschau).
| Parameter | Typ | Beschreibung |
|---|---|---|
| limit | integer | max. Treffer (Default 20) |
| offset | integer | Offset für Paginierung |
artifacts_getArtefakt lesenEin Artefakt mit vollem Inhalt über seine ID.
| Parameter | Typ | Beschreibung |
|---|---|---|
| id• | string | Artefakt-ID |
artifacts_versionsArtefakt-VersionenAlle Versionen eines Artefakts.
| Parameter | Typ | Beschreibung |
|---|---|---|
| id• | string | Artefakt-ID |
artifacts_get_versionArtefakt-Version lesenSnapshot einer bestimmten Version eines Artefakts.
| Parameter | Typ | Beschreibung |
|---|---|---|
| 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).
| Parameter | Typ | Beschreibung |
|---|---|---|
| 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
| 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_contextSandbox-KontextKontext der Sandbox des Tenants (Apps/Übersicht). Ohne Parameter.
sandbox_appsSandbox-Apps auflistenAlle Sandbox-Apps des Tenants. Ohne Parameter.
sandbox_app_getSandbox-App lesenEine Sandbox-App über ihre ID.
| Parameter | Typ | Beschreibung |
|---|---|---|
| id• | string | App-ID |
sandbox_app_documentsSandbox-App-DokumenteDokumente einer Sandbox-App.
| Parameter | Typ | Beschreibung |
|---|---|---|
| id• | string | App-ID |
sandbox_document_contentSandbox-Dokument-InhaltInhalt eines Sandbox-Dokuments über seine ID.
| Parameter | Typ | Beschreibung |
|---|---|---|
| id• | string | Dokument-ID |
sandbox_app_createSandbox-App anlegen (WRITE)Legt eine Sandbox-App an. Nur bei aktiviertem Write-Modus.
| Parameter | Typ | Beschreibung |
|---|---|---|
| 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
| 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
| 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
| 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
| 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
| id• | string | Dokument-ID |
apps_listApps auflistenAlle eluna Apps des Tenants (mit Adresse, Art, aktiver Version, Rollen). Ohne Parameter.
apps_getApp lesenEine App inkl. Laufzeit-Status, Adresse (url) und Prozess-Deklaration. Öffnen kann sie nur eine Person im Browser über die url.
| Parameter | Typ | Beschreibung |
|---|---|---|
| id• | string | App-ID (aus apps_list) |
apps_statusApp-StatusLaufzeit-Status: starting, running, failed, stopped, not_deployed. Nach einer Veröffentlichung einer Server-App warten, bis "running".
| Parameter | Typ | Beschreibung |
|---|---|---|
| id• | string | App-ID (aus apps_list) |
apps_logsApp-Logsstdout/stderr einer Node/Python-App (statische Apps haben keine).
| Parameter | Typ | Beschreibung |
|---|---|---|
| id• | string | App-ID (aus apps_list) |
| tail | integer | letzte N Zeilen (Default 200) |
apps_versionsApp-VersionenAlle hochgeladenen Versionen und die aktive.
| Parameter | Typ | Beschreibung |
|---|---|---|
| id• | string | App-ID (aus apps_list) |
apps_eventsApp-EreignisseAudit-Spur: wer hat angelegt, hochgeladen, veröffentlicht, gestoppt, wiederhergestellt.
| Parameter | Typ | Beschreibung |
|---|---|---|
| id• | string | App-ID (aus apps_list) |
| limit | integer |
apps_backupsApp-SicherungenSicherungen des Datenverzeichnisses einer Server-App (nächtlich, vor jeder Version, manuell). Wiederherstellen nur durch eine Person im Browser.
| Parameter | Typ | Beschreibung |
|---|---|---|
| id• | string | App-ID (aus apps_list) |
apps_limitsApp-LimitsGrenzen des Moduls (Apps je Tenant, Bundle-Größe, Laufzeit). Ohne 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
| 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
| 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
| 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
| 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
| 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
| id• | string | App-ID (aus apps_list) |
apps_backup_createSicherung anlegen (WRITE)Sichert das Datenverzeichnis einer Server-App jetzt. Nur bei aktiviertem Write-Modus.
| Parameter | Typ | Beschreibung |
|---|---|---|
| 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
| id• | string | App-ID (aus apps_list) |
| confirm• | string | Kurzname (slug) der App zur Bestätigung |
connections_v2_listConnections (v2) auflistenAlle v2-Connections des Tenants (third_party, eluna_module, mcp_server) plus das Tenant-Dokument agentMd. Ohne Parameter.
connections_v2_getConnection (v2) lesenEine v2-Connection per ID.
| Parameter | Typ | Beschreibung |
|---|---|---|
| id• | string |
connections_v2_by_keyConnection (v2) per stabilem KeyAktive v2-Connection per connectionKey; 404 unbekannt, 410 nur gelöschte vorhanden.
| Parameter | Typ | Beschreibung |
|---|---|---|
| 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
| 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
| 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
| 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
| agentMd• | string | null | Markdown; null = löschen |
tenant_listMeine TenantsListet 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.
tenant_switchTenant wechselnSetzt 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
| tenantId• | string | Ziel-Tenant-ID (aus tenant_list) |