Zum Inhalt springen
RUNOSRUNOS Dokumentation

KI-Agenten (MCP)

RUNOS hat einen eingebauten MCP-Server. Ohne externen Agenten geht es auch: Der KI-Assistent ist ein Chat direkt in RUNOS mit denselben Werkzeugen. MCP (Model Context Protocol) ist der offene Standard, über den KI-Agenten wie Claude Code, Claude Desktop oder Cursor mit Programmen arbeiten. Ist der Server eingeschaltet, kann Ihr KI-Agent Ihre Workflows auf diesem PC lesen, neue Workflows schreiben, sie prüfen, testweise ausführen und starten oder stoppen.

KI-Agent (z. B. Claude Code) ──▶ http://localhost:47811/mcp ──▶ RUNOS ──▶ Workflows

Einschalten

Abschnitt betitelt „Einschalten“
  1. Öffnen Sie Einstellungen (Zahnrad unten in der Aktivitätsleiste).
  2. Schalten Sie unter KI-Agenten den MCP-Server für KI-Agenten ein. Der Punkt daneben wird grün (Läuft).
  3. Unter KI-Agent verbinden kopieren Sie die Einrichtung für Ihren Agenten:
    • Claude-Code-Befehl kopieren: den Befehl in einem Terminal ausführen, danach kennt Claude Code RUNOS als runos.
    • JSON kopieren: den Eintrag mcpServers für Agenten, die eine JSON-Konfiguration lesen (z. B. .mcp.json von Claude Code, Cursor).
claude mcp add --transport http runos http://localhost:47811/mcp --header "Authorization: Bearer <Schlüssel>"

Der Server läuft, solange RUNOS geöffnet ist (auch minimiert im Infobereich), und startet mit RUNOS wieder, bis Sie ihn ausschalten. Standardmäßig ist er aus.

Was der Agent kann

Abschnitt betitelt „Was der Agent kann“
Werkzeug Was es tut
list_workflows Alle gespeicherten Workflows: ID, Name, Trigger, ob er läuft, letzter Lauf
get_workflow Einen Workflow mit seinem vollständigen JSON
validate_workflow Ein Workflow-JSON prüfen, ohne es zu speichern oder auszuführen
save_workflow Ein Workflow-JSON speichern: ohne id als neuen Workflow, mit id über einen vorhandenen
edit_workflow Einen gespeicherten Workflow in Teilen ändern, ohne das ganze JSON zu schicken: eine Aktion ein- oder ausschalten (Enabled), einen Parameter setzen, eine Aktion entfernen, hinzufügen oder verschieben. Aktionen werden über ihren Namen gefunden, auch verschachtelte. Das Ergebnis wird wie bei validate_workflow geprüft und wie bei save_workflow gespeichert; Kommentare im JSON bleiben dabei nicht erhalten.
run_workflow Die Aktionen eines gespeicherten oder noch nicht gespeicherten Workflows einmal sofort ausführen, wie Ausführen im Editor, und das Ergebnis mit den Protokollzeilen des Laufs zurückgeben
set_workflow_running Einen Workflow starten oder stoppen, wie Starten / Stoppen in der Workflow-Liste
get_logs Protokolleinträge (standardmäßig die neuesten 30): dieser Sitzung, früherer Sitzungen und, im gemeinsamen Datenordner, der anderen Benutzer (mit user); auf Wunsch nur eines Workflows, eines Benutzers oder ab einer Stufe
list_action_types Die verfügbaren Trigger und Aktionen mit ihren Parameternamen; mit types (z. B. File, SMTP oder all) die genannten mit Beschreibung, Standardwerten und Ergebnis jedes Parameters
get_templates Die Workflow-Vorlagen, die RUNOS unter Neu anbietet (vom RUNOS-Server), mit Name, Beschreibung und Kategorie; mit id das vollständige JSON einer Vorlage. Ohne Internetverbindung meldet das Werkzeug einen Fehler.
list_connectors Die Konnektoren, die ein Workflow mit {{connector.<Name>.<Feld>}} verwenden kann: Name, Anbieter, Anmeldeart, Status, Basis-URL, der passende Verweis und ob er vom Besitzer eines gemeinsamen Datenordners geteilt ist. Nie Schlüssel, Passwörter oder Tokens; Konnektoren legen Sie selbst unter Konnektoren an.
take_screenshot Ein Bild des RUNOS-Hauptfensters, wie es gerade aussieht (geöffnete Ansicht, Editor-Tab, Dialoge), damit der Agent sieht, was Sie sehen. Nur das RUNOS-Fenster, nie der übrige Bildschirm. Schlägt fehl, solange das Fenster minimiert oder im Infobereich ist.

Gut zu wissen:

  • run_workflow führt die Aktionen wirklich aus: Mails werden gesendet, Dateien geschrieben, Belege gedruckt. Lassen Sie den Agenten mit ungefährlichen Werten testen, etwa an Ihre eigene Adresse. Ein Lauf bricht nach timeoutSeconds ab (Standard 300 Sekunden). Passwörter und Schlüssel im Ergebnis ersetzt RUNOS durch ***.
  • save_workflow speichert nur Workflows, die RUNOS laden kann. Wie beim Speichern in RUNOS gilt danach Autostart des JSON für Starten/Stoppen. Ist der Workflow in einem Editor-Tab geöffnet, zeigt der Tab sofort die gespeicherte Fassung, Sie sehen die Änderung also live. Nur wenn der Tab ungespeicherte Änderungen von Ihnen hat, lehnt RUNOS das Speichern ab, damit Ihre Arbeit nicht verloren geht; speichern oder verwerfen Sie sie vorher. Verwendet RUNOS den gemeinsamen Datenordner eines anderen Benutzers, lehnt es das Speichern ab: Nur der Besitzer ändert diese Workflows.
  • Was der Agent tut, steht im Protokoll (Quelle MCP, bzw. unter dem Workflow-Namen), gespeicherte Workflows mit „(AI agent)“ als letztem Bearbeiter.

Sicherheit

Abschnitt betitelt „Sicherheit“
  • Der Server nimmt nur Verbindungen von diesem PC an (localhost), nicht aus dem Netzwerk.
  • Jede Anfrage braucht den Schlüssel. Er gilt je Windows-Benutzer und liegt in %LOCALAPPDATA%\RUNOS\McpKey.txt, sodass auf einem Terminalserver kein anderer Benutzer ihn lesen kann.
  • Wer den Schlüssel hat, kann Ihre Workflows ausführen und ändern. Geben Sie ihn nicht weiter. Neuer Schlüssel erstellt einen neuen; Agenten mit dem alten verbinden sich danach nicht mehr, bis Sie die Einrichtung erneut kopieren.

Wenn es nicht klappt

Abschnitt betitelt „Wenn es nicht klappt“
Anzeige / Meldung Ursache und Lösung
Läuft nicht, „Port 47811 is used by another program.“ Ein anderes Programm (oder RUNOS eines anderen Benutzers auf einem Terminalserver) nutzt den Port. Tragen Sie in Settings.json in Ihrem Datenordner (Standard Dokumente\RUNOS\Config) unter "McpPort" einen anderen Port ein, starten Sie RUNOS neu und kopieren Sie die Einrichtung erneut.
Der Agent meldet „Missing or wrong key“ (401) Der Schlüssel wurde erneuert. Einrichtung erneut kopieren.
Der Agent erreicht localhost:47811 nicht RUNOS ist geschlossen oder der Server aus. Die Adresse muss localhost lauten, nicht 127.0.0.1.