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).
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.
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.
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
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.
• 🚨 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
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.
• 🛡️ 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
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).
• 🚨 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
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.
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
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.
## 🛡️ Mac Security Health Report (2026-08-28)
- Bewertung: 96 / 100 (A+)
- Schutz:
• FileVault: ✅
• SIP: ✅
• Firewall: ✅
• ARP-Sperre: ✅
• DNS-Bedrohungsschutz: ✅ (Quad9)
- Empfehlung: keineStatusprüfung für USB-, Bluetooth- & Download-Guards
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.
• 🛡️ 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
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.
• 🚪 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.
• 🔍 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.
• 🔌 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)“.
• ⚠️ Ursache: Die XPC-Verbindung zu
RoamSwitchHelper ist unterbrochen.• 🛠️ Wiederherstellung:
1. Starten Sie den Helper neu:
sudo killall RoamSwitchHelper2. 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
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.
• 🐛 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.
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.