Connectez votre système de fichiers à Claude avec MCP

Système de fichiersPlan gratuitFlux de requêtesClaude

Système de fichiers → Claude · avec Query Streams

Avec Query Streams, interrogez Claude sur votre fichier du système de fichiers en langage courant : l’Agent déjà présent dans votre réseau exécute les requêtes SQL en lecture seule, et aucun mot de passe de base de données ne parvient jamais à l’IA. Comptez une dizaine de minutes, et l’offre Free suffit.

Commencez gratuitement

Ce que vous obtiendrez

Claude peut répondre à vos questions sur les fichiers et dossiers de votre ordinateur ou de votre partage de fichiers grâce à des requêtes en temps réel, en lecture seule, sur les tables que l'Agent construit à partir de vos fichiers. Il vous indique le fichier d'origine de chaque réponse, sans jamais avoir besoin de vous identifier, de saisir un chemin d'accès ou de modifier votre pare-feu : l'Agent, déjà présent sur votre réseau, lit le dossier et renvoie uniquement les lignes correspondantes. Une fois l'Agent installé, la connexion à Claude prend environ 90 secondes si vous êtes à l'aise avec une interface de configuration. Voici un exemple :

Claude · connecté aux flux de requêtes Lecture seule

Quels sont les fichiers du répertoire fileset.files qui ont été modifiés le plus récemment, et quelle est leur taille ?

qs_get_table_schema qs_run_query intelligence de schéma

Voici les trois fichiers les plus récemment modifiés dans vos dossiers. Le classeur de clôture trimestrielle a été modifié hier en fin d'après-midi.

chemin relatif	taille_octets	modifié_utc
Finance/2026/T3-clôture.xlsx	482113	2026-09-25 17:42:10
Contracts/Acme-renewal-2026.pdf	1893402	2026-09-25 14:05:37
Rapports/hebdomadaires/résumé-opérations-w39.docx	96120	2026-09-25 09:18:54

Vous voulez que je vous montre quels dossiers ont le plus progressé ce mois-ci ? instantanés_de_répertoire?

Quels dossiers ont le plus grossi ce mois-ci, et y en a-t-il qui sont particulièrement volumineux ?

qs_run_query qs_run_query

J'ai lu répertoires de fichiers pour la taille par dossier, puis ensemble de fichiers.fichiers pour le fichier le plus récent dans chaque cas. Les deux requêtes étaient en lecture seule :

chemin	fichiers	taille	fichier le plus récent
Exportations/quotidiennes	27	10,8 Go	2026-09-27 03:10
Finance/2026	412	2,1 Go	2026-09-27 17:42
Photos/visites de sites	1,930	6,4 Go	2026-09-19 08:55

Exportations/quotidiennes Voici le fichier à examiner : 27 copies du même dump de 400 Mo, une par nuit, et rien ne supprime les anciennes. Les finances évoluent comme prévu. Vous souhaitez consulter les dix plus gros fichiers sous Exports, avec leurs dates ?

Sélection uniquement, vérifiée par l'agent connecté à l'onglet Activité MCP 6 lignes ont été renvoyées en 3 requêtes.

Vous préférez ne pas du tout connecter de client IA ? Concernant le plan d'affaires, Nova Nova est l'assistant intégré à Query Streams. Il utilise les mêmes outils que votre client IA, ainsi que des fonctionnalités supplémentaires : il génère et valide la requête SQL par rapport à votre modèle d'intelligence sémantique, transforme la réponse en graphique et enregistre le résultat sous forme de requête exécutable par votre équipe depuis Excel, Google Sheets ou l'API REST, sans clé, sans connecteur ni installation. Utilisez MCP si vos équipes utilisent déjà Claude, Cursor ou ChatGPT ; utilisez Nova si vous souhaitez que les réponses soient intégrées au portail.

Le Système de fichiers Cette carte transforme les dossiers de votre ordinateur ou de votre partage de fichiers en tables SQL décrivant vos fichiers : nom, chemin, taille et date, ainsi qu’un historique des modifications et la taille des dossiers. Elle indexe uniquement les métadonnées des fichiers et ne lit pas leur contenu. Contrairement au serveur de système de fichiers de référence d’Anthropic, elle ne permet pas d’ouvrir, de modifier ou de supprimer des fichiers, et Claude ne peut ni les ouvrir, ni les modifier, ni les supprimer. L’Agent se connecte aux dossiers au lieu d’utiliser un serveur de base de données ; il crée et met à jour les tables automatiquement.

Ce dont vous aurez besoin

Un compte Query Streams

MCP est inclus dans tous les forfaits, même le forfait gratuit. Le forfait gratuit permet une clé ou une application connectée, ce qui est suffisant pour ce guide. Inscrivez-vous sur mon.querystreams.com.

L'agent sur un ordinateur capable d'ouvrir le dossier

Version 2.6.0 ou ultérieure. Le dossier peut se trouver sur cet ordinateur ou sur un partage de fichiers accessible. L'agent s'exécute en tant que service ; saisissez donc les partages comme suit : \\serveur\partage\dossiernon pas comme une lettre de lecteur mappée. Sous Windows, vous pouvez vous connecter à un partage avec un identifiant enregistré ; sous Linux ou macOS, vous devez d'abord monter le partage (sous Linux, sous Windows). /mnt ou /médias, un Mac sous /VolumesVous êtes nouveau chez l'agent ? Installez-le sur Windows, macOS ou Linux.

MCP activé pour vous

Les créateurs, propriétaires et administrateurs y ont accès dès le départ. Tous les autres ont besoin d'un administrateur pour activer le contrôle parental. MCP interrupteur à côté de leur nom sous Compte → Contrôle d'accèsEn attendant, la page MCP indique « MCP est désactivé pour votre compte ».

Un client IA

Claude sur le web, Claude Desktop ou les applications mobiles Claude se connectent sans clé. Claude Code, Cursor, ChatGPT et une dizaine d'autres outils sont également compatibles ; le portail propose une configuration prédéfinie pour chacun d'eux.

Configurez-le en quatre étapes

1. Indiquez à l'agent le dossier

   Dans le portail ouvert Données → Agents de donnéesTrouvez l'agent qui peut ouvrir le dossier et cliquez dessus. Ajouter un connecteur bouton. Sous le Fichiers et dossiers pilule cliquez sur le Système de fichiers carte. Le magicien vous guide ensuite à travers Dossiers, Vérifier, Paramètres, Royaume et Revoir:

   Dossiers

   Tapez le Dossiers racine, un par ligne, comme chemins d'accès sur l'ordinateur de l'agent. Analyser les sous-dossiers est allumé, Profondeur maximale est 8. Inclure des motifs commence par le bon glob pour ce type de fichier ; ajouter Exclure les motifs si le dossier contient des fichiers indésirables. Une lettre de lecteur mappée affiche un avertissement orange : l’Agent ne peut pas la voir, utilisez donc le \\serveur\partage chemin à la place.

   Vérifier

   L'agent lit un échantillon de 64 fichiers maximum et affiche ce qu'il va créer. Rien n'est encore créé. Prêt à créer Cela signifie que chaque fichier échantillonné correspond. Une bannière orange, « {n} des {m} fichiers seront mis de côté », liste les fichiers qui ne correspondent pas. Afficher les fichiers concernés et pourquoiVous pouvez créer le connecteur et le corriger ultérieurement. Si le dossier contient plusieurs mises en page, un panneau bleu s'affiche. Passez à une table par mise en page.

   Paramètres

   Intervalle de balayage (toutes les heures par défaut, de toutes les 5 minutes à une fois par jour) correspond à la fréquence à laquelle l'agent recherche les fichiers nouveaux, modifiés et disparus. Surveillez le dossier pour les modifications Réagit en quelques secondes sur les disques locaux. Lorsqu'un fichier disparaît est Supprimez ses lignes par défaut.

   Royaume, Critique

   Sélectionnez le domaine de données auquel les lignes sont rattachées, vérifiez le récapitulatif et cliquez Créer un connecteurLe premier scan démarre immédiatement ; celui du connecteur Manifeste L'onglet affiche ce qu'il a construit et les fichiers qu'il a mis de côté.

   • Il n'y a pas Nom de la table Le système de fichiers ne génère que les tables d'inventaire.
   • Placez un dossier par ligne dans Dossiers racineLes chemins d'accès se trouvent sur l'ordinateur de l'agent. Saisissez un partage réseau comme \\serveur\partage\dossier, et non pas comme une lettre de lecteur mappée telle que Z:, car l'Agent s'exécute en tant que service et ne peut pas voir les lecteurs mappés à votre session.
   • Inclure des motifs commence par **/*.csvAjoutez des modèles pour chaque type de fichier que vous souhaitez répertorier, et utilisez-les. Exclure les motifs pour tout ce que vous souhaitez omettre.
   • Sur VérifierL'agent lit un échantillon et indique le nombre de dossiers accessibles, le nombre de fichiers correspondants et leur taille totale. Rien n'est encore créé.

2. Voyez quelles tables vous obtenez

   Le système de fichiers ne possède pas de table de données. Tout est contenu dans un seul schéma appelé ensemble de fichiersCes données sont mises en cache par l'agent sur son ordinateur et actualisées à chaque analyse. Claude dispose ainsi de descriptions intégrées pour chacune de ces tables, sans avoir besoin d'exécuter l'analyse sémantique.

   Tableau	Ce qu'il contient
   ensemble de fichiers.fichiers	Une ligne par fichier existant actuellement : chemin relatif, nom, extension, taille_octets, créé_utc, modifié_utc et propriétaire (Windows uniquement).
   fileset.files_events	L'historique des modifications. Chaque ligne possède un type_événement tels que apparus, modifiés ou disparus, le temps dans événement_àet la taille précédente.
   répertoires de fichiers	Une ligne par dossier avec le nombre de fichiers, octets du sous-arbre, le fichier le plus ancien et le plus récent, et un ignorer_raison lorsqu'un dossier n'a pas été lu.
   fileset.directory_snapshots	Au maximum une capture instantanée de la taille par dossier et par jour, vous pouvez ainsi voir quels dossiers prennent de l'ampleur.
   ensembles de fichiers.volumes	Capacité et espace libre de chaque lecteur, avec capacité_octets et octets libres.

   Chaque connecteur de dossier fournit également à Claude les mêmes tables de comptabilité, le tout dans le ensemble de fichiers schéma:

   Tableau	Ce qu'il contient
   fichiers	Chaque fichier présent dans le dossier : chemin d’accès, nom, extension, taille, dates de création et de modification. Demandez « Que contient ce dossier ? » et Claude vous lira ces informations.
   fichiers_événements	Historique des modifications : une ligne par fichier apparu, modifié, disparu ou mis de côté (dérive), avec le temps en événement_à et la raison dans détail.
   annuaires, volumes	Taille et nombre des dossiers, et disques ou partages sur lesquels résident les fichiers racines.
   _fichier_source, _row_id	Deux colonnes par ligne de données : le fichier d’origine et un identifiant unique au sein de ce fichier. Grouper par _fichier_source comparer les fichiers.

3. Connectez-vous à Claude

   Ouvrir Flux → En direct → MCPIl y a deux entrées, et elles mènent au même endroit :

   Applications de messagerie instantanée · sans clé

   claude.ai, Claude Desktop, ChatGPT

   Dans claude.ai et Claude Desktop, ouvrez le Liste des flux de requêtes dans le répertoire des connecteurs d'Anthropic, cliquez Connecter et approuver. L'ajouter par URL, https://mcp.querystreams.com/mcpIl s'agit de la solution de repli. Dans ChatGPT, vous ajoutez des flux de requêtes depuis l'application (en mode développeur pour le moment) et vous vous connectez avec les flux de requêtes. Dans les deux cas, une page de flux de requêtes s'ouvre : choisissez l'organisation et les autorisations, puis cliquez sur Approuver la connexionRien à copier. La connexion apparaît sur le Connexions onglet et peut être révoqué à cet endroit.

   Outils de développement · une clé

   Claude Code, Curseur, VS Code et amis

   Sur la page MCP, cliquez Connectez un client IALe guide demande Comment votre client IA se connectera-t-il ?: choisir Utilisez une clé dans un fichier de configuration, choisissez votre outil, puis Générer une clé pour il : un Nom de la clé, Lire et Exécuter des requêtes coché, un Expiration (Jamais, 30 jours, 90 jours ou 1 an). Configurez-le affiche l'extrait avec la légende renseignée, et Vérifiez la connexion attend le premier appel.

   Les deux méthodes utilisent les mêmes trois autorisations, que vous choisissez sur l'écran de consentement ou sur la clé :

   Lire

   Consultez les connecteurs, parcourez les tables et les colonnes, lisez vos requêtes enregistrées et vos règles d'alerte. Ne renvoie jamais les données des lignes.

   Exécuter des requêtes

   Exécutez des requêtes SQL en lecture seule et des requêtes enregistrées via votre agent et renvoyez les lignes. Sans cela, votre client IA peut décrire vos données, mais pas y répondre.

   Analyser

   Profilez les tables, découvrez les relations et mettez en file d’attente une exécution de Semantic Intelligence. Le profilage et la découverte sont gratuits ; une exécution de Semantic Intelligence consomme des crédits Nova AI et le quota de données. L’écran de consentement ne la présélectionne donc jamais.

   Vous avez perdu la clé ? Il est répertorié sur le Connexions languette: Afficher la clé complète le montre à nouveau et Copier la clé complète Il est copié. Révoquez-le à cet endroit si un ordinateur portable est perdu ; chaque client l’utilisant échoue à son prochain appel, dans un délai d’environ cinq minutes.

   Choisissez ensuite la recette du Claude que vous utilisez. L'adresse du serveur est la même partout : https://mcp.querystreams.com/mcp.

   Claude sur le web, Claude Desktop et mobile pas de clé

   1. Ouvrez le Liste des flux de requêtes dans le répertoire des connecteurs d'Anthropic et cliquez ConnecterSur ordinateur de bureau, il se trouve alors sous + → Connecteurs.
   2. Solution de repli, si votre organisation masque les connecteurs d'annuaire : Paramètres → Connecteurs → Ajouter un connecteur personnalisé, nom Flux de requêtes, URL https://mcp.querystreams.com/mcp, champs OAuth vides, Ajouter; puis dans une conversation + → Flux de requêtes → Connecter.
   3. Un onglet Flux de requêtes s'ouvre. Connectez-vous si nécessaire, sélectionnez l'organisation et consultez. Lire et Exécuter des requêtes, éventuellement Limiter à des connecteurs spécifiques, et cliquez Approuver la connexion.
   4. De retour dans Claude, vous voyez « Connecté aux flux de requêtes ». La première fois que Claude utilise un outil, il vous demande de choisir. Toujours permettre.

   Si vous l'ajoutez manuellement dans Claude Desktop, utilisez Paramètres → Connecteurs → Ajouter, pas le chat intégré Ajouter une place de marché Cette option nécessite un dépôt Git. Les connecteurs se synchronisent avec votre compte Claude, ce qui permet aux applications mobiles et à l'application de bureau de la prendre en charge automatiquement. Les noms des menus sont ceux d'Anthropic et peuvent être déplacés.

   Code Claude clé

   Une seule commande, avec votre clé de l'onglet Connexions :

   Terminal

   claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp \ --header "X-MCP-Key: qsmcp_PASTE_YOUR_KEY_HERE"

   Cela décrit le projet actuel .mcp.json. Ajouter --scope utilisateur Pour avoir des flux de requêtes dans chaque projet. Exécuter /mcp À l'intérieur du code Claude, pour voir le lien.

   Curseur clé

   Ouvrir Paramètres du curseur → MCP → Ajouter un nouveau serveur MCP, ou modifier .cursor/mcp.json à la racine de votre espace de travail :

   .cursor/mcp.json

   { "mcpServers": { "querystreams": { "url": "https://mcp.querystreams.com/mcp", "headers": { "X-MCP-Key": "qsmcp_PASTE_YOUR_KEY_HERE" } } } }

   Redémarrez le curseur ou exécutez MCP : Redémarrer les serveurs; un flux de requêtes Le badge apparaît dans la barre d'état du MCP.

   Vous utilisez autre chose ? Le portail Connectez un client IA guide contient des recettes prêtes à l'emploi pour ChatGPT, VS Code, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev et JetBrains AI, ainsi qu'un Coller et fusionner l'outil qui laisse tomber le flux de requêtes Ajoutez cette entrée à un fichier de configuration existant. Tout client compatible MCP sur HTTP fonctionne : serveur https://mcp.querystreams.com/mcp, en-tête Clé X-MCP (un Autorisation : Porteur L'en-tête avec la même clé fonctionne également).

4. Posez votre première question

   Commencez par un exemple vérifiable en ouvrant le dossier, afin de voir Claude prendre la bonne table. Voici trois méthodes qui fonctionnent bien avec les fichiers et dossiers de votre ordinateur ou de votre partage de fichiers :

   « Quels types de fichiers contient ce dossier, et combien d'espace occupe chaque type de fichier ? »

   Claude lit le ensemble de fichiers.fichiers schéma (lecture), puis exécute une requête qui regroupe par extension et des sommes taille_octets (Exécutez des requêtes). Vous obtenez le nombre et la taille totale par type de fichier.

   « Quels sont les dossiers les plus volumineux, et lesquels ont été ignorés ? »

   Claude interroge répertoires de fichiers (Exécuter des requêtes), trié par octets du sous-arbre et liste tous les dossiers contenant un ignorer_raison, comme un passé Profondeur maximale.

   « Qu’est-ce qui a été supprimé du compte d’actions au cours des sept derniers jours ? »

   Claude interroge fileset.files_events pour les lignes disparues, filtrées et triées par événement_à (Exécuter les requêtes). Vous obtenez chaque fichier manquant et la date à laquelle l'analyse l'a détecté.

   Pour confirmer le câblage, demandez « De quels connecteurs Query Streams ai-je accès ? »Claude appelle qs_list_connectors, le guide du Portail Vérifiez la connexion étape dit Connecté, et la clé ou l'application sur le Connexions L'onglet affiche son Dernière utilisation en quelques secondes.

Accéder à un fichier sur un partage réseau

L'agent ouvre les fichiers en tant que service en arrière-plan, et non en tant qu'utilisateur. Par conséquent, un fichier situé sur un autre ordinateur nécessite une étape supplémentaire. Cette étape dépend de l'ordinateur sur lequel l'agent est exécuté.

Si le test ne parvient pas à accéder à l'action, recherchez ces mots dans son résultat : injoignable Cela signifie que l'ordinateur de l'agent n'a reçu aucune réponse du serveur. Sous Linux ou Mac, non monté Cela signifie que le partage doit encore être monté, et ce message inclut la commande de montage exacte pour votre serveur.

Affichage des fichiers nouveaux, modifiés et supprimés

Ce que Claude peut faire une fois connecté

Votre client IA visualise les outils Query Streams et sélectionne celui qui convient le mieux à votre question. Le portail Outils onglet répertorie tous les outils et modes inclus dans votre forfait. Query Streams demande à votre client IA de lire les colonnes de chaque table avant d’effectuer une requête, afin qu’il utilise les noms réels au lieu de les deviner. Dans tous les forfaits, y compris Free :

L'ensemble d'outils analytiques. Avec les abonnements payants, l'agent se charge de configurer l'emplacement de votre fichier système, permettant ainsi à votre client IA de se concentrer sur le traitement des données. La version gratuite fonctionne comme d'habitude.

Les valeurs par défaut sont disponibles sur le Contexte onglet: limite de cellules de texte, vue du schéma, taille des résultats, paramètres d'analyse par défaut et résultats mis en attente.

Pourquoi l'intelligence sémantique est importante ici

Chaque réponse que reçoit Claude est étiquetée avec l'origine de la structure, et Claude ajuste son degré de confiance envers ce qu'il voit.

Si une base de données est importante, exécutez l'analyse sémantique une seule fois. Nova → Intelligence. Le Connexions L'onglet affiche un panneau de couverture par connecteur. Comment fonctionne l'intelligence sémantique.

Ce que les plans permettent

MCP est inclus dans tous les forfaits, même le forfait gratuit, sans frais supplémentaires. Chaque forfait définit le nombre de touches ou d'applications connectées que vous pouvez gérer et le nombre d'appels par minute que votre client IA peut effectuer.

Une application connectée compte comme une clé. En plus du débit par minute, chaque clé peut exécuter au maximum 10 requêtes par minute. Une requête s'exécute pendant 60 secondes maximum, sauf si votre client IA en demande davantage (jusqu'à cinq minutes). Votre plan définit également le nombre de lignes renvoyées par une requête et, avec l'ensemble d'outils analytiques, la durée et la taille maximales des résultats conservés. le guide complet du MCP répertorie tous les forfaits. Ce que votre client IA reçoit est décompté de votre quota Data Realm, le même quota que celui utilisé par vos requêtes Excel et Sheets : l’utilisation par l’agent IA (MCP) comptabilise chaque octet transmis à votre client IA, qu’il s’agisse de résultats, de lectures de schéma ou de pages de résultats conservées, avant toute compression de transport négociée par votre client. Les requêtes de feuilles de calcul, quant à elles, comptabilisent le résultat compressé transmis par votre Network Agent. Les exécutions de Semantic Intelligence lancées depuis votre client IA consomment des crédits Nova AI, exactement comme celles lancées depuis le Portal. Consultez la page des prix pour les indemnités.

Le garder en sécurité

Bonnes prochaines étapes

• Activez la surveillance du dossier pour les modifications si vous souhaitez que les nouveaux fichiers apparaissent en quelques secondes sur un disque local.
• Demandez à quel point les données sont récentes. Claude répond depuis le plus récent dernière_vue_UTC dans fichiers_actuels et les plus récents événement_à dans fichiers_événements.
• Consultez le guide complet du système de fichiers à Indexer un système de fichiers et l'interroger avec SQL pour chaque réglage.

Quand quelque chose ne fonctionne pas

Questions que se posent les gens

Guides associés

• Connectez un dossier de fichiers CSV à Claude avec MCP
• Connectez un dossier de fichiers Excel à Claude avec MCP
• Connectez un dossier de bases de données SQLite à Claude avec MCP.
• Connectez un dossier de fichiers Parquet à Claude avec MCP.
• Guide du connecteur du système de fichiers
• Connexion des flux de requêtes à Claude via MCP : configuration, autorisations et dépannage
• Tous les guides MCP