Connectez des fichiers CSV multi-enregistrements à Claude avec MCP

Fichier CSV multi-enregistrementsPlan gratuitFlux de requêtesClaude

CSV à enregistrements multiples → Claude · avec Query Streams

Avec Query Streams, interrogez Claude en langage courant sur votre fichier CSV à enregistrements multiples : l’Agent déjà présent dans votre réseau exécute le SQL en lecture seule, et aucun mot de passe de base de données ne parvient jamais à l’IA. Comptez environ dix minutes, et l’offre gratuite suffit.

Commencez gratuitement

Ce que vous obtiendrez

Claude peut répondre aux questions concernant les fichiers CSV qui mélangent plusieurs types d'enregistrements grâce à des requêtes 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 connecter, 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. Une fois l'Agent en place, 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

Liste des en-têtes de lots des fichiers de cette semaine, du plus ancien au plus récent.

qs_get_table_schema qs_run_query intelligence de schéma

Claude lit la structure de ensemble de fichiers.data_hdr et détecte les colonnes positionnelles. Il exécute une requête SELECT via votre agent et vous indique qu'il est en cours de lecture. champ_1 comme numéro de lot et champ_2 comme la date du lot.

_fichier_source	champ_1	champ_2
inbound/2026-09-21/batch_0917.csv	B-000917	2026-09-21
inbound/2026-09-23/batch_0918.csv	B-000918	2026-09-23
inbound/2026-09-25/batch_0919.csv	B-000919	2026-09-25

Poursuivez avec les lignes de détail. Claude se joint à data_hdr au tableau détaillé sur _fichier_source et _seq, dans la même conversation.

Additionnez chaque lot cette semaine à partir de ses lignes de détail et signalez ceux qui ne correspondent pas au total de l'en-tête.

qs_get_relationships qs_run_query qs_run_query

J'ai rejoint data_hdr à data_dtl sur _fichier_source et _seq, résumé champ_4 sur les détails et les a comparés à l'en-tête champ_3:

Lot	Total de l'en-tête	Détail total	Correspondre
B-000917	48,210.00	48,210.00	✓
B-000918	51,904.50	51,904.50	✓
B-000919	46,300.00	39,115.25	✗ −7 184,75

B-000919 Il manque 7 184,75. Son dernier détail _seq Le fichier comporte 214 lignes alors que l'en-tête indique 228 ; il a donc été tronqué avant la fin. Il serait judicieux de le redemander avant la facturation.

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.

Certains systèmes génèrent des fichiers CSV qui mélangent plusieurs types d'enregistrements, comme une ligne d'en-tête, des lignes de détail et une ligne de fin, chacune identifiée par une étiquette dans une colonne. Le connecteur CSV multi-enregistrements les sépare afin que Claude puisse interroger chaque type d'enregistrement comme une table distincte. Aucune base de données n'est à configurer. L'agent lit le dossier sur son ordinateur et y met en cache les lignes sous forme de tables SQL.

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 Fichier CSV multi-enregistrements 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 champ. Les tables sont nommées à partir des étiquettes d'enregistrement.
   • Ensemble Organisation des fichiers, le Colonne d'étiquette d'enregistrement (nombre) qui porte l'étiquette, et le Délimiteur.
   • Choisir Portée de la tablePar défaut, une table est créée par étiquette. Un tableau par extension de fichier et par étiquette permet de distinguer les fichiers de types différents qui possèdent la même étiquette.
   • Avant la configuration, l'assistant indique que tous les fichiers correspondants doivent partager la même disposition. La première synchronisation établit la disposition à partir d'un exemple, et les fichiers présentant des différences ultérieures sont mis de côté et signalés.
   • Sur VérifierL'agent lit un échantillon et liste les tables qu'il va créer. Les fichiers qui seront mis de côté apparaissent sous Afficher les fichiers concernés et pourquoi.

2. Voyez quelles tables vous obtenez

   Les tables sont nommées automatiquement, une par étiquette d'enregistrement, comme par exemple : data_hdr pour l'étiquette HDR. Les colonnes sont numérotées par position. champ_1 à champ_N, sans la colonne d'étiquette. Joindre les types d'enregistrements sur _fichier_source et _seq.

   Tableau	Ce qu'il contient
   données_<tag>, Par exemple data_hdr	Chaque ligne portant cette étiquette dans chaque fichier, comme champ_1 à champ_N, plus _seq, _fichier_source et _row_id.
   données_<extension>_<tag>	La même chose, également divisée par extension de fichier, lorsque Portée de la table est Un tableau par extension de fichier et par étiquette.
   fichiers	Chaque fichier correspondant se trouve encore dans le dossier, avec son chemin d'accès, sa taille et sa date de modification.
   fichiers_événements	L'historique des modifications, y compris les lignes de dérive pour les fichiers mis de côté en raison d'une étiquette inconnue ou d'un nombre de colonnes incorrect. Trier par événement_à.
   annuaires	Nombre de fichiers et tailles pour chaque dossier sous la racine.

   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 élément que vous pouvez vérifier en ouvrant le dossier, afin de voir Claude sélectionner le bon tableau. Trois méthodes fonctionnent bien avec les fichiers CSV qui mélangent plusieurs types d'enregistrements :

   « Quels fichiers sont arrivés dans le dossier aujourd'hui ? »

   Claude interroge fileset.files pour obtenir les valeurs de relative_path, size_bytes et modified_utc, du plus récent au plus ancien.

   «Placez l'en-tête de chaque fichier à côté de sa bande-annonce et affichez les deux.»

   Claude joint data_hdr à votre table trailer sur _source_file et _seq et renvoie une ligne par fichier.

   « Des fichiers ont-ils été mis de côté en raison d'une étiquette inconnue ou d'un nombre de colonnes incorrect ? »

   Claude lit les lignes de dérive dans files_events, en commençant par le plus récent event_at, et nomme chaque fichier ainsi que la raison.

   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 du traitement de votre fichier CSV multi-enregistrements, permettant ainsi à votre client IA de se concentrer sur l'analyse. 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

• Exécuter l'intelligence sémantique Claude apprend donc ce que champ_1 à champ_N moyenne dans chaque type d'enregistrement. Les tables de fichiers contiennent déjà des descriptions intégrées.
• Vérifier les fichiers_événements après la première synchronisation pour tout fichier mis de côté pour une étiquette inconnue.
• Consultez le guide complet sur les fichiers CSV multi-enregistrements. dans Interroger des fichiers CSV multi-enregistrements 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 multi-enregistrements
• Connexion des flux de requêtes à Claude via MCP : configuration, autorisations et dépannage
• Tous les guides MCP