Connectez votre système de fichiers à Claude avec MCP

Système de fichiers MCP à Claude

Demander Claude à propos de votre fichier système de fichiers, en anglais simple

Connectez Claude, Claude Code, Cursor ou tout autre client MCP à Query Streams une seule fois. Claude analyse la structure de votre fichier système, rédige la requête SQL, l'exécute en lecture seule via l'agent déjà installé sur votre système de fichiers et renvoie les lignes. Aucun mot de passe de base de données n'est transmis à l'IA. L'opération prend environ dix minutes et est incluse dans la version gratuite.

Environ 10 minutes Claude, ChatGPT, Cursor + 11 autres clients Le fichier reste où il est. En lecture seule, toujours

Ce que vous obtiendrez

A Claude that can answer questions about the files and folders on your computer or file share with live, read-only queries over the tables the Agent builds from your files, and tell you which file each answer came from — without ever seeing a login or a file path, and without a firewall change: the Agent already inside your network reads the folder and sends back only the rows. Once the Agent is in place, connecting Claude takes about 90 seconds if you are comfortable with a settings screen. Like this:

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?

Which folders grew the most this month, and is anything unusually large?

qs_run_query qs_run_query

I read répertoires de fichiers for size by folder, then ensemble de fichiers.fichiers for the newest file in each. Both queries were read-only:

chemin	fichiers	size	newest file
Exports/daily	27	10.8 GB	2026-09-27 03:10
Finance/2026	412	2.1 GB	2026-09-27 17:42
Photos/site-visits	1,930	6.4 GB	2026-09-19 08:55

Exports/daily is the one to look at: 27 copies of the same 400 MB dump, one per night, and nothing deletes the old ones. Finance grows the way you would expect. Want the ten largest files under Exports with their dates?

Sélection uniquement, vérifiée par l'agent connecté à l'onglet Activité MCP 6 rows returned across 3 queries

Rather not wire up an AI client at all? On the Business plan, Nova is the assistant built into Query Streams itself. It has every tool Claude gets here, plus the ones Claude does not: it drafts and validates the SQL against your Schema Intelligence model, turns the answer into a chart, and saves the result as a query your team can run from Excel, Google Sheets or the REST API — no key, no connector, nothing to install. Use MCP when your people already live in Claude, Cursor or ChatGPT; use Nova when you want the answers inside the Portal.

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\dossier, pas en tant que lettre de lecteur mappée. Vous découvrez 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 Schema Intelligence.

   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

   In Claude, Query Streams is in the Anthropic Connectors Directory: browse connectors, click Connecter. Elsewhere you paste one address into the app, https://mcp.querystreams.com/mcp, et connectez-vous depuis une conversation. Une page Query Streams s'ouvre, vous sélectionnez l'organisation et les autorisations, puis vous cliquez Approuver la connexionRien à copier, rien à garder secret. La connexion apparaît sous Applications connectées et peut y être révoquée.

   Outils de développement · une clé

   Claude Code, Curseur, VS Code et amis

   Sur Mes clés cliquez Générer une cléDonnez-lui un Nom de la clé comme « Claude Code sur mon ordinateur portable », conservez Lire et Exécuter coché, choisissez un Expiration (Jamais, 30 jours, 90 jours ou 1 an) et cliquez Générer une cléCopiez-le, puis Poursuivre l'installation: le Connecter L'onglet affiche l'extrait de code exact de votre outil, avec la clé déjà renseignée.

   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

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

   Analyser

   Créez des profils de tables, découvrez les relations et lancez une analyse Schema Intelligence. Cette opération consomme des crédits Nova AI et du volume de données ; l’écran de consentement n’est donc jamais pré-coché.

   Vous avez perdu la clé ? Ouvrir Mes clés: l'icône en forme d'œil 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. Ouvrir Paramètres → Connecteurs et cliquez Parcourir les connecteurs. Query Streams is listed in the Anthropic Connectors Directory: find Flux de requêtes et cliquez Connecter. (Or open the directory listing directly and click Connecter there.)
   2. If your organization hides directory connectors, click Ajouter un connecteur personnalisé instead. Name it Flux de requêtes, coller https://mcp.querystreams.com/mcp, leave the OAuth fields empty, click Ajouter, then in any chat click + → Parcourir les connecteurs → 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, é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.

   If you do add it by hand in Claude Desktop, use Paramètres → Connecteurs → Ajouter, pas le chat intégré Ajouter une place de marché option, which expects a git repository. Connectors sync to your Claude account, so the mobile apps and Desktop pick it up automatically. Menu names are Anthropic’s and can move.

   Code Claude clé

   Une seule commande, avec votre clé depuis Mes clés :

   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 Connecter onglet 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écuter). 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), trie 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). 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_connectorset sur Mes clés la clé Dernière utilisation L'heure se met à jour en quelques secondes.

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

Ce que Claude peut faire une fois connecté

Claude repère dix-neuf petits outils. Vous ne les nommez jamais vous-même ; Claude choisit celui qui convient à votre question. En clair :

Pourquoi l'intelligence schématique 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 Schema Intelligence dessus une seule fois. Nova → Intelligence. Le Mes clés L'onglet affiche un panneau de couverture par connecteur. Comment fonctionne l'intelligence schématique.

Ce que les plans permettent

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

Une application connectée compte comme une clé. En plus du tarif par minute, chaque clé peut exécuter jusqu'à 10 requêtes par minute. Une requête renvoie jusqu'à 1 000 lignes et s'exécute pendant 60 secondes maximum, sauf si Claude en demande davantage, dans la limite de 50 000 lignes et 5 minutes. Les lignes reçues par Claude sont décomptées de votre quota Data Realm, le même que celui utilisé par vos requêtes Excel et Sheets. Le MCP est mesuré avant compression ; un résultat volumineux coûte donc plus cher ici que les mêmes lignes dans une feuille de calcul. Les exécutions Schema Intelligence lancées depuis Claude consomment des crédits Nova AI, exactement comme celles lancées depuis le portail. 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