Connectez un dossier de fichiers JSONL à Claude avec MCP.

Dossier MCP · JSONL à Claude

Demander Claude à propos de votre fichier de dossier JSONL, 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 JSONL, génère la requête SQL, l'exécute en lecture seule via l'agent déjà connecté à vos données, 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 a folder of JSON lines 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 clients ont rencontré un événement checkout_failed hier, et dans quel fichier cela s'est-il produit ?

qs_get_table_schema qs_run_query intelligence de schéma

Claude lit la structure de ensembles de fichiers.événements Tout d'abord, il identifie les colonnes aplaties existantes. Ensuite, il exécute une requête SELECT via votre agent, filtrée sur type_événement et la date d'hier.

_fichier_source	type_événement	numéro de client
exports/2026-09-25/web-01.jsonl	échec de la transaction	C-104482
exports/2026-09-25/web-02.jsonl	échec de la transaction	C-099317
exports/2026-09-25/web-02.jsonl	échec de la transaction	C-110206

Chaque ligne indique son fichier source ; vous pouvez donc ouvrir le fichier et vérifier la ligne vous-même. Claude répond à partir des lignes mises en cache par l’agent lors de sa dernière analyse.

How is checkout failing this week? Is it getting worse, and for whom?

qs_run_query qs_run_query

I counted checkout_started against échec de la transaction per day in ensembles de fichiers.événements, then grouped today’s failures by payment.provider et error.code:

Day	Checkouts	Failed	Rate
25 Sep	41,200	1,236	3.0%
26 Sep	39,880	1,596	4.0%
27 Sep	22,410	2,017	9.0%

It is getting worse fast. Today’s 9% is almost entirely one provider: 1,840 of the 2,017 failures are cardco avec 3ds_timeout, starting at 06:40. The other providers are at their normal 3%. That is a provider incident, not your checkout.

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 connecteur de dossier JSONL permet de visualiser et d'interroger des fichiers JSONL depuis Claude sans avoir à ouvrir de visionneuse JSONL. Il suffit de lui indiquer un dossier contenant des fichiers JSON : chaque ligne devient une ligne, les objets imbriqués étant aplatis en colonnes. Aucun serveur de base de données n'est requis. L'agent lit le dossier sur son propre ordinateur et y stocke les lignes sous forme de table SQL que Claude interroge via MCP.

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 JSONL 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 événementsCela est obligatoire sur cette carte.
   • Aplatir la profondeur Définit le nombre de niveaux d'objets imbriqués qui deviennent des colonnes. La valeur par défaut est 2 et la plage de valeurs va de 1 à 8.
   • Partir Mise en page du tableau sur Une disposition épinglée (par défaut) pour les exportations récurrentes. Choisissez Une table par mise en page pour les dossiers que les gens remplissent à la main.
   • Sur VérifierL'agent lit un échantillon de 64 fichiers maximum et affiche le nombre de fichiers, leur taille, une estimation du nombre de lignes et le tableau qu'il va créer. Rien n'est encore créé. Si les fichiers ont des formats différents, un panneau indique que le dossier contient plusieurs formats de fichiers différents. Cliquez Passez à une table par mise en page pour attribuer à chaque forme sa propre table.

2. Voyez quelles tables vous obtenez

   Vous obtenez une table nommée par le Nom de la table vous tapez, par exemple ensembles de fichiers.événementsLes objets imbriqués deviennent des colonnes jusqu'au niveau inférieur. Aplatir la profondeuret les données plus détaillées sont conservées sous forme de texte JSON. Chaque ligne contient _fichier_source, pour que vous sachiez toujours de quel fichier il provient.

   Tableau	Ce qu'il contient
   événements (nom de votre table)	Une ligne par ligne JSON de chaque fichier correspondant, aplatie à la profondeur Flatten, plus _fichier_source et _row_id.
   Une table par mise en page	Avec Une table par mise en pageChaque forme distincte possède sa propre table, nommée d'après la partie commune de son nom de fichier. Jusqu'à 25 mises en page.
   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	Historique des modifications : fichiers apparus, modifiés et supprimés, ainsi que les lignes « dérive » et « refusé » pour les fichiers ne correspondant pas au format. 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

   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 accéder à la bonne table. Trois exemples fonctionnent bien avec un dossier de fichiers de lignes JSON :

   « Quels fichiers JSONL ont été modifiés au cours des dernières 24 heures ? »

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

   « Combien d'événements de chaque type avons-nous reçus par jour cette semaine ? »

   Claude regroupe le tableau de données par jour et par type d'événement. Les champs imbriqués étant déjà des colonnes, il est possible de les filtrer directement.

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

   Claude lit les lignes de dérive et de refus dans files_events, newest event_at en premier, et nomme chaque fichier et sa raison.

   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, Claude obtient des descriptions claires de vos colonnes. Les tables de fichiers contiennent déjà des descriptions intégrées.
• Réduire l'intervalle de numérisation Si de nouveaux fichiers sont fréquemment ajoutés, l'agent vérifie le dossier toutes les heures par défaut.
• Consultez le guide complet des dossiers JSONL dans Transformer un dossier de fichiers JSON en tables 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 de dossier JSONL
• Connexion des flux de requêtes à Claude via MCP : configuration, autorisations et dépannage
• Tous les guides MCP