Retour à StorageRadar
Intégrations

MCP Intégration

Laissez votre assistant IA interroger les analyses StorageRadar directement via un point de terminaison sécurisé, local et en lecture seule sur votre Mac. Pas de cloud. Aucun accès aux fichiers. Vous gardez le contrôle.

Lecture seule 127.0.0.1 uniquement Authentifié par jeton Aucun contenu de fichier Aucune suppression

Qu'est-ce que l'intégration MCP ?

Lorsque vous activez MCP dans StorageRadar, l'application exécute un serveur local léger sur 127.0.0.1. Les assistants IA prenant en charge le Model Context Protocol peuvent se connecter à ce serveur et interroger vos analyses de disque en temps réel.

Le serveur est strictement en lecture seule. Il peut répondre à des questions telles que ce qui utilise le plus d'espace ou ce qui a changé depuis la semaine dernière, mais il ne peut pas supprimer de fichiers, déplacer quoi que ce soit ou accéder au contenu des fichiers.

Le point de terminaison MCP est disponible à tous les niveaux. L'activer et l'interrogation des données sont gratuits. L’exécution d’un nettoyage réel basé sur les recommandations de l’IA nécessite toujours le niveau de déverrouillage approprié dans StorageRadar.

Guide de configuration

Connecter votre IA à StorageRadar prend moins de deux minutes.

1

Ouvrir les intégrations dans StorageRadar

Dans la barre latérale, cliquez sur Intégrations. Vous verrez la section MCP en haut de l'écran.

2

Activer MCP (lecture seule)

Activez l'option Activer MCP (lecture seule). L'indicateur d'état passe à Serveur en cours d'exécution et StorageRadar affiche l'adresse et le port du point de terminaison local.

3

Générez votre jeton d'accès

Cliquez sur Générer un jeton. Gardez ce jeton privé. Vous pouvez le renouveler à tout moment pour révoquer le précédent.

4

Copiez l'extrait de configuration et collez-le dans votre client AI

Cliquez sur Copier l'extrait de configuration du client. StorageRadar génère le format de configuration correct pour votre client AI. Collez-le dans la configuration du serveur MCP de votre client.

5

Exécutez d'abord une analyse

Assurez-vous d'avoir exécuté au moins une analyse dans StorageRadar. Les outils MCP fonctionnent sur des données d'analyse indexées, donc un historique d'analyse vide signifie des résultats vides.

Exemples d'invites

Copiez n'importe quelle invite ci-dessous et collez-la dans votre assistant IA après avoir connecté StorageRadar. L’IA appellera les outils MCP appropriés et expliquera les résultats dans un langage simple.

Votre IA ne peut qu'expliquer et recommander. Pour réellement nettoyer, ouvrez StorageRadar et utilisez son flux de travail guidé. L’analyse de l’IA et le nettoyage contrôlé par l’homme sont séparés par conception.

01 Vérification rapide de la connexion
get_server_info
Vérifiez la connexion StorageRadar MCP : affichez la version du serveur, la version de l'API, la version de l'application et toutes les fonctionnalités disponibles.
serverVersion, apiVersion, appVersion, Features[] — confirme que la connexion fonctionne.
02 Sessions d'analyse récentes
list_scan_sessions
Afficher mes 10 dernières sessions d'analyse, la plus récente en premier. Pour chacun : date, volume racine, taille totale en Go, nombre total d'éléments.
Une liste des analyses récentes. Choisissez un sessionId ici pour les requêtes de suivi.
03 Dernière analyse
list_scan_sessionsget_scan_session
Prenez la session d'analyse la plus récente et affichez ses détails : les principales catégories et l'histogramme des tailles. Expliquez où est passé l'espace.
Répartition par catégorie avec une explication en langage simple de la structure d'utilisation de votre disque.
04 Top 30 des articles les plus importants
largest_query
Pour l’analyse la plus récente, affichez les 30 éléments les plus gros, triés du plus grand au plus petit. Incluez la taille en Go et le niveau de risque pour chacun.
Les plus gros consommateurs sur votre disque avec des tailles et des étiquettes de risque.
05 Top 20 des plus gros dossiers
largest_query
Pour l'analyse la plus récente, affichez uniquement les 20 dossiers les plus volumineux, d'une taille minimale de 500 Mo, triés par taille décroissante.
Les plus gros dossiers prêts à être examinés manuellement dans le Finder.
06 Répartition par extension de fichier
largest_query
Pour l'analyse la plus récente, affichez les 15 principaux types de fichiers par taille totale, regroupés par extension. Quels types de fichiers occupent le plus d’espace ?
Distribution d'extensions pour que vous puissiez voir si des vidéos, des archives, des artefacts de construction ou autre chose remplissent votre disque.
07 Panne utilisateur vs système
largest_query
Pour l'analyse la plus récente, affichez l'utilisation du disque regroupée par propriétaire. Quelle part de l’espace revient à moi par rapport au système ? Expliquez la panne.
Agrégats utilisateur et système pour une séparation claire de vos données par rapport aux fichiers macOS.
08 Répertorier les instantanés enregistrés
list_snapshots
Afficher mes 20 derniers instantanés de disque : ID, date, étiquette et taille totale pour chacun. Trier les plus récents en premier.
Une liste d'instantanés prête à être comparée.
09 Pourquoi mon disque a-t-il grossi cette semaine ?
list_snapshotsdiff_snapshots
Prenez l'instantané le plus récent et l'instantané le plus proche d'il y a 7 jours. Comparez-les par catégorie et expliquez ce qui a le plus augmenté.
Deltas de catégorie avec une explication de croissance en langage simple.
10 Qu'est-ce qui a changé après la mise à jour de Xcode ?
list_snapshotsdiff_snapshots
Recherchez les deux instantanés les plus proches de la date du 15/02/2026. Comparez-les par extension et dossier dans des requêtes distinctes. Montrez les éléments de croissance les plus élevés pour chacun.
Croissance par dossier et extension, affichant souvent DerivedData, des simulateurs et des caches Xcode.
11 Seulement des changements importants entre deux instantanés
diff_snapshots
Comparez les instantanés [baseId] et [compareId]. Afficher uniquement les modifications supérieures à 1 Go, limite 100. Regrouper par catégorie.
Seuls les changements significatifs avec moins de bruit.
12 Caches de développement : où est le plus gros volume ?
get_dev_cleanup_summary
Afficher le résumé du nettoyage des développeurs pour l'analyse la plus récente. Triez les profils par taille décroissante et mettez en surbrillance les 5 premiers avec leur taille et leur niveau de risque.
Xcode, npm, Gradle, Docker et d'autres profils classés par taille.
13 Caches de développement hiérarchisés par risque
get_dev_cleanup_summary
Affichez le résumé du nettoyage des développeurs et divisez tous les profils en sécurité, prudence et risque élevé. Recommandez ce qu'il faut nettoyer en premier, ce qu'il faut vérifier avant le nettoyage et ce qu'il faut laisser tranquille.
Un plan prioritaire conscient des risques.
14 Plan de nettoyage manuel en 10 étapes
largest_queryget_dev_cleanup_summary
Sur la base du résumé d'analyse et de nettoyage des développeurs le plus récent, créez un plan de nettoyage manuel en 10 étapes. Commencez par les candidats les plus sûrs et les plus grands et terminez par les éléments qui nécessitent des soins supplémentaires.
Un plan d'action numéroté sur lequel vous pouvez travailler en StorageRadar.
15 Vérifier la politique de confidentialité du chemin
largest_query
Afficher 10 éléments de largest_query pour l'analyse la plus récente. Pour chaque chemin, notez s’il semble généralisé ou détaillé. La politique de confidentialité actuelle semble-t-elle fonctionner ?
Une vérification rapide que votre paramètre de politique de confidentialité Path fonctionne comme prévu.
16 Tendance de croissance du disque sur 5 instantanés
list_snapshots
Prenez les 5 derniers instantanés et créez une brève tendance : taille totale du disque à chaque date, croissance totale sur la période et taux de croissance quotidien moyen en Mo/jour.
Une mini chronologie montrant à quelle vitesse votre disque se remplit.
17 Trouver des pics de croissance anormaux
list_snapshotsdiff_snapshots
Comparez les 3 dernières paires d'instantanés consécutives. Recherchez des catégories ou des dossiers dans lesquels la croissance a été soudaine et inhabituellement importante par rapport aux autres périodes.
Candidats à pic de croissance avec horodatages.
18 Résumé exécutif
get_scan_sessiondiff_snapshotsget_dev_cleanup_summary
Donnez-moi un bref résumé du stockage de mon Mac : taille totale actuelle du disque, 3 principaux consommateurs par catégorie, ce qui a augmenté depuis le dernier instantané et 5 recommandations de nettoyage sécurisée classées par taille.
Un résumé prêt à prendre une décision, sans détails excessifs.
19 Rapport Markdown complet
get_scan_sessionlargest_querydiff_snapshotsget_dev_cleanup_summary
Créez un rapport Markdown pour l'analyse la plus récente. Incluez les principales catégories, les 10 principaux dossiers les plus volumineux, les 10 principaux types de fichiers par extension, le résumé du nettoyage des développeurs trié par taille et les principales modifications entre les deux instantanés les plus récents.
Un document Markdown prêt à enregistrer pour les notes ou le suivi des incidents.
20 Vérifier MCP connexion de bout en bout
get_server_infotools/list
Vérifiez ma connexion de bout en bout StorageRadar MCP : initialisez la session, listez tous les outils disponibles et appelez get_server_info. Montrez ce qui s'est passé et ce que le serveur a renvoyé.
Un bilan de santé complet confirmant que le serveur est en cours d'exécution, authentifié et prêt.

MCP outils disponibles

StorageRadar expose sept outils en lecture seule sur MCP. Votre client IA peut les appeler automatiquement en fonction de votre question. Tous les outils prennent en charge la pagination basée sur le curseur et renvoient des résultats stables et déterministes.

get_server_info Diagnostic

Renvoie la version du serveur, la version de l'API, la version de l'application et la liste des fonctionnalités activées. Utile pour vérifier que la connexion fonctionne.

Retours serverVersionapiVersionappVersionfeatures[]
list_scan_sessions Analyses

Répertorie toutes les sessions d'analyse avec leur état, leur volume racine, leur étendue et leurs statistiques récapitulatives. Prend en charge le filtrage par plage de dates et pagination.

Paramètres cursor limit from to
Retours par session idcreatedAtrootVolumescopestatustotalBytestotalItemsdurationMs
get_scan_session Analyses

Renvoie des métadonnées et des agrégats détaillés pour une session d'analyse spécifique, y compris l'utilisation du disque par catégorie de niveau supérieur.

Paramètres id
Retours metadatacategories[]histogram
largest_query Analyse

Renvoie les N éléments les plus grands d’une analyse ou d’un instantané avec un regroupement flexible. Utilisez-le pour rechercher les fichiers, dossiers, extensions ou catégories les plus volumineux.

Paramètres sessionId snapshotId pathPrefix groupBy minBytes cursor limit
options groupBy itemfolderextensionownercategory
Retours par entrée keybytesitemsrisk
list_snapshots Instantanés

Répertorie tous les instantanés de disque enregistrés par ordre chronologique. Les instantanés sont capturés manuellement à partir des rapports et représentent un état ponctuel de votre disque.

Paramètres cursor limit from to
Renvoie par instantané idcreatedAtlabelrootScopetotalBytes
diff_snapshots Instantanés

Compare deux instantanés et renvoie ce qui a grandi, rétréci, est apparu ou a disparu entre eux. Filtrez par taille minimale de modification et regroupez les résultats par chemin, extension ou catégorie.

Paramètres baseId compareId groupBy minDeltaBytes cursor limit
Retours par entrée keydeltaBytesdeltaItemsdirectionnotes
get_dev_cleanup_summary Nettoyage des développeurs

Renvoie un résumé agrégé des caches des développeurs et des artefacts de build. Comprend des niveaux de risque et des conseils. En lecture seule, sans aucune action de nettoyage.

Paramètres sessionId snapshotId cursor limit
Retours par profil profileIdnamebytesitemsriskLevelhints[]

Limites de pagination

La limite par défaut est de 50, le maximum est de 200. Tous les outils de liste renvoient un curseur pour récupérer la page suivante. Les résultats sont toujours renvoyés dans un ordre stable et déterministe.

Sécurité

Loopback uniquement

Le serveur se lie exclusivement à 127.0.0.1. Pas d'exposition LAN, pas d'accès Internet. Les autres appareils de votre réseau ne peuvent pas l'atteindre.

Jeton requis

Chaque demande doit inclure votre jeton de session. Sans cela, le serveur rejette la demande et enregistre la tentative. Vous pouvez faire pivoter le jeton à tout moment pour révoquer l'accès précédent.

Limitation du débit

Les demandes sont limitées en débit par jeton. Cela empêche les agents IA incontrôlables de marteler le serveur local.

Journal d'audit complet

Chaque appel d'outil est enregistré localement sur ~/Library/Application Support/StorageRadar/mcp-audit-log.json avec l'horodatage, l'ID du jeton, le nom de l'outil, les paramètres, la taille de la réponse, la latence et les erreurs.

Ce que le point de terminaison MCP ne peut pas faire

  • Supprimer ou déplacer des fichiers
  • Lire le contenu de n'importe quel fichier
  • Accéder au réseau ou à Internet
  • Appelez n'importe quel outil ne figurant pas dans la liste approuvée
  • Exécuter ou appliquer automatiquement les recommandations

Confidentialité et minimisation des données

StorageRadar suit une politique de minimisation des données pour les réponses MCP. Par défaut, il renvoie des chemins généralisés plutôt que d'exposer les noms exacts de projets ou de répertoires personnels.

Par défaut (recommandé)

Chemins généralisés

Les chemins sont abstraits au niveau de la catégorie. Par exemple :

Au lieu de ~/Library/Developer/Xcode/DerivedData/MySecretApp-xyz123
Retours ~/Library/Developer/Xcode/DerivedData/*

Cela signifie que votre IA obtient des données globales utiles sans divulguer de noms ou d'identifiants de projets spécifiques.

Facultatif

Chemins bruts, répertoire personnel expurgé

Activez les chemins bruts (accueil expurgé) dans Intégrations → Politique de confidentialité des chemins pour des chemins plus détaillés. Lorsqu'il est activé :

  • Des chemins plus spécifiques sont renvoyés pour des diagnostics ciblés
  • Votre répertoire personnel est toujours remplacé par ~
  • Les segments longs et les chaînes de type ID sont automatiquement masqués

Le contenu du fichier n'est jamais renvoyé dans aucun mode. C'est une contrainte difficile. Le serveur MCP ne dispose d'aucun mécanisme pour lire ou transmettre le contenu de vos documents, images, code ou tout autre fichier.

Extrait de configuration

StorageRadar génère automatiquement l'extrait de configuration correct pour votre client IA. Cliquez sur Copier l'extrait de configuration du client dans l'écran Intégrations. Vous trouverez ci-dessous un exemple pour Claude Desktop.

Le serveur MCP utilise le transport Streamable HTTP sur le port 7342. Votre jeton va dans l'en-tête Authorization. Aucun proxy ou pont stdio n'est nécessaire.

Claude Desktop / tout JSON-client de configuration

Ajoutez l'entrée storageradar à l'objet mcpServers dans le fichier de configuration de votre client :

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

Remplacez <YOUR_TOKEN> par le jeton d'intégrations. StorageRadar remplit les valeurs correctes lorsque vous cliquez sur Copier l'extrait de configuration du client.

Claude Code (CLI)

Si vous utilisez Claude Code dans le terminal, enregistrez le serveur avec une seule commande :

Claude Code (CLI) 
claude mcp add --transport http storageradar http://127.0.0.1:7342/mcp \
  --header "Authorization: Bearer <YOUR_TOKEN>"

Après la connexion, vérifiez que cela fonctionne en demandant à votre IA de vérifier la connexion StorageRadar MCP. Il appellera get_server_info et affichera la version du serveur et les fonctionnalités disponibles.

Faire pivoter votre jeton

Cliquez sur Générer / Faire pivoter le jeton dans StorageRadar à tout moment pour invalider le jeton actuel. Mettez ensuite à jour l'en-tête Authorization dans la configuration de votre client. Toute demande avec l'ancien jeton renvoie immédiatement 403 AUTH_INVALID.