StorageRadar MCP | Lokaler schreibgeschützter KI-Zugriff auf Disk Analytics

Was ist die MCP-Integration?

Wenn Sie MCP in StorageRadar aktivieren, führt die App einen schlanken lokalen Server auf 127.0.0.1 aus. KI-Assistenten, die das Model Context Protocol unterstützen, können sich mit diesem Server verbinden und Ihre Festplattenanalysen in Echtzeit abfragen.

Der Server ist ausschließlich schreibgeschützt. Es kann Fragen beantworten, z. B. was den meisten Speicherplatz beansprucht oder was sich seit letzter Woche geändert hat, es kann jedoch keine Dateien löschen, nichts verschieben oder auf Dateiinhalte zugreifen.

Der Endpunkt MCP ist in allen Stufen verfügbar. Die Aktivierung und Datenabfrage ist kostenlos. Für die eigentliche Bereinigung auf Grundlage von KI-Empfehlungen ist weiterhin die entsprechende Freischaltstufe in StorageRadar erforderlich.

Einrichtungsanleitung

Die Verbindung Ihrer KI mit StorageRadar dauert weniger als zwei Minuten.

Öffnen Sie die Einstellungen in StorageRadar

Klicken Sie in der Seitenleiste auf „Einstellungen“ und scrollen Sie zur Zeile „Lokaler MCP-Endpunkt“ im Abschnitt „Lokale Nutzung & Datenschutz“.

MCP aktivieren (schreibgeschützt)

Aktivieren Sie den Schalter in dieser Zeile und klicken Sie daneben auf „Konfigurieren“. Im Fenster „Lokaler MCP-Endpunkt“ zeigt die Kachel „Server“ den Status „Läuft“, und die Zeile „Adresse“ zeigt den lokalen Endpunkt mit Port.

Prüfen Sie Ihr Zugriffstoken

StorageRadar erstellt das Token automatisch und zeigt es maskiert in der Zeile „Zugriffstoken“ an. Halten Sie dieses Token privat. Mit „Erneuern“ erzeugen Sie jederzeit ein neues Token und widerrufen das vorherige.

Kopieren Sie den Konfigurationsausschnitt und fügen Sie ihn in Ihren AI-Client ein

Klicken Sie unten im Fenster auf „Client-Konfigurationsausschnitt kopieren“. Solange MCP ausgeschaltet ist, bleibt die Schaltfläche deaktiviert. StorageRadar generiert das richtige Konfigurationsformat für Ihren AI-Client und trägt Ihr Token bereits ein. Fügen Sie es in die MCP Serverkonfiguration Ihres Clients ein.

Führen Sie zunächst einen Scan durch

Stellen Sie sicher, dass Sie in StorageRadar mindestens einen Scan durchgeführt haben. Die MCP Tools arbeiten mit indizierten Scandaten, daher bedeutet ein leerer Scanverlauf leere Ergebnisse.

Beispiel-Prompts

Kopieren Sie eine beliebige Eingabeaufforderung unten und fügen Sie sie in Ihren KI-Assistenten ein, nachdem Sie StorageRadar verbunden haben. Die KI ruft die entsprechenden MCP Tools auf und erklärt die Ergebnisse im Klartext.

Ihre KI kann es nur erklären und empfehlen. Um tatsächlich aufzuräumen, öffnen Sie StorageRadar und verwenden Sie den geführten Workflow. KI-Analyse und vom Menschen gesteuerte Bereinigung sind konstruktionsbedingt getrennt.

01 Schnelle Verbindungsprüfung

get_server_info

Überprüfen Sie die StorageRadar MCP Verbindung: Serverversion, API-Version, App-Version und alle verfügbaren Funktionen anzeigen.

serverVersion, apiVersion, appVersion, Features[] – bestätigt, dass die Verbindung funktioniert.

02 Letzte Scansitzungen

list_scan_sessions

Meine letzten 10 Scan-Sitzungen anzeigen, die neuesten zuerst. Für jedes: Datum, Root-Volume, Gesamtgröße in GB, Gesamtanzahl der Elemente.

Eine Liste der letzten Scans. Wählen Sie hier eine Sitzungs-ID für Folgeanfragen aus.

03 Letzte Scan-Aufschlüsselung

list_scan_sessionsget_scan_session

Nehmen Sie die letzte Scansitzung auf und zeigen Sie deren Details an: Top-Kategorien und das Größenhistogramm. Erklären Sie, wo der Platz geblieben ist.

Aufschlüsselung nach Kategorie mit einer verständlichen Erklärung Ihrer Festplattennutzungsstruktur.

04 Top 30 der größten Artikel

largest_query

Zeigen Sie für den letzten Scan die 30 größten Elemente an, sortiert vom größten zum kleinsten. Geben Sie jeweils die Größe in GB und die Risikostufe an.

Die schwersten Verbraucher auf Ihrer Festplatte mit Größen und Risikokennzeichnungen.

05 Top 20 der größten Ordner

largest_query

Beim letzten Scan werden nur die 20 größten Ordner angezeigt, Mindestgröße 500 MB, absteigend nach Größe sortiert.

Die größten Ordner stehen zur manuellen Überprüfung im Finder bereit.

06 Aufschlüsselung nach Dateierweiterung

largest_query

Zeigen Sie für den letzten Scan die 15 häufigsten Dateitypen nach Gesamtgröße und gruppiert nach Erweiterung an. Welche Dateitypen beanspruchen den meisten Platz?

Erweiterungsverteilung, damit Sie sehen können, ob Videos, Archive, Build-Artefakte oder etwas anderes Ihre Festplatte füllen.

07 Zusammenbruch von Benutzer und System

largest_query

Für den letzten Scan wird die Festplattennutzung nach Besitzer gruppiert angezeigt. Welchen Platzanteil habe ich gegenüber dem System? Erklären Sie die Aufschlüsselung.

Benutzer- und Systemaggregate für eine klare Trennung Ihrer Daten gegenüber macOS Dateien.

08 Gespeicherte Schnappschüsse auflisten

list_snapshots

Meine letzten 20 Festplatten-Snapshots anzeigen: ID, Datum, Bezeichnung und Gesamtgröße für jeden. Neueste zuerst sortieren.

Eine Snapshot-Liste zum Vergleich.

09 Warum ist meine Festplatte diese Woche gewachsen?

list_snapshotsdiff_snapshots

Machen Sie den aktuellsten Schnappschuss und den Schnappschuss, der am ehesten 7 Tage zurückliegt. Vergleichen Sie sie nach Kategorien und erklären Sie, was am meisten gewachsen ist.

Kategoriedeltas mit einer verständlichen Wachstumserklärung.

10 Was hat sich nach der Aktualisierung von Xcode geändert?

list_snapshotsdiff_snapshots

Finden Sie die beiden Schnappschüsse, die dem Datum 15.02.2026 am nächsten kommen. Vergleichen Sie sie nach Erweiterung und Ordner in separaten Abfragen. Zeigen Sie jeweils die wichtigsten Wachstumselemente an.

Wachstum nach Ordner und Erweiterung, oft mit DerivedData, Simulatoren und Xcode Caches.

11 Nur große Änderungen zwischen zwei Schnappschüssen

diff_snapshots

Vergleichen Sie Snapshots [baseId] und [compareId]. Nur Änderungen anzeigen, die größer als 1 GB sind, auf 100 beschränken. Nach Kategorie gruppieren.

Nur die wesentlichen Änderungen mit weniger Lärm.

12 Dev-Caches: Wo ist das größte Volumen?

get_dev_cleanup_summary

Zeigt die Zusammenfassung der Entwicklerbereinigung für den letzten Scan an. Sortieren Sie die Profile absteigend nach Größe und markieren Sie die Top 5 mit ihrer Größe und ihrem Risikograd.

Xcode, npm, Gradle, Docker und andere Profile, sortiert nach Größe.

13 Dev-Caches nach Risiko priorisiert

get_dev_cleanup_summary

Zeigen Sie die Zusammenfassung der Entwicklerbereinigung an und teilen Sie alle Profile in „Sicher“, „Vorsicht“ und „Hohes Risiko“ auf. Empfehlen Sie, was Sie zuerst reinigen, was Sie vor der Reinigung überprüfen und was Sie in Ruhe lassen sollten.

Ein risikobewusster Prioritätsplan.

14 10-stufiger manueller Reinigungsplan

largest_queryget_dev_cleanup_summary

Erstellen Sie auf der Grundlage der neuesten Scan- und Entwicklungsbereinigungszusammenfassung einen 10-stufigen manuellen Bereinigungsplan. Beginnen Sie mit den sichersten und größten Kandidaten und enden Sie mit den Artikeln, die besondere Pflege benötigen.

Ein nummerierter Aktionsplan, den Sie in StorageRadar durcharbeiten können.

15 Überprüfen Sie die Datenschutzrichtlinie des Pfads

largest_query

Zeigen Sie 10 Elemente von largest_query für den letzten Scan an. Beachten Sie für jeden Pfad, ob er allgemein oder detailliert aussieht. Scheint die aktuelle Datenschutzrichtlinie zu funktionieren?

Eine schnelle Überprüfung, ob Ihre Einstellung „Pfad-Datenschutz“ wie erwartet funktioniert.

16 Datenträgerwachstumstrend über 5 Snapshots

list_snapshots

Machen Sie die letzten fünf Snapshots und erstellen Sie einen kurzen Trend: Gesamtdatenträgergröße an jedem Datum, Gesamtwachstum über den Zeitraum und durchschnittliche tägliche Wachstumsrate in MB/Tag.

Eine Mini-Zeitleiste, die zeigt, wie schnell sich Ihre Festplatte füllt.

17 Finden Sie ungewöhnliche Wachstumsspitzen

list_snapshotsdiff_snapshots

Vergleichen Sie die letzten drei aufeinanderfolgenden Schnappschusspaare. Suchen Sie nach Kategorien oder Ordnern, in denen das Wachstum im Vergleich zu den anderen Zeiträumen plötzlich und ungewöhnlich groß war.

Kandidaten für Wachstumsspitzen mit Zeitstempeln.

18 Zusammenfassung

get_scan_sessiondiff_snapshotsget_dev_cleanup_summary

Geben Sie mir eine kurze Zusammenfassung des Speichers meines Mac: aktuelle Gesamtfestplattengröße, Top-3-Verbraucher nach Kategorie, was seit dem letzten Snapshot gewachsen ist und 5 Empfehlungen zur sicheren Bereinigung, sortiert nach Größe.

Eine entscheidungsreife Zusammenfassung ohne übermäßige Details.

19 Vollständiger Markdown-Bericht

get_scan_sessionlargest_querydiff_snapshotsget_dev_cleanup_summary

Erstellen Sie einen Markdown-Bericht für den letzten Scan. Berücksichtigen Sie die Top-Kategorien, die 10 größten Ordner, die 10 größten Dateitypen nach Erweiterung, eine nach Größe sortierte Zusammenfassung der Entwicklerbereinigung und wichtige Änderungen zwischen den beiden letzten Snapshots.

Ein sofort speicherbares Markdown-Dokument für Notizen oder die Vorfallverfolgung.

20 Überprüfen Sie die MCP End-to-End-Verbindung

get_server_infotools/list

Überprüfen Sie meine StorageRadar MCP End-to-End-Verbindung: Initialisieren Sie die Sitzung, listen Sie alle verfügbaren Tools auf und rufen Sie get_server_info an. Zeigen Sie, was passiert ist und was der Server zurückgegeben hat.

Eine vollständige Gesundheitsprüfung, die bestätigt, dass der Server läuft, authentifiziert und bereit ist.

Verfügbare MCP Werkzeuge

StorageRadar macht sieben schreibgeschützte Tools über MCP verfügbar. Ihr KI-Client kann diese basierend auf Ihrer Frage automatisch aufrufen. Alle Tools unterstützen die Cursor-basierte Paginierung und liefern stabile, deterministische Ergebnisse.

get_server_info Diagnose

Gibt die Serverversion, die API-Version, die App-Version und die Liste der aktivierten Funktionen zurück. Nützlich, um zu überprüfen, ob die Verbindung funktioniert.

Rückgaben serverVersionapiVersionappVersionfeatures[]

list_scan_sessions Scannt

Listet alle Scansitzungen mit Status, Root-Volume, Umfang und zusammenfassenden Statistiken auf. Unterstützt das Filtern nach Datumsbereich und Paginierung.

Parameter cursor limit from to

Rückgabe pro Sitzung idcreatedAtrootVolumescopestatustotalBytestotalItemsdurationMs

get_scan_session Scannt

Gibt detaillierte Metadaten und Aggregate für eine bestimmte Scansitzung zurück, einschließlich der Festplattennutzung nach Kategorie der obersten Ebene.

Parameter id

Rückgaben metadatacategories[]histogram

largest_query Analyse

Gibt die N-größten Elemente eines Scans oder Snapshots mit flexibler Gruppierung zurück. Verwenden Sie es, um die größten Dateien, Ordner, Erweiterungen oder Kategorien zu finden.

Parameter sessionId snapshotId pathPrefix groupBy minBytes cursor limit

groupBy-Optionen itemfolderextensionownercategory

Rückgabe pro Eintrag keybytesitemsrisk

list_snapshots Schnappschüsse

Listet alle gespeicherten Festplatten-Snapshots in chronologischer Reihenfolge auf. Snapshots werden manuell unter „Berichte & Zugriff“ → „Snapshots“ erfasst und stellen einen Zeitpunktstatus Ihrer Festplatte dar.

Parameter cursor limit from to

Rückgabe pro Snapshot idcreatedAtlabelrootScopetotalBytes

diff_snapshots Schnappschüsse

Vergleicht zwei Schnappschüsse und gibt zurück, was zwischen ihnen gewachsen, geschrumpft, aufgetaucht oder verschwunden ist. Filtern Sie nach minimaler Änderungsgröße und gruppieren Sie die Ergebnisse nach Pfad, Erweiterung oder Kategorie.

Parameter baseId compareId groupBy minDeltaBytes cursor limit

Rückgabe pro Eintrag keydeltaBytesdeltaItemsdirectionnotes

get_dev_cleanup_summary Entwicklerbereinigung

Gibt eine aggregierte Zusammenfassung der Entwickler-Caches und Build-Artefakte zurück. Enthält Risikostufen und Hinweise. Nur lesbar, ohne Bereinigungsaktionen.

Parameter sessionId snapshotId cursor limit

Rückgabe pro Profil profileIdnamebytesitemsriskLevelhints[]

Paginierungsgrenzen

Das Standardlimit liegt bei 50, das Maximum bei 200. Alle Listentools geben einen Cursor zum Abrufen der nächsten Seite zurück. Ergebnisse werden immer in einer stabilen, deterministischen Reihenfolge zurückgegeben.

Sicherheit

Nur Loopback

Der Server bindet ausschließlich an 127.0.0.1. Keine LAN-Belastung, kein Internetzugang. Andere Geräte in Ihrem Netzwerk können es nicht erreichen.

Token erforderlich

Jede Anfrage muss Ihr Sitzungstoken enthalten. Ohne diese Angabe lehnt der Server die Anfrage ab und protokolliert den Versuch. Sie können den Token jederzeit rotieren, um den vorherigen Zugriff zu widerrufen.

Anfragelimit

Die Anzahl der Anfragen ist pro Token begrenzt. Dies verhindert, dass außer Kontrolle geratene KI-Agenten den lokalen Server attackieren.

Vollständiges Audit-Protokoll

Jeder Tool-Aufruf wird lokal bei ~/Library/Application Support/StorageRadar/mcp-audit-log.json mit Zeitstempel, Token-ID, Tool-Name, Parametern, Antwortgröße, Latenz und Fehlern protokolliert.

Was der Endpunkt MCP nicht kann

Löschen oder verschieben Sie alle Dateien
Lesen Sie den Inhalt einer beliebigen Datei
Greifen Sie auf das Netzwerk oder das Internet zu
Rufen Sie jedes Werkzeug auf, das nicht in der genehmigten Liste enthalten ist
Führen Sie Empfehlungen aus oder wenden Sie sie automatisch an

Datenschutz und Datenminimierung

StorageRadar befolgt eine Richtlinie zur Datenminimierung für MCP Antworten. Standardmäßig werden verallgemeinerte Pfade zurückgegeben, anstatt genaue Projektnamen oder persönliche Verzeichnisnamen offenzulegen.

Standard (empfohlen)

Verallgemeinerte Pfade

Pfade werden auf Kategorieebene abstrahiert. Zum Beispiel:

Statt ~/Library/Developer/Xcode/DerivedData/MySecretApp-xyz123

Rückgaben ~/Library/Developer/Xcode/DerivedData/*

Dies bedeutet, dass Ihre KI nützliche aggregierte Daten erhält, ohne dass bestimmte Projektnamen oder -kennungen preisgegeben werden.

Optional

Rohpfade (Home-Verzeichnis redigiert)

Für detailliertere Pfade öffnen Sie „Einstellungen“ → „Lokaler MCP-Endpunkt“ → „Konfigurieren“ und wählen in der Zeile „Pfad-Datenschutz“ die Option „Raw paths (home redacted)“. Wenn aktiviert:

Zur gezielten Diagnose werden spezifischere Pfade zurückgegeben
Ihr Home-Verzeichnis wird immer durch ~ ersetzt
Lange Segmente und ID-ähnliche Zeichenfolgen werden automatisch maskiert

Dateiinhalte werden in keinem Modus zurückgegeben. Dies ist eine harte Einschränkung. Der MCP-Server verfügt über keinen Mechanismus zum Lesen oder Übertragen der Inhalte Ihrer Dokumente, Bilder, Codes oder anderer Dateien.

Konfigurationsausschnitt

StorageRadar generiert automatisch das richtige Konfigurations-Snippet für Ihren AI-Client. Öffnen Sie „Einstellungen“ → „Lokaler MCP-Endpunkt“ → „Konfigurieren“ und klicken Sie auf „Client-Konfigurationsausschnitt kopieren“. Unten finden Sie ein Beispiel für Claude Desktop.

Der MCP-Server verwendet den Streamable HTTP-Transport auf Port 7342. Ihr Token steht im Authorization-Header. Es ist kein Proxy oder keine STDIO-Bridge erforderlich.

Claude Desktop / jeder JSON-config-Client

Fügen Sie den Eintrag „storageradar“ zum mcpServers-Objekt in der Konfigurationsdatei Ihres Clients hinzu:

claude_desktop_config.json

{
  "mcpServers": {
    "storageradar": {
      "transport": "streamable_http",
      "url": "http://127.0.0.1:7342/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

Ersetzen Sie <YOUR_TOKEN> durch Ihr Zugriffstoken. Die Zeile „Zugriffstoken“ zeigt es nur maskiert an. StorageRadar gibt die richtigen Werte samt vollständigem Token ein, wenn Sie auf „Client-Konfigurationsausschnitt kopieren“ klicken.

Claude Code (CLI)

Wenn Sie im Terminal Claude Code verwenden, registrieren Sie den Server mit einem Befehl:

Claude Code (CLI)

claude mcp add --transport http storageradar http://127.0.0.1:7342/mcp \
  --header "Authorization: Bearer <YOUR_TOKEN>"

Überprüfen Sie nach dem Herstellen der Verbindung, dass es funktioniert, indem Sie Ihre KI bitten, die StorageRadar MCP Verbindung zu überprüfen. Es ruft get_server_info auf und zeigt die Serverversion und die verfügbaren Funktionen an.

Zugriffstoken erneuern

Klicken Sie jederzeit im Fenster „Lokaler MCP-Endpunkt“ neben „Zugriffstoken“ auf „Erneuern“, um den aktuellen Token ungültig zu machen. Kopieren Sie anschließend den Konfigurationsausschnitt erneut und aktualisieren Sie den Header Authorization in der Konfiguration Ihres Clients. Jede Anfrage mit dem alten Token gibt sofort 403 AUTH_INVALID zurück.

MCP Integration

Was ist die MCP-Integration?

Einrichtungsanleitung

Öffnen Sie die Einstellungen in StorageRadar

MCP aktivieren (schreibgeschützt)

Prüfen Sie Ihr Zugriffstoken

Kopieren Sie den Konfigurationsausschnitt und fügen Sie ihn in Ihren AI-Client ein

Führen Sie zunächst einen Scan durch

Beispiel-Prompts

Verfügbare MCP Werkzeuge

Paginierungsgrenzen

Sicherheit

Nur Loopback

Token erforderlich

Anfragelimit

Vollständiges Audit-Protokoll

Was der Endpunkt MCP nicht kann

Datenschutz und Datenminimierung

Verallgemeinerte Pfade

Rohpfade (Home-Verzeichnis redigiert)

Konfigurationsausschnitt

Claude Desktop / jeder JSON-config-Client

Claude Code (CLI)

Zugriffstoken erneuern