KI-Integration (MCP)

Den Sicherheitsstatus von Mac / Linux direkt aus KI wie Claude prüfen

RoamSwitch enthält einen MCP-Server (Model Context Protocol). Verbinden Sie ihn mit Claude Desktop / Claude Code und fragen Sie „Ist mein Mac / Linux gerade sicher?“ oder „Welche Ports sind von außen erreichbar?“, so antwortet er auf Grundlage der von RoamSwitch berechneten Diagnoseergebnisse.

🔒 Warum es sicher ist

  • Ändert keine Einstellungen: Es gibt kein Tool, das Einstellungen, Schutzmaßnahmen oder Ports ändert. Geschrieben werden nur Aktualisierungen eigener Aufzeichnungen wie Diagnoseverlauf, Log-Basiswerte und npm-Cache.
  • Vollständig lokal: Kommuniziert nur über Standardein- und -ausgabe und sendet keine Telemetrie. Nach außen kommuniziert nur das standardmäßig deaktivierte run_npm_audit_signatures sowie, in der Linux Server Edition, DNS-, RDAP- und MTA-STS-Abfragen für die in domain_check_domains eingetragenen Domains. Alles Übrige sind 127.0.0.1 und ICMP-Ping an das Gateway (höchstens 3 Pakete).
  • Schutz vor Fehlbedienung: Es gibt keine Aktionstools, daher kann auch eine Prompt-Injection keine Einstellungen ändern.

Die Tools für Mac und Linux tragen außerdem MCP-Annotationen (z. B. readOnlyHint). readOnlyHint ist nur bei den drei oben auf false gesetzt, und openWorldHint ist nur bei run_npm_audit_signatures auf true gesetzt. Jede Zeile von get_vulnerability_scan_history enthält, was die Sonde beim Ziel hinterlässt (sideEffects). Jeder Befund von run_active_vuln_scan enthält, ob das Problem bestätigt werden konnte oder die Version lediglich in den Bereich der CVE fällt (evidenceKind).

Einrichtung

In zwei Schritten eingerichtet

1Speicherort der Binärdatei

Ist in RoamSwitch.app enthalten – kein separater Download oder Installation nötig.

/Applications/RoamSwitch.app/Contents/MacOS/RoamSwitchMCPServer

2aFür Claude Desktop

Fügen Sie Folgendes zu "mcpServers" in ~/Library/Application Support/Claude/claude_desktop_config.json hinzu und starten Sie Claude Desktop neu.

{
  "mcpServers": {
    "roamswitch": {
      "command": "/Applications/RoamSwitch.app/Contents/MacOS/RoamSwitchMCPServer"
    }
  }
}

2bFür Claude Code

Führen Sie im Terminal einmal den folgenden Befehl aus.

claude mcp add roamswitch /Applications/RoamSwitch.app/Contents/MacOS/RoamSwitchMCPServer

2cFür die OpenAI Codex CLI

Fügen Sie Folgendes zu ~/.codex/config.toml hinzu oder führen Sie im Terminal den folgenden Befehl aus.

[mcp_servers.roamswitch]
command = "/Applications/RoamSwitch.app/Contents/MacOS/RoamSwitchMCPServer"
codex mcp add roamswitch -- /Applications/RoamSwitch.app/Contents/MacOS/RoamSwitchMCPServer

2dFür OpenCode

Fügen Sie Folgendes zu opencode.json im Projektstamm (oder global in ~/.config/opencode/opencode.json) hinzu.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "roamswitch": {
        "type": "local",
        "command": ["/Applications/RoamSwitch.app/Contents/MacOS/RoamSwitchMCPServer"]
      }
    }
  }
}

💡 Unterstützung für lokale LLMs: Wenn Sie ein lokales Modell wie Ollama oder LM Studio angebunden haben, können Sie die Sicherheit prüfen und Fragen stellen, völlig offline, auch während RoamSwitch eine Bedrohung erkannt und das Netzwerk notfallmäßig getrennt hat.

2eFür Antigravity

Fügen Sie Folgendes zu ~/.gemini/config/mcp_config.json (oder .agents/mcp_config.json im Stammverzeichnis Ihres Arbeitsbereichs) hinzu.

{
  "mcpServers": {
    "roamswitch": {
      "command": "/Applications/RoamSwitch.app/Contents/MacOS/RoamSwitchMCPServer"
    }
  }
}

* Wenn bei Antigravity CLI (agy) o. Ä. beim Ausführen eines Tools ein Hook Failure oder ein Telemetriefehler auftritt, setzen Sie in ~/.gemini/config/plugins/.../hooks.json "enabled": false, um den Hook zu deaktivieren.

1Speicherort der Binärdatei

Es ist in den apt-, rpm- und Arch-Paketen enthalten und wird bei der Installation unter /usr/bin/roamswitch-mcp abgelegt. Ein separater Download oder Build ist nicht nötig (gilt für die Client-Version und die Server Edition).

/usr/bin/roamswitch-mcp

Auch auf der Server Edition (Headless-Betrieb) lässt sich dieselbe Binärdatei auf dieselbe Weise konfigurieren. Einzelheiten finden Sie im Kapitel „Betrieb von KI-Agenten / MCP-Integration“ im „Betriebshandbuch (Linux Server)“.

2aFür Claude Desktop

Claude Desktop wird für Linux offiziell nicht bereitgestellt. Wenn Sie einen inoffiziellen Build verwenden (z. B. claude-desktop-debian), fügen Sie Folgendes unter "mcpServers" in ~/.config/Claude/claude_desktop_config.json hinzu und starten Sie neu.

{
  "mcpServers": {
    "roamswitch": {
      "command": "/usr/bin/roamswitch-mcp"
    }
  }
}

2bFür Claude Code

Führen Sie im Terminal einmal den folgenden Befehl aus.

claude mcp add roamswitch /usr/bin/roamswitch-mcp

2cFür die OpenAI Codex CLI

Fügen Sie Folgendes zu ~/.codex/config.toml hinzu oder führen Sie im Terminal den folgenden Befehl aus.

[mcp_servers.roamswitch]
command = "/usr/bin/roamswitch-mcp"
codex mcp add roamswitch -- /usr/bin/roamswitch-mcp

2dFür OpenCode

Fügen Sie Folgendes zu opencode.json im Projektstamm (oder global in ~/.config/opencode/opencode.json) hinzu.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "roamswitch": {
        "type": "local",
        "command": ["/usr/bin/roamswitch-mcp"]
      }
    }
  }
}

💡 Unterstützung für lokale LLMs: Wenn Sie ein lokales Modell wie Ollama oder LM Studio angebunden haben, können Sie die Sicherheit prüfen und Fragen stellen, völlig offline, auch während RoamSwitch eine Bedrohung erkannt und das Netzwerk notfallmäßig getrennt hat.

2eFür Antigravity

Fügen Sie Folgendes zu ~/.gemini/config/mcp_config.json (oder .agents/mcp_config.json im Stammverzeichnis Ihres Arbeitsbereichs) hinzu.

{
  "mcpServers": {
    "roamswitch": {
      "command": "/usr/bin/roamswitch-mcp"
    }
  }
}

* Wenn bei Antigravity CLI (agy) o. Ä. beim Ausführen eines Tools ein Hook Failure oder ein Telemetriefehler auftritt, setzen Sie in ~/.gemini/config/plugins/.../hooks.json "enabled": false, um den Hook zu deaktivieren.

Verfügbare Tools

Tools (aktuell 35 auf Mac / 45 auf Linux, wird laufend erweitert)

get_security_report

Diagnostiziert unter Mac 23 Punkte (FileVault, Firewall, von außen erreichbare Ports usw.) und unter Linux 31 Client- bzw. 42 Server-Punkte (Kernel-Härtung, Schutz des Docker-Sockets und privilegierter Container, Isolation der Container-Laufzeit, bekannte Schwachstellen usw.) und liefert eine Bewertung samt Verbesserungshinweisen. Die Linux-Zahlen sind die festen Punkte; je nach Host kommen weitere hinzu.

get_exposed_ports

Listet alle lauschenden Ports auf und versieht die von außen erreichbaren mit einer Einstufung, ob es sich um einen bekannten gefährlichen Dienst (Redis, MongoDB usw.) handelt. Lokale KI-Laufzeiten (Ollama, vLLM, ComfyUI usw.) stehen in aiRuntimes, mit der Sicherheit confirmed oder likely (likely führt höchstens zu einer Warnung). Unter Mac sendet es pro offenem Port einmal ein HTTP GET an 127.0.0.1 und zieht auch die Antwort-Header für die Einstufung heran. Unter Linux entscheiden Port und Prozessname.

get_guard_status

Liefert den Aktivierungsstatus der einzelnen Guards, etwa der automatischen Sperrung unbekannter Ports, der automatischen ARP-Spoofing-Reaktion und des USB-Speicher-Guards, sowie die aktuelle Schutzstufe. Bei Guards, die Protokolle oder Dateien lesen, wird auch zurückgegeben, ob die Eingabe tatsächlich gelesen wird; ein Guard, der nicht lesen kann, wird nie als „aktiv“ angezeigt. Keine Erkennung bedeutet „im geprüften Bereich nichts erkannt“.

audit_url_safety

Übergibt man den Text einer E-Mail oder eine URL, werden Phishing, Unicode-Homograph-Täuschung, Subdomains, die sich als bekannte Marken ausgeben, und Hochrisiko-TLDs ausschließlich auf dem Gerät (Zero Telemetry) diagnostiziert.

get_app_help

Durchsucht auf dem Gerät die offizielle Wissensbasis mit den Spezifikationen, dem internen Verhalten, allen Benachrichtigungstexten und der Fehlerbehebung aller RoamSwitch-Funktionen und liefert Erläuterungen und Hinweise.

audit_security_logs

Fasst aktuelle Sicherheitsprotokolle zusammen (fehlgeschlagene Sudo-Authentifizierungen, SSH-Brute-Force, Firewall-Sperren usw.; unter Mac auch Gatekeeper und XProtect, unter Linux auch AppArmor und ClamAV) und gibt sie mit geschwärzten Geheimnissen wie API-Schlüsseln und Tokens zurück. Hinzu kommen die Ergebnisse der Erkennung neuer Muster und von Häufigkeitsanomalien (statistische Spitzen). Konnte unter Linux das Journal nicht gelesen werden, wird 0 Einträge nicht als „nichts passiert“ gewertet; journalReadComplete wird auf false gesetzt und der Grund in journalError eingetragen.

get_notification_history

Gibt den Verlauf der von RoamSwitch gesendeten Benachrichtigungen (Sicherheitslog-Auffälligkeiten, ClickFix-Erkennungen u. a.) der letzten 7 Tage zurück, neueste zuerst.

roamswitch://docs/* (MCP Resources)

Offizielle Dokumentation, die eine KI direkt als Kontext lesen kann (Funktionsspezifikationen, Erläuterungen aller Warnungen, Einrichtungsanleitungen, Fehlerbehebung).

Weitere Tools

Tool Plattform Kurzbeschreibung
audit_secrets Mac / Linux Erkennt durchgesickerte API-Schlüssel und private Schlüssel in Text, Dateien und Verzeichnissen (erkannte Werte werden maskiert ausgegeben). Bei Verzeichnissen werden mit dem optionalen Argument include_build_output (boolesch) auf true auch Ordner mit öffentlich ausgelieferter Frontend-Ausgabe wie dist und build gelesen, die der rekursive Scan überspringt (dem Ergebnis wird buildOutput hinzugefügt).
run_active_vuln_scan Mac / Linux Eine zerstörungsfreie, nachweisbasierte Schwachstellenprüfung, die nur 127.0.0.1 betrifft. Sie verbindet sich nicht mit externen Hosts, ist aber ein Tool, das Netzwerkanfragen sendet, und deshalb standardmäßig deaktiviert; in den Einstellungen ist ein Opt-in erforderlich.
get_vulnerability_scan_history Mac / Linux Gibt das zuletzt erfasste Ergebnis und die verstrichenen Tage (pass_age) für jede Prüfung zurück, die run_active_vuln_scan aufgezeichnet hat.
verify_security_findings Mac / Linux Bewertet die Einträge von get_security_report anhand des aktuellen Zustands neu und liefert stillPresent, resolved oder inconclusive samt Begründung. Dient dazu, die Wirkung einer Korrektur zu prüfen. Nicht messbare Einträge gelten nie als sicher, sondern werden inconclusive. Ohne checkIds werden alle Einträge geprüft (bis zu 50 unter Mac und 64 unter Linux). Einige Mac-Einträge hängen von Werten der App-Einstellungen ab. Nur lesend, es erfolgen weder Reparaturen noch Einstellungsänderungen. Das Ergebnis enthält verificationStatus und rationale, bei weiterhin zutreffenden Einträgen zusätzlich counterEvidence und severityChangesIf.
audit_mcp_configs Mac / Linux Liest die MCP-Konfigurationsdateien von KI-Clients (Claude Desktop, Cursor u. a. sowie .mcp.json in registrierten Ordnern) und weist auf automatische Freigabe ohne Rückfrage, unverschlüsseltes http://, nicht festgelegte npx-Versionen u. Ä. hin. Nur lesend, sendet nichts. Gibt keine Werte oder Geheimnisse zurück, nur Angaben wie Servernamen. Nicht auswertbare Dateien stehen in unreadableFiles.
audit_agent_setup Mac / Linux Liest die Anweisungsdateien, Skills und Einstellungen von KI-Agenten (Claude Code, Codex u. a.) sowie VS-Code-Tasks und GitHub Actions in registrierten Ordnern und weist auf mit unsichtbaren Zeichen versteckten Text, Anweisungen zum Abrufen und unveränderten Ausführen, zu weit gefasste Berechtigungen u. Ä. hin. Ein Treffer ist eine zu prüfende Stelle, kein Urteil über böse Absicht. Nur lesend, sendet nichts und gibt weder Textinhalt noch Geheimnisse zurück. Mit format=sarif wird SARIF 2.1.0 geliefert.
get_detection_coverage Mac / Linux Liefert für jede MITRE-ATT&CK-Technik zum Schwächen der Abwehr, Verwischen von Spuren oder Verbleiben im System, ob sie erkannt werden kann (detects / partial / none), was nicht sichtbar ist (blindSpot) und den Zustand des Wächters (liveState). Führt nichts aus und sendet nichts. none bedeutet nicht, dass es keinen Angriff gab, und liveState ist kein Beweis für die Funktion. Mit format=navigator wird eine ATT&CK-Navigator-Ebene (4.5) geliefert.
run_package_cve_scan Mac / Linux Gleicht installierte Pakete (Homebrew / dpkg, dnf usw.) mit der lokalen CVE-Zuordnung ab. Es werden keine Netzwerkverbindungen aufgebaut. Lässt sich die Liste nicht abrufen, wird complete auf false gesetzt. Für Ubuntu (20.04 bis 26.04) werden nur CVSS 7.0 und höher mit verfügbarer korrigierter Version abgeglichen; „kein Treffer“ bedeutet also nicht, dass es keine CVEs gibt. Unter Mac gilt die Reihenfolge Schweregrad, dann EPSS (epss). Für von einer Person akzeptierte Funde wird die Anzahl zurückgegeben (acceptance); das Akzeptieren ist über MCP nicht möglich.
run_package_cve_scan_languages Mac / Linux Gleicht Abhängigkeits-Lockfiles von npm, PyPI, crates.io und anderen mit derselben lokalen CVE-Zuordnung ab. Es werden überhaupt keine Netzwerkverbindungen aufgebaut.
run_package_lifecycle_script_scan Mac / Linux Listet die Lifecycle-Skripte (preinstall / install / postinstall / prepare) in den package.json-Dateien unter dem node_modules eines Projekts auf. Es liest nur Dateien, führt nichts aus und baut keine Netzwerkverbindungen auf. Gefährlich wirkende Muster (etwa curl|sh) erhalten eine Markierung als Hinweis, doch das ist eine Bestandsaufnahme und keine Bedrohungsbewertung. Nachdem eine Person den aktuellen Stand als bestätigt markiert hat, werden hinzugefügte oder geänderte Skripte und Ähnliches als drift zurückgegeben (nur eine Person kann einen Stand als bestätigt markieren).
run_dependency_source_scan Mac Prüft registrierte Projektordner auf Einstellungen, die Dependency Confusion ermöglichen könnten (ein öffentliches Paket wird anstelle eines internen Pakets mit demselben Namen geladen). Geprüft werden das extra-index-url von pip und npm-@scopes ohne festgelegte Quelle. In Projekten mit Lockfile wird außerdem mit dem Schweregrad „niedrig“ gemeldet, dass keine Einstellung gerade erst veröffentlichte Versionen fernhält (kein Hinweis auf ein schädliches Paket). Liest nur Dateien und stellt keine Verbindung her. Nur Mac, Pro.
run_typosquat_scan Mac / Linux Prüft, ob ein Abhängigkeitsname in der package.json eines Projekts nur ein oder zwei Zeichen von einem bekannten npm-Paket entfernt ist (möglicher Typosquatting-Versuch). Es werden nur lokale Dateien gelesen; eine Registry wird nie kontaktiert. Es handelt sich um eine reine Orientierungshilfe, Fehlalarme sind möglich.
run_npm_audit_signatures Mac / Linux Ein Werkzeug, das die npm-Registry (registry.npmjs.org) abfragt. Es führt npm audit signatures aus und prüft Signaturen und Herkunft installierter Pakete. Standardmäßig deaktiviert und verweigert die Ausführung, bis es in den Einstellungen aktiviert wird (die Mac-Version nur mit Pro).
get_quarantine_status Mac / Linux Liefert den Inhalt des Malware-Quarantäne-Tresors: ursprünglicher Pfad, erkannter Bedrohungsname, Zeitpunkt und Größe.
get_canary_status Mac / Linux Liefert den Zustand der Ransomware-Köderdateien (Canary) sowie bis zu die 50 jüngsten erkannten Vorfälle.
get_ransomware_entropy_guard_status Mac / Linux Gibt zurück, ob die generische entropiebasierte Ransomware-Erkennung aktiviert ist, sowie die letzten Burst-Erkennungsvorfälle (unter Linux die letzten 50: Zeit, pid, Prozessname, betroffene Dateien, mittlere Entropie und ob der Schreiber eingefroren wurde). Lässt sich die gespeicherte Datei nicht lesen, ist incidentsReadable false, und eine leere Liste bedeutet nicht „nichts erkannt“. Die Pfade der Home-Verzeichnisse anderer Benutzer werden nur root und Administratoren gezeigt. Es findet keine Kommunikation statt.
get_honeytoken_status Mac / Linux Gibt zurück, ob die Zugangsdaten-Honeytokens aktiviert sind, sowie die letzten Zugriffserkennungsereignisse. Unter Linux liefert es außerdem die Ablageorte der Köder, den Zustand des Überwachungsprozesses und die letzten 50 Zugriffe auf die Köder (Zeit, Art, Pfad, verdächtiger Prozess). Lassen sich die Aufzeichnungen nicht lesen, ist eventsReadable false, und eine leere Liste bedeutet nicht „kein Zugriff“. Die Pfade der Home-Verzeichnisse anderer Benutzer werden nur root und Administratoren gezeigt. Es findet keine Kommunikation statt.
get_browser_credential_watch_status Mac Gibt zurück, ob die Überwachung des Browser-Anmeldedatenzugriffs aktiviert ist, sowie ihre jüngsten Zugriffserkennungsereignisse.
get_forensic_evidence_bundles Mac Gibt die Liste der forensischen Beweispakete zurück (Prozessliste, Netzwerkverbindungen, geänderte Dateien und Ähnliches), die beim Auslösen eines Notfall-Air-Gap gespeichert wurden. Zurückgegeben werden außerdem je Bundle integrity (verified, manifest_altered, artifact_altered:Name, artifact_missing:Name oder not_anchored), insgesamt chainOk und chainBrokenAt sowie missingBundles für Bundles, die in der Kette stehen, aber fehlen. Das erkennt Manipulation, verhindert sie aber nicht.
get_ransomware_recovery_snapshots Mac Liefert die APFS-Wiederherstellungs-Snapshots (vor dem Schaden, bei Erkennung, manuell), den empfohlenen Snapshot zur Wiederherstellung, den Status des Aufbewahrungsmodus und das Snapshot-Intervall. Ein Erkennungs-Snapshot kann bereits verschlüsselte Dateien enthalten. Nur Pro.
search_exec_events Mac / Linux Durchsucht die Aufzeichnungen der Prozessausführung. Unter Mac werden Aufzeichnungen von eslogger verwendet, unter Linux die des Exec-Recorders (mit einer Hash-Kette, die Manipulation erkennen kann). Filterbar nach Pfad, Argumenten usw. Liefert außerdem den Zustand der Aufzeichnungen und ob sie lesbar sind. Die Mac-Version nur mit Pro. Die Linux-Aufzeichnungen sind nur für root lesbar, daher wird mit root-Rechten gestartet.
get_process_tree Mac / Linux Baut aus der Ausführungsaufzeichnung die Vorfahren und Nachkommen eines angegebenen Prozesses auf. Bekannt sind nur Prozesse, die der Recorder tatsächlich gesehen hat. Auf dem Mac nur Pro.
get_port_anomaly_incidents Mac / Linux Liefert den Stand der Baseline-Erfassung des Portanomalie-Guards, die derzeit automatisch gesperrten Ports und bis zu den letzten 50 Vorfälle. Automatisch gesperrte Ports sind ein aktueller Zustand ohne Zeitstempel und etwas anderes als der Vorfallsverlauf mit Zeitstempeln. Diese Unterscheidung steht im Anmerkungsfeld der Antwort.
get_ssh_guard_incidents Mac / Linux Liefert den Zustand und die Aufzeichnungen des SSH-Brute-Force-Guards. Enthalten sind, ob er bis zur Sperre geht oder nur erkennt, die aktuell gesperrten Quellen mit Restzeit und die letzten Aufzeichnungen (bis zu 200). Versuchte Benutzernamen werden unter Linux nicht gespeichert, sondern nur gezählt; unter Mac werden sie bereinigt und bis zu 5 zurückgegeben. Es ist schreibgeschützt, und es gibt kein MCP-Tool zum Aufheben einer Sperre. Unter Linux nutzbar mit der Server Edition und mit der Client Edition, wenn sshd läuft, unter Mac mit der Pro-Version.
get_port_scan_incidents Linux Liefert das Erkennungsprotokoll von Portscans (Aufklärung) gegen dieses Gerät. Enthalten sind Quell-IPs, die in kurzer Zeit viele Ports erreicht haben, die Zahl der erreichten Ports samt einigen davon sowie ob automatisch gesperrt wurde (und für welchen Zeitraum).
get_runtime_threat_status Mac Liefert, ob eine Air-Gap-Isolierung aufgrund einer XProtect-Malware-Erkennung eingetreten ist, und den auslösenden Vorfall. Bei der Suche nach der Ursache eines Air-Gaps zuerst dieses Tool verwenden.
verify_fim Linux Berechnet die Hashes der kritischen Systemdateien neu und vergleicht sie mit der Baseline, um Manipulationen festzustellen. Bei Ausführung als root enthält das Ergebnis zusätzlich recentIntrusionContext. Zu jeder jüngsten Änderung enthält es den Prozess, der die Änderung vorgenommen hat, und den SSH-Login, zu dem er gehört (oder den Grund, warum dies nicht ermittelt werden konnte).
get_file_scan_guard_status Linux (Server) Liefert die Einstellungen des Dateiscan-Guards (ClamAV) und den Zustand des von ihm genutzten Quarantäne-Vaults. Das Tool ist für die Server Edition gedacht und betrifft nicht die Einstellungen des Malware-Guards der Client-Version.
get_ebpf_incidents Linux (Server) Liefert den aktuellen Isolationszustand des eBPF-Laufzeit-Guards und den Vorfallsverlauf mit den Auslösegründen. In der Server Edition kommt zu jedem Eintrag die Zeit von der Erkennung bis zur Maßnahme hinzu (in Millisekunden: detect_to_receive_ms, receive_to_action_ms, detect_to_action_ms); außerdem wird der Zustand des Falco-Heartbeats (heartbeat) zurückgegeben.
get_resource_guard_incidents Linux (Server) Liefert den Verlauf des Guards zur Erkennung von Ressourcenerschöpfung und Prozessanomalien (Speicherlecks / Crash-Schleifen) mit Konfidenzstufen. Es ist ein Guard der Server Edition, daher ist das Ergebnis in der Client-Version immer leer.
get_incident_timeline Mac / Linux Fasst die Erkennungen der einzelnen Guards in einer einzigen Zeitleiste zusammen (mit Prozessabstammung und MITRE-ATT&CK-Tags, experimentell). Nur Zeilen, die aufgrund einer anderen Erkennung aufgezeichnet wurden, tragen die ID der auslösenden Zeile und den Namen des gespeicherten Beweispakets (unter Linux parent_event_id, root_event_id, evidence_refs, unter Mac parentEventID, rootEventID, evidenceRefs).
get_network_history Mac Zeichnet pro WLAN die Anzahl der antwortenden Gateways und den Zeitpunkt der letzten Prüfung auf und erkennt andere Netzwerke mit sehr ähnlichem Namen (Evil-Twin-Kandidaten). Es lässt sich auch nutzen, um zu prüfen, ob man früher verbunden war.
get_vpn_status Linux (Client) Gibt zurück, ob VPN in nicht vertrauenswürdigen Netzwerken (WireGuard / Tailscale) aktiviert ist, ob der Tunnel tatsächlich steht und ob der leck-sichere Kill-Switch scharf geschaltet ist.
get_link_guard_status Linux (Client) Liefert die Einstellungen von Link Guard (prüft DNS / TLS-SNI / HTTP-Host und sperrt Phishing- und Schadseiten), den Betriebsmodus (aus / Warnung / Sperre), die Positivliste sowie die Sperr- und Warnereignisse der letzten 7 Tage.
get_air_gap_status Linux (Client) Liefert, ob eine Notfall-Air-Gap-Isolierung (Sperre der gesamten Kommunikation) aktiv ist, den Grund, die Zeit bis zur automatischen Aufhebung und alle derzeit mit SIGSTOP eingefrorenen Prozesse.
get_sharing_services_status Linux (Client) Liefert die Einstellungen der Funktion, die SSH, Samba und Bildschirmfreigabe (GNOME Remote Desktop / VNC / xrdp) beim Verbinden mit einem nicht vertrauenswürdigen Netzwerk automatisch stoppt, sowie den Zustand der Dienste, die dabei gestoppt und wiederhergestellt werden.
get_bluetooth_guard_status Linux (Client) Gibt die Einstellung des Bluetooth-Guards zurück, der die Sichtbarkeit in nicht vertrauenswürdigen Netzwerken zwangsweise deaktiviert, sowie den tatsächlichen Zustand des Controllers (Betriebsbereitschaft, Sichtbarkeit, verbundene Geräte).
get_usb_guard_status Linux (Client) Liefert die Einstellungen des USB-Speicher-Guards und des BadUSB-Tastatur-Guards sowie eine Liste der verbundenen und der auf Freigabe wartenden Geräte. Der BadUSB-Tastatur-Guard unterdrückt die Eingabe nur über evdev und deaktiviert das Gerät nicht auf Kernel-Seite.
get_fleet_status Linux Liefert den gerätseitigen Zustand von Fleet (zentrale Verwaltung für Organisationen; eine für RoamSwitch Business in Vorbereitung befindliche Funktion): ob das Gerät registriert ist, die Version der geltenden Richtlinie, den Check-in-Status u. Ä. Registrierungscodes, Token, Schlüssel und Lizenzinformationen werden nicht zurückgegeben. Fleet hat keinen Kanal für Fernbefehle, daher kann ein Administrator dieses Gerät weder isolieren noch bedienen.
get_sensor_audit_results Mac / Linux Liefert die Ergebnisse (ausstehend, abgeschlossen, fehlgeschlagen) von aktiven Audits von außen, die bei einem gekoppelten RoamSwitch Sensor (einem eigenen Produkt, das auf Ihrer eigenen Hardware im selben LAN läuft) angefordert wurden. Es ergänzt, was von innerhalb des Geräts nicht erkennbar ist: ob es von außen erreichbar ist. Audits anfordern und Koppeln ist über dieses Werkzeug nicht möglich.
get_lan_sensor_overview Linux Liefert das Bild des LAN, das ein auf demselben Host laufender RoamSwitch Sensor sieht: Geräte, VLANs, Zustand des Mitschnitts samt nicht einsehbarer Bereiche und Zahl der Bedrohungen. Es liest nur den lokalen Socket des Sensors und antwortet mit available: false und einem Grund, wenn es keinen Sensor gibt. Zeichenfolgen von Geräten gelten als nicht vertrauenswürdige Daten.
get_lan_network_threats Linux Liefert die dem Sensor auf demselben Host bekannten LAN-Bedrohungen (nicht autorisierter DHCP-Server, nicht autorisierter IPv6-Router, ARP- und NDP-Spoofing, DNS-Tunneling, Schwachstellen nicht verwalteter Geräte und mehr; mit limit und minSeverity eingrenzbar). Die Liste entsteht aus dem Benachrichtigungsverlauf des Sensors (die letzten 500 Ereignisse, im Speicher) und seinen gespeicherten leichten Audits und ist daher kein vollständiges Protokoll. Ist ein Teil des LAN nicht einsehbar, heißt „keine Bedrohung“ nicht, dass alles in Ordnung ist.
get_privilege_escalation_paths Linux Führt das mitgelieferte PathScope mit festen Argumenten aus und gibt die Pfade zurück, über die ein Konto root erreicht (Anzahl und Schritte, dringende und hohe Gegenmaßnahmen mit ATT&CK sowie der Bereich, der nicht erfasst werden konnte). Es gibt keine Korrekturbefehle zurück und führt auch keine aus. Ist complete false (Ausführung ohne root oder ein Teil konnte nicht erfasst werden), bedeutet 0 Pfade nicht „sicher“. Nur root und Administratoren können in start ein anderes Konto angeben. Fehlt PathScope, wird available: false zurückgegeben.
get_access_log_report Linux Führt das mitgelieferte AccessScope mit festen Argumenten aus und gibt eine Zusammenfassung der Angriffe in Webserver-, SSH- und Authentifizierungslogs zurück (Risiko, Liste der Erkennungen, maskierte Belegzeilen, Logs, die nicht gelesen werden konnten). since nimmt 1 bis 90 Tage wie 24h oder 7d, und es werden nur Logs berücksichtigt, die der aufrufende Benutzer lesen kann. Ist complete false, bedeutet 0 Erkennungen nicht „sicher“. Zeichenfolgen in Logs kann ein Angreifer schreiben; ihnen wird nicht vertraut. Fehlt AccessScope, wird available: false zurückgegeben. Das Tool verwendet weder Netzwerk noch LLM.

Von den obigen Tools laufen diejenigen, die nur den lokalen Zustand lesen (Quarantäne-Vault, Canaries, Portanomalien, Benachrichtigungsverlauf usw.), auch dann, wenn RoamSwitch eine Bedrohung erkannt hat und das Netzwerk gerade per Notfallsperre blockiert. In Kombination mit einem lokalen LLM lässt sich die Ursache auch während der Sperre sofort untersuchen.

Dies sind die Grundcodes von verify_security_findings. Gemeinsam sind failing (trifft noch zu), passing (kein Problem), not_verifiable (nicht prüfbar) und weitere. Konnte nicht gemessen werden, steht ein Code für die fehlende Berechtigung oder Verbindung (helper_unavailable, not_root usw.). Bei inconclusive die Voraussetzungen herstellen und erneut aufrufen.

Als Einziges nimmt run_npm_audit_signatures (die npm-Registry; unter Mac nur mit Pro) Verbindung zu einem externen Host auf; es ist standardmäßig deaktiviert. Alles andere bleibt auf Ihrem Rechner und im LAN. run_active_vuln_scan (standardmäßig deaktiviert) und get_exposed_ports unter Mac prüfen nur 127.0.0.1. Werkzeuge, die die MAC-Adresse des Gateways ermitteln, können einen ICMP-Ping an das Gateway im LAN senden (unter Mac normalerweise einen, höchstens einige; unter Linux nur get_guard_status und wenige andere, je einen).

Ergebnisse, die Zeichenketten enthalten, die Außenstehende verändern können (Paketskripte, Protokolltexte, WLAN-Namen, Prozess-Kommandozeilen usw.), tragen den Hinweis, dass dieser Teil nicht vertrauenswürdige externe Daten sind und nicht als Anweisung behandelt werden. Diese Zeichenketten sind gekürzt. Wird eine Formulierung gefunden, die Anweisungen an eine KI ähnelt, etwa „ignoriere frühere Anweisungen“, wird ein WARNING-Block mit nur Art und Anzahl angefügt (der Wortlaut wird nicht wiederholt). Es wird nichts gelöscht oder gestoppt. Diese Warnung ist nur eine Überwachung; der eigentliche Schutz ist, dass kein Werkzeug Einstellungen oder Abwehr ändert.

Praxisbeispiele nach Szenarien

Konkrete Prompts für Alltag & Entwicklung

Prompts und Beispielantworten der KI für reale Situationen, etwa die Prüfung von Ports bei der lokalen Entwicklung, die Sicherheitsprüfung in kostenlosem WLAN und die Diagnose von Phishing-URLs. Die Prompts lassen sich kopieren und unverändert an die KI senden.

🛠️

Port-Exposure-Audit für lokale Server & DBs

Web-Entwicklung / Docker

Die KI prüfen lassen, ob beim Start von Next.js, Vite, Python, Docker, Redis usw. unbeabsichtigt etwas auf 0.0.0.0 (für alle offen) im LAN erreichbar ist.

💬 Beispiel-KI-Prompt
Führe ein Audit der offenen Ports für alle aktuell laufenden lokalen Entwicklungsserver und Container auf meinem Mac durch. Sind gefährliche Ports an 0.0.0.0 gebunden und im LAN exponiert?
⚡ Tool: get_exposed_ports
Port-Prüfung:
• 🚨 3000 (Next.js): offen auf 0.0.0.0:3000
• 🚨 6379 (redis): offen auf 0.0.0.0:6379 (ohne Authentifizierung)
• ✅ 5432 (postgres): 127.0.0.1:5432
💡 Abhilfe: Redis mit bind 127.0.0.1 und Next.js mit npm run dev -- -H 127.0.0.1 starten.
☕

Sicherheitscheck bei Verbindung mit öffentlichem WLAN

Remote Work / Öffentliches WLAN

Unmittelbar nach der Verbindung mit einem kostenlosen WLAN in einem Café oder Hotel die KI diagnostizieren lassen, ob sicheres Arbeiten möglich ist und ob die nötigen Schutzeinstellungen (Firewall, ARP-Überwachung usw.) aktiv sind.

💬 Beispiel-KI-Prompt
Ich habe mich gerade mit einem öffentlichen Café-WLAN verbunden. Führe eine vollständige Sicherheitsdiagnose durch. Wie ist der Status von Firewall und ARP-Spoofing-Schutz?
⚡ Tools: get_security_report, get_guard_status
Mac-Diagnose:
• 🛡️ Bewertung: 88 / 100 (A-)
• 📡 Netzwerk: nicht vertrauenswürdig (Unterwegs-Modus)
• ✅ Firewall: aktiv
• ✅ ARP-Sperre: aktiv
• ⚠️ Verbesserung: FileVault aktivieren.
✉️

Prüfung verdächtiger Links aus E-Mails & Chats

Phishing-Schutz / URL-Audit

Eine verdächtige E-Mail, die sich als Geschäftspartner ausgibt, oder eine URL in einer Slack-/Discord-DM von der KI prüfen lassen, ausschließlich auf dem Gerät und ohne etwas nach außen zu senden (Zero Telemetry).

💬 Beispiel-KI-Prompt
Ich habe eine E-Mail mit dem Link 'https://apple.com.login-auth-verify.xyz/account' erhalten. Überprüfe die Sicherheit dieser URL, bevor ich darauf klicke.
⚡ Tool: audit_url_safety
URL-Diagnose:
• 🚨 Urteil: Dangerous (8/100)
• ❌ Tarnung: login-auth-verify.xyz, aufgemacht wie apple.com
• ❌ TLD: .xyz ist bei Phishing häufig
• 🔒 Zero Telemetry: auf dem Gerät geprüft
• 🛑 Empfehlung: nicht öffnen, löschen und melden
🤖

Nach der Arbeit eines KI-Agenten die Port-Exposition prüfen lassen

KI-Agenten-Workflows

Wenn Sie den Aufbau und das Testen von Diensten an Claude Code oder Antigravity übergeben, lassen Sie es mit MCP-Tools prüfen und verhindern so unbeabsichtigte Port-Exposition und Schwachstellen.

💬 Beispiel-KI-Prompt
Baue die Backend-API und Tests für das Projekt auf. Nutze RoamSwitch MCP, um sicherzustellen, dass keine ungewollten Ports nach außen offen sind, bevor du fertig meldest.
⚡ Tool: get_exposed_ports
Zusammenfassung der autonomen Ausführung des KI-Agenten:
1. Den Fastify-Backend-Server auf Port 8080 gestartet.
2. 🔍 Prüfung mit RoamSwitch MCP: get_exposed_ports ausgeführt und bestätigt, dass er an 127.0.0.1:8080 gebunden ist (nur localhost) und nicht über das LAN hinaus erreichbar ist.
3. Da nichts erreichbar ist, werden anschließend die Integrationstests ausgeführt.
📋

Täglicher Sicherheitsbericht & Markdown-Export

Audit & Berichterstellung

Den Sicherheitsstatus des Macs als Markdown zusammenstellen und ausgeben lassen, zur Prüfung betrieblicher Vorgaben, zur Vorlage bei der IT-Abteilung oder zur persönlichen Selbstkontrolle.

💬 Beispiel-KI-Prompt
Erstelle einen zusammenfassenden Sicherheitsbericht meines Macs im Markdown-Format für meinen Tagesbericht, inklusive To-Do-Liste für Verbesserungen.
⚡ Tools: get_security_report, get_guard_status
Beispielbericht:
## 🛡️ Mac Security Health Report (2026-08-28)
- Bewertung: 96 / 100 (A+)
- Schutz:
  • FileVault: ✅
  • SIP: ✅
  • Firewall: ✅
  • ARP-Sperre: ✅
  • DNS-Bedrohungsschutz: ✅ (Quad9)
- Empfehlung: keine
🛡️

Statusprüfung für USB-, Bluetooth- & Download-Guards

Geräte- & physischer Schutz

Prüft, ob die einzelnen Schutzfunktionen von RoamSwitch aktiv sind, etwa Schutz vor unbekanntem USB-Speicher, Bluetooth-Überwachung, Download-Schutz für Web/Mail und Umschaltung auf sicheres DNS.

💬 Beispiel-KI-Prompt
Laufen alle Schutzfunktionen wie USB-Speicherschutz, Bluetooth-Wache, DNS-Bedrohungsschutz und Download-Schutz ordnungsgemäß?
⚡ Tool: get_guard_status
Schutzstatus:
• 🛡️ Schutzstufe: Balanced
• ✅ USB: warnt vor nicht registriertem USB und sperrt es
• ✅ Bluetooth: überwacht nicht gekoppelte Geräte
• ✅ Downloads: werden mit ClamAV geprüft
• ✅ DNS: sperrt C2 und Phishing
💡

Fragen zur Bedeutung von Benachrichtigungen und zum richtigen Vorgehen sowie zur Bedienung der App

Funktionsratgeber / Warnmeldungen

Zu Benachrichtigungen und Warnungen auf dem Bildschirm sowie zu Funktionsspezifikationen (Paketfilter, FSEvents, ClamAV, USB-Schutz usw.) erhalten Sie von der KI Erklärungen und Abhilfen auf Grundlage der offiziellen Wissensdatenbank.

💬 Muster A: automatische Port-Sperre während der Entwicklung und Beratung zu sicheren Einstellungen (Webentwicklung, Next.js)
RoamSwitch meldet: '🚪 Unbekannter Port (3000) blockiert'. Es ist mein Next.js-Server. Wie starte ich ihn sicher nur lokal?
⚡ Tool: get_app_help / Resource: roamswitch://docs/settings-guide
Antwort:
• 🚪 Grund: Der Entwicklungsserver wurde auf 0.0.0.0 gestartet und war aus dem LAN erreichbar, daher wurde der Datenverkehr von außen gesperrt.
• ⚙️ Abhilfe:
  1. Empfohlen: Mit npm run dev -- -H 127.0.0.1 starten.
  2. Beim Teilen: In der „Port-Diagnose“ 3000 erlauben.
💬 Muster B: Sicherheitsprüfung und Ursachenanalyse nach einer Notabschaltung (nach dem Ausweichen auf Tethering o. Ä.)
RoamSwitch hat im Café wegen '🚨 ARP-Spoofing erkannt' die Verbindung gekappt. Ich bin auf mobiles Tethering gewechselt. Was ist passiert und wie verhalte ich mich jetzt sicher?
⚡ Tool: get_app_help / Resource: roamswitch://docs/alerts-and-messages
Antwort:
• 🔍 Vorfall: Es war ein Man-in-the-Middle-Angriff, bei dem sich ein Gerät im selben WLAN als Router ausgab.
• 🛡️ Schutz: Die automatische ARP-Sperre hat den Datenverkehr sofort isoliert.
• 🛑 Empfohlen: Nicht in dieses WLAN zurückkehren, sondern per Tethering weiterarbeiten.
💬 Muster C: automatisches Auswerfen von USB und Beratung zum sicheren Registrierungsverfahren
RoamSwitch meldet: '🔌 Nicht registrierter USB-Speicher ausgeworfen'. Es ist mein eigenes USB-Laufwerk. Wie registriere ich es schreibgeschützt?
⚡ Tool: get_app_help / Resource: roamswitch://docs/settings-guide
Antwort:
• 🔌 Grund: Das Gerät wurde getrennt, um Datenabfluss und BadUSB über einen nicht registrierten USB-Datenträger zu verhindern.
• ⚙️ Registrierung: Wählen Sie es unter „Einstellungen“ → „USB-Speicherschutz“ → „Aus verbundenen Geräten hinzufügen“ aus und speichern Sie es als „Nur lesen (empfohlen)“.
💬 Muster D: Frage zur Wiederherstellung nach „Helper nicht verbunden“
In der Menüleiste steht '⚠️ Helper nicht verbunden'. Wie stelle ich die Verbindung wieder her?
⚡ Tool: get_app_help / Resource: roamswitch://docs/troubleshooting
Antwort:
• ⚠️ Ursache: Die XPC-Verbindung zu RoamSwitchHelper ist unterbrochen.
• 🛠️ Wiederherstellung:
  1. Starten Sie den Helper neu:
    sudo killall RoamSwitchHelper
  2. Starten Sie die App neu.
  3. Prüfen Sie unter „Anmeldeobjekte & Erweiterungen“, ob RoamSwitchHelper erlaubt ist.
🧯

Nach einem Air-Gap (Notabschaltung): Offline-Diagnose mit lokalem LLM und MCP

Incident Response / Lokale LLM-Triage

Wird Air-Gap (Notabschaltung des Netzwerks) ausgelöst, etwa bei der Erkennung von Ransomware, ist keine Kommunikation mehr mit Cloud-KI wie Claude Desktop möglich. Der MCP-Server von RoamSwitch arbeitet nur über lokale Interprozesskommunikation. In Kombination mit einem lokalen LLM wie Ollama lässt sich die Diagnose daher auch ganz ohne externes Netzwerk fortsetzen. Erkennung von Log-Anomalien, Manipulationserkennung und Abgleich mit bekannten Schwachstellen laufen vollständig auf dem Gerät.

💬 Beispiel-KI-Prompt
RoamSwitchs Ransomware-Schutz hat ausgelöst, der Host befindet sich jetzt im Air-Gap-Zustand (Notfall-Netzwerkabschottung). Es gibt keinen Netzwerkzugriff, aber analysiere die aktuelle Lage: Wann geschah es, welcher Prozess und welche Dateien waren betroffen, gibt es Manipulationen an Systemdateien, gibt es verdächtige Log-Einträge im Zusammenhang, und gibt es Anzeichen dafür, dass eine bekannte Schwachstelle ausgenutzt wurde?
⚡ Tools: get_canary_status, get_port_anomaly_incidents, audit_security_logs, get_quarantine_status (Linux Server: get_ebpf_incidents / Mac: get_runtime_threat_status)
Ergebnis der Offline-Diagnose (null externe Kommunikation):
• 🐛 Canary ausgelöst: Verschlüsselung von /var/www/decoy_invoice.pdf um 14:32:07 erkannt, suspicious_enc (PID 8823) eingefroren und isoliert
• 🔌 Port-Überwachung: keine neuen automatischen Sperren und keine zusätzlichen Backdoors
• 📜 Log-Korrelation: Authentifizierungsfehler bei sshd nahmen ab 12 Minuten vor der Auslösung stark zu (Z-score 5.2). Möglicher Einbruchsweg
• 🔒 Manipulationserkennung (FIM): keine Manipulation an den kritischen Pfaden
• 📦 Abgleich bekannter Schwachstellen: keine kritischen bekannten Schwachstellen
💡 Empfohlene Maßnahme: Die Kompromittierung beschränkt sich wahrscheinlich auf das Web-Root-Verzeichnis. Prüfen Sie vor der Wiederherstellung auch die übrigen Dateien im selben Verzeichnis.
Häufige Fragen

Zur MCP-Integration

Q. Kommuniziert es wirklich nie nach außen?

A. Ja. Der MCP-Server ist ein lokaler Prozess, der über Standard-Ein-/Ausgabe läuft. Er sendet keine Telemetrie, und Diagnosen werden auf dem Gerät berechnet. Extern kommuniziert nur das standardmäßig deaktivierte run_npm_audit_signatures sowie in der Linux Server Edition die Abfrage der in domain_check_domains eingetragenen Domains (DNS, RDAP, MTA-STS). Alles andere geht an 127.0.0.1 und per Ping an das Gateway.

Q. Kann ich es auch ohne die Pro-Version nutzen?

A. Die Linux-Version ist kostenlos und bietet alle Tools. Die Mac-Version bietet auch in der kostenlosen Version die meisten Tools, aber vier davon (get_ransomware_recovery_snapshots, search_exec_events, get_process_tree, run_npm_audit_signatures) sind der Pro-Version vorbehalten und liefern einen Fehler, wenn Pro nicht aktiv ist. Ob ein Guard tatsächlich wirkt, hängt auch vom Pro-Lizenzstatus ab; über die Tools lässt sich daher nur der Schalterstatus der Einstellungen prüfen.

Q. Welche KI-Clients werden unterstützt?

A. Jeder Client, der den stdio-Transport von MCP (Model Context Protocol) unterstützt, sollte grundsätzlich auch über die oben genannten hinaus funktionieren. Der Betrieb wurde mit Claude Desktop, Claude Code, OpenAI Codex CLI, OpenCode und Antigravity bestätigt.

Q. Antigravity meldet „Hook Failure“ oder Telemetriefehler beim Ausführen von Tools?

A. Ein PreToolUse-Hook eines in Antigravity installierten externen Plugins (z. B. Google-Cloud-Telemetrie) blockiert möglicherweise die Ausführung von Tools. Öffnen Sie ~/.gemini/config/plugins/.../hooks.json und deaktivieren Sie ihn mit "enabled": false.

Q. Kann ich bei getrennter Netzwerkverbindung trotzdem Anfragen stellen?

A. Ja, mit einem lokalen LLM (etwa Ollama oder LM Studio, genutzt z. B. über OpenCode). Da alles auf dem Mac / Linux-Rechner verarbeitet wird, können Sie auch dann völlig offline Fragen stellen, wenn RoamSwitch das Netzwerk gerade per Notfallsperre blockiert. Bei einem Cloud-LLM (z. B. Claude API) wechseln Sie vor der Anfrage auf eine sichere Verbindung wie Tethering.