Connectez un dossier de fichiers Parquet à Claude avec MCP.

Dossier en parquetPlan gratuitFlux de requêtesClaude

Dossier Parquet → Claude · avec Query Streams

Avec Query Streams, interrogez votre fichier Parquet Folder en langage courant avec Claude : 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 n’est jamais transmis à l’IA. Environ dix minutes, et le forfait Free suffit.

Commencez gratuitement

Ce que vous obtiendrez

Claude peut répondre à des questions sur un dossier de fichiers Parquet 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 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 correspondantes. 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

Combien de lignes chaque fichier ajoute-t-il à fileset.orders ?

qs_get_table_schema qs_run_query intelligence de schéma

ensembles de fichiers.ordres Il comprend des rangées provenant de trois parties de Parquet. La première partie, celle de septembre, est la plus grande.

_fichier_source	nombre_de_lignes	dernier_identifiant_de_ligne
2026/09/commandes-part-0001.parquet	250000	2026/09/orders-part-0001.parquet:0249999
2026/09/commandes-part-0002.parquet	248731	2026/09/commandes-part-0002.parquet:0248730
2026/08/commandes-part-0001.parquet	231904	2026/08/commandes-part-0001.parquet:0231903

Voulez-vous que je compare le total des commandes entre août et septembre ?

Quelle est la valeur moyenne de nos commandes par canal ce trimestre, et où constate-t-elle une baisse ?

qs_run_query qs_run_query

J'ai regroupé ensembles de fichiers.ordres par canal pour ce trimestre et le précédent, sur l'ensemble des fichiers Parquet :

canal	Ordres	Ordre moyen	par rapport au trimestre précédent
web	184,210	86.40	+4%
mobile	96,004	61.10	−9%
de gros	2,118	1,940.00	+1%

Mobile C'est le seul indicateur qui recule : le panier moyen a baissé de 9 % tandis que le nombre de commandes a augmenté de 12 %, et 38 % des commandes mobiles de ce trimestre sont accompagnées de l'application mobile. BIENVENUE15 Code de réduction appliqué au trimestre précédent (9 %). Le volume est correct ; c’est la réduction qui grève la marge.

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 Dossier en parquet Cette carte transforme un dossier de fichiers Parquet en une table SQL typée que Claude peut interroger, les colonnes et les types étant extraits des pieds de page des fichiers. Aucun visualiseur Parquet ni installation de DuckDB ne sont nécessaires. L'agent lit les fichiers, met les lignes en cache sur son ordinateur et les fournit à Claude au format SQL, en relisant tout fichier modifié.

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 Dossier en parquet 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 commandesCela est obligatoire sur cette carte.
   • Inclure des motifs commence par **/*.parquet.
   • Il n'y a pas Mise en page du tableau choix. Une note explique que tous les fichiers correspondants doivent partager une même mise en page, et que les fichiers qui diffèrent ultérieurement sont mis de côté et signalés.
   • Sur VérifierL'agent analyse jusqu'à 64 fichiers et affiche le nombre de fichiers, leur taille, le nombre estimé de lignes et le nom de la table. Si deux fichiers diffèrent sur le type d'une colonne, une bannière orange indique « L'analyse du schéma a refusé » et en précise la raison. Vous pouvez néanmoins créer le connecteur. L'agent continue de vérifier et affiche la raison sur son écran. Manifeste languette.

2. Voyez quelles tables vous obtenez

   Tout se trouve dans le ensemble de fichiers schéma. Le tableau de données prend votre Nom de la tableLes fichiers peuvent ajouter ou omettre des colonnes : la table contient toutes les colonnes rencontrées, et une colonne manquante dans un fichier est considérée comme NULL.

   Tableau	Ce qu'il contient
   ensembles de fichiers.ordres	Une table nommée par votre Nom de la table, contenant les rangées de chaque fichier Parquet apparié, plus _fichier_source et _row_id.
   ensemble de fichiers.fichiers	Une ligne par fichier Parquet existant, avec son chemin d'accès, sa taille et sa date de modification.
   fileset.files_events	L'historique des changements. A refusé une ligne signifie qu'aucune mise en page n'a pu être épinglée, et une dérive La ligne désigne un fichier qui a été mis de côté.
   répertoires de fichiers	Une ligne par dossier avec le nombre de fichiers et la taille totale, utile pour les arborescences de dossiers partitionnées.

   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 prendre la bonne table. Trois exemples fonctionnent bien avec un dossier de fichiers Parquet :

   « Quels fichiers Parquet se trouvent dans le dossier, et quelle est la taille de chacun ? »

   Claude interroge ensemble de fichiers.fichiers (Exécuter les requêtes) et liste chaque fichier avec taille_octets et modifié_utc.

   « Décrivez les colonnes de fileset.orders, puis affichez dix lignes. »

   Claude lit le schéma de la table, avec les types provenant des pieds de page Parquet (Lecture), puis exécute une opération. SELECTIONNER avec LIMITE 10 via votre agent (Exécuter des requêtes).

   « Un dossier Parquet a-t-il été mis de côté ou refusé ? Pourquoi ? »

   Claude interroge fileset.files_events pour dérive et refusé lignes, triées par événement_à (Exécuter des requêtes). Vous obtenez le fichier et la raison de détail.

   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 travail préparatoire à l'emplacement de votre fichier Parquet Folder, 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

• Exécuter l'intelligence sémantique sur le connecteur afin que Claude voie les descriptions de vos propres colonnes, et pas seulement les tables du fichier.
• Activez la surveillance du dossier pour les modifications si de nouvelles pièces arrivent sur un disque local et que vous les voulez en quelques secondes.
• Consultez le guide des dossiers en parquet à Interroger un dossier de fichiers Parquet 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 JSONL à Claude avec MCP.
• Guide des connecteurs pour dossiers Parquet
• Connexion des flux de requêtes à Claude via MCP : configuration, autorisations et dépannage
• Tous les guides MCP