Connectez un dossier de fichiers CSV à Claude avec MCP

MCP · Dossier CSV à Claude

Demander Claude à propos de votre fichier de dossier CSV, 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 CSV, génère la requête SQL, l'exécute en lecture seule via l'agent déjà installé sur votre base de données, et vous 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 a folder of CSV files 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 fichiers alimentent fileset.sales, et combien de lignes chacun ajoute-t-il ?

qs_get_table_schema qs_run_query intelligence de schéma

Flux de trois fichiers CSV fileset.ventesLes exportations de septembre sont les plus importantes, avec un peu plus de 18 000 rangées.

_fichier_source	nombre_de_lignes	première_ligne_id
exports/sales_2026_09.csv	18422	exports/sales_2026_09.csv:0000000
exports/sales_2026_08.csv	17305	exports/sales_2026_08.csv:0000000
exports/sales_2026_07.csv	16988	exports/sales_2026_07.csv:0000000

Vous voulez que je vous donne le total des ventes par mois pour les trois fichiers ?

Which regions grew the most this month against last month, and did anything drop?

qs_run_query qs_run_query

Every CSV is already one table, so I summed montant par région for each month straight from fileset.ventes. Two read-only queries:

région	This month	Last month	Change
Ouest	412,300	348,900	+18%
Central	388,120	391,000	−1%
Est	201,450	262,800	−23%

Ouest is up on more orders, not bigger ones. Est fell 23%, and it is one account: Harbour Foods ordered every week last month and not once this month. Central is flat. Want the East orders by customer?

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 Dossier CSV La carte fusionne tous les fichiers CSV d'un dossier en une seule table SQL que Claude peut interroger, et associe chaque ligne au fichier d'origine. Vous n'avez pas besoin de télécharger de fichiers dans une conversation. Il vous suffit d'indiquer le dossier à l'agent une seule fois ; il copie les lignes dans un cache local sur son ordinateur et met à jour la table en fonction des fichiers ajoutés ou modifiés.

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 Dossier CSV 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é.

   • Tapez a Nom de la table, Par exemple ventesCela est obligatoire sur cette carte.
   • Inclure des motifs commence par **/*.csv.
   • Choisissez un Mise en page du tableau. Une disposition épinglée (par défaut) Convient aux exportations récurrentes qui partagent toutes un même en-tête. Une table par mise en page des dossiers adaptés que les gens assemblent à la main, jusqu'à 25 mises en page.
   • Sur VérifierL'agent lit un échantillon et affiche le nombre de fichiers, une estimation du nombre de lignes et les tables qu'il va créer. Si le dossier contient des mises en page mixtes, un panneau bleu l'indique. Cliquez Passez à une table par mise en page.
   • Une bannière orange indique les fichiers qui seront mis de côté. Ouvrir Afficher les fichiers concernés et pourquoi pour en connaître la raison.

2. Voyez quelles tables vous obtenez

   Tout se trouve dans le ensemble de fichiers schéma. La table de données prend le nom que vous saisissez. Nom de la tableSes colonnes proviennent de l'en-tête du fichier CSV, plus _fichier_source et _row_id sur chaque rangée.

   Tableau	Ce qu'il contient
   fileset.ventes	Avec Une mise en page épinglée, une table nommée par votre Nom de la table, contenant les lignes de chaque fichier CSV correspondant.
   ensembles de fichiers.ordres, fileset.returns	Avec Une table par mise en page, une table par mise en page, nommée d'après la partie commune des noms de fichiers. commandes_2026_01.csv à commandes_2026_03.csv devenir commandes.
   ensemble de fichiers.fichiers	Une ligne par fichier CSV existant, avec son chemin d'accès, sa taille et sa date de modification.
   fileset.files_events	L'historique des modifications, y compris un dérive une ligne pour chaque fichier mis de côté, avec la raison dans détail.

   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 élément que vous pouvez vérifier en ouvrant le dossier, afin de voir Claude sélectionner le bon tableau. Trois exemples fonctionnent bien avec un dossier de fichiers CSV :

   « Quels fichiers CSV se trouvent dans le dossier, et quand chacun d'eux a-t-il été modifié pour la dernière fois ? »

   Claude interroge ensemble de fichiers.fichiers (Exécuter) et liste chaque fichier avec taille_octets et modifié_utc, les plus récents en premier.

   « Totalisez la colonne "montant" du fichier fileset.sales par mois. »

   Claude commence par lire le schéma de la table pour trouver les noms réels des colonnes (Lecture), puis exécute une requête DuckDB. GROUPE PAR Par l'intermédiaire de votre agent (Exécuter), vous recevez un tableau récapitulatif des totaux mensuels.

   « Des fichiers CSV ont-ils été mis de côté, et pourquoi ? »

   Claude interroge fileset.files_events pour dérive et refusé lignes, triées par événement_à (Exécuter). Vous obtenez chaque fichier et la raison dans détail.

   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

• Exécuter l'intelligence schématique sur le connecteur afin que Claude voie les descriptions de vos propres colonnes CSV, et pas seulement les tableaux du fichier.
• Ajoutez un deuxième connecteur sur le même dossier s'il contient également des fichiers Parquet ou Excel. Un connecteur lit un seul type de fichier.
• Consultez le guide du dossier CSV à Combiner plusieurs fichiers CSV en un seul tableau pour chaque réglage.

Quand quelque chose ne fonctionne pas

Questions que se posent les gens

Guides associés

• 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.
• Connectez un dossier de fichiers JSONL à Claude avec MCP.
• Guide du connecteur de dossier CSV
• Connexion des flux de requêtes à Claude via MCP : configuration, autorisations et dépannage
• Tous les guides MCP