Verbind een map met JSONL-bestanden met Claude via MCP.

JSONL-mapGratis planQuery-stromenClaude

JSONL-map → Claude · met Query Streams

Met Query Streams kun je Claude in gewone taal vragen stellen over je JSONL-mapbestand: de Agent die al binnen je netwerk draait, voert de SQL-query alleen-lezen uit en het databasewachtwoord wordt nooit aan de AI doorgegeven. Het duurt ongeveer tien minuten en het Free-abonnement volstaat.

Begin gratis

Wat je uiteindelijk overhoudt

Een Claude die vragen kan beantwoorden over een map met JSON-bestanden met live, alleen-lezen query's op de tabellen die de agent bouwt op basis van uw bestanden, en u kan vertellen uit welk bestand elk antwoord afkomstig is — zonder ooit een login of bestandspad te hoeven zien, en zonder een firewallwijziging: de agent, die zich al in uw netwerk bevindt, leest de map en stuurt alleen de rijen terug. Zodra de agent is geïnstalleerd, duurt het verbinden met Claude ongeveer 90 seconden als u vertrouwd bent met een instellingenscherm. Zoals dit:

Claude · verbonden met querystreams Alleen-lezen

Welke klanten hadden gisteren een 'checkout_failed'-gebeurtenis en in welk bestand stond die?

qs_get_table_schema qs_run_query schema_intelligentie

Claude leest de structuur van fileset.events Eerst weet het welke kolommen zijn afgevlakt. Vervolgens voert het één SELECT-query uit via uw agent, gefilterd op... event_type en de datum van gisteren.

_bronbestand	event_type	klant_id
exports/2026-09-25/web-01.jsonl	checkout_failed	C-104482
exports/2026-09-25/web-02.jsonl	checkout_failed	C-099317
exports/2026-09-25/web-02.jsonl	checkout_failed	C-110206

Elke regel bevat de naam van het bronbestand, zodat u het bestand kunt openen en de regel zelf kunt controleren. Claude beantwoordt de vragen met behulp van de regels die de agent tijdens de laatste scan in de cache heeft opgeslagen.

Hoe gaat het deze week mis bij het afrekenen? Wordt het erger, en voor wie?

qs_run_query qs_run_query

Ik telde checkout_started tegen checkout_failed per dag in fileset.eventsVervolgens werden de mislukkingen van vandaag gegroepeerd op basis van betalingsprovider en foutcode:

Dag	Kassa's	Mislukt	Tarief
25 sep	41,200	1,236	3.0%
26 sep	39,880	1,596	4.0%
27 sep	22,410	2,017	9.0%

Het wordt snel erger. De huidige 9% betreft bijna volledig één aanbieder: 1.840 van de 2.017 faillissementen zijn kaartco met 3ds_timeoutvanaf 06:40. De andere aanbieders hanteren hun normale 3%. Dit is een incident bij een van de aanbieders, niet bij jou tijdens het afrekenen.

Alleen SELECTEREN, gecontroleerd door de agent ingelogd op het tabblad MCP-activiteit 6 rijen geretourneerd verdeeld over 3 zoekopdrachten

Liever helemaal geen AI-client aansluiten? In het bedrijfsplan, Nova MCP is de assistent die is ingebouwd in Query Streams zelf. Het maakt gebruik van dezelfde Agent-toolset die uw AI-client hier krijgt, plus wat een externe client niet heeft: het stelt de SQL op en valideert deze aan de hand van uw Semantic Intelligence-model, zet het antwoord om in een grafiek en slaat het resultaat op als een query die uw team kan uitvoeren vanuit Excel, Google Sheets of de REST API — geen sleutel, geen connector, niets te installeren. Gebruik MCP als uw medewerkers al werken met Claude, Cursor of ChatGPT; gebruik Nova als u de antwoorden binnen het portaal wilt hebben.

Met de JSONL Folder-connector kunt u JSONL-bestanden bekijken en opvragen vanuit Claude zonder een JSONL-viewer te openen. Wijs de connector naar een map met JSON-regelsbestanden en elke regel wordt een rij, waarbij geneste objecten worden platgemaakt tot kolommen. Er is geen databaseserver nodig. De agent leest de map op zijn eigen computer en slaat de rijen daar op als een SQL-tabel die Claude via MCP kan bevragen.

Wat je nodig hebt

Een Query Streams-account

MCP is beschikbaar in alle abonnementen, ook in het gratis abonnement. Met het gratis abonnement kun je één sleutel of één gekoppelde app gebruiken, en dat is alles wat deze handleiding nodig heeft. Meld je aan via mijn.querystreams.nl.

De agent bevindt zich op een computer die de map kan openen.

Versie 2.6.0 of later. De map kan zich op die computer bevinden of op een gedeelde map die deze kan bereiken. De agent draait als een service, dus typ 'shares' als \\server\share\folder, niet als een toegewezen stationsletter. Op Windows kan het inloggen op een gedeelde map met een opgeslagen gebruikersnaam; op Linux of een Mac moet je de gedeelde map eerst koppelen (Linux onder /mnt of /mediaeen Mac onder /VolumesBent u nieuw bij Agent? Installeer het op Windows., macOS of Linux.

MCP is voor u ingeschakeld.

Makers, eigenaren en beheerders hebben het vanaf het begin. Alle anderen hebben een beheerder nodig om het te kunnen gebruiken. MCP schakelaar naast hun naam onder Account → ToegangsbeheerTot die tijd staat er op de MCP-pagina: "MCP is uitgeschakeld voor uw account".

Een AI-client

Claude op het web, Claude Desktop of de Claude mobiele apps maken zonder sleutel verbinding. Claude Code, Cursor, ChatGPT en ongeveer tien andere tools werken ook; de portal heeft voor elk een kant-en-klaar recept.

Stel het in vier stappen in.

1. Wijs de agent naar de map

   Open het portaal Gegevens → GegevensagentenZoek de agent die de map kan openen en klik erop. Connector toevoegen knop. Onder de Bestanden en mappen pil klik de JSONL-map kaart. De tovenaar leidt je er vervolgens doorheen. Mappen, Rekening, Instellingen, Rijk en Beoordeling:

   Mappen

   Typ de Hoofdmappen, één per regel, als paden op de computer van de agent. Submappen scannen is aan, Maximale diepte is 8. Voeg patronen toe begint met de juiste glob voor dit bestandstype; voeg toe Sluit patronen uit Als de map bestanden bevat die u niet wilt. Een toegewezen stationsletter geeft een oranje waarschuwing weer: de agent kan deze niet zien, gebruik daarom de \\server\share pad in plaats daarvan.

   Rekening

   De agent leest een steekproef van maximaal 64 bestanden en laat zien wat er gebouwd zal worden. Er wordt nog niets aangemaakt. Klaar om te creëren Dit betekent dat elk geselecteerd bestand past. Een amberkleurige banner met de tekst "{n} van {m} bestand(en) worden apart gezet" geeft een overzicht van de bestanden die niet passen. Geef aan welke bestanden het betreft en waarom.Je kunt de connector sowieso maken en ze later repareren. Als de map verschillende lay-outs bevat, verschijnt er een blauw paneel. Schakel over naar één tabel per lay-out..

   Instellingen

   Scaninterval (standaard elk uur, van elke 5 minuten tot dagelijks) bepaalt hoe vaak de agent zoekt naar nieuwe, gewijzigde en verdwenen bestanden. Houd de map in de gaten voor wijzigingen. Reageert binnen enkele seconden op lokale schijven. Wanneer een bestand verdwijnt is Verwijder de rijen standaard.

   Realm, Review

   Selecteer het gegevensdomein waartegen de rijen tellen, controleer het overzicht en klik. Connector makenDe eerste scan start direct; de connector Manifest Het tabblad laat zien wat er is gebouwd en welke bestanden er zijn opgeslagen.

   • Typ a Tabelnaam, Bijvoorbeeld evenementenDit is vereist op deze kaart.
   • Vlakke diepte Hiermee wordt bepaald hoeveel niveaus van geneste objecten als kolommen worden weergegeven. De standaardwaarde is 2 en het bereik is 1 tot 8.
   • Vertrekken Tabelindeling op Eén vastgezette lay-out (standaard) voor terugkerende exporten. Kies Eén tafel per lay-out voor mappen die mensen met de hand invullen.
   • Op RekeningDe agent leest een steekproef van maximaal 64 bestanden en toont het aantal bestanden, de grootte, de geschatte rijgrootte en de tabel die zal worden opgebouwd. Er wordt nog niets aangemaakt. Als de bestanden verschillende structuren hebben, verschijnt er een melding dat de map verschillende bestandsindelingen bevat. Klik Schakel over naar één tabel per lay-out. om elke vorm een eigen tabel te geven.

2. Kijk welke tafels je krijgt

   Je krijgt één tabel met de naam Tabelnaam je typt bijvoorbeeld fileset.eventsGeneste objecten worden kolommen tot aan de Vlakke diepte, en alles wat dieper gaat, wordt als JSON-tekst bewaard. Elke rij bevat _bronbestandZo weet je altijd uit welk bestand het afkomstig is.

   Tafel	Wat het bevat
   evenementen (uw tafelnaam)	Eén rij per JSON-regel uit elk overeenkomend bestand, afgevlakt tot de diepte van Flatten, plus _bronbestand en _rij_id.
   Eén tafel per lay-out	Met Eén tafel per lay-outElke afzonderlijke vorm krijgt een eigen tabel, genoemd naar het gemeenschappelijke deel van de bestandsnamen. Maximaal 25 lay-outs.
   bestanden	Elk overeenkomend bestand dat zich nog in de map bevindt, met pad, grootte en wijzigingsdatum.
   bestanden_gebeurtenissen	De wijzigingsgeschiedenis: verschenen, gewijzigde en verdwenen bestanden, plus afwijkende en geweigerde rijen voor bestanden die niet passen. Sorteren op event_at.
   mappen	Aantal bestanden en bestandsgroottes voor elke map onder de hoofdmap.

   Elke mapconnector geeft Claude ook dezelfde boekhoudtabellen, allemaal in de bestandenset schema:

   Tafel	Wat het bevat
   bestanden	Elk bestand dat zich momenteel in de map bevindt: pad, naam, extensie, grootte, aanmaak- en wijzigingsdatum. Vraag "Wat zit er in deze map?" en Claude leest dit voor.
   bestanden_gebeurtenissen	De wijzigingsgeschiedenis: één rij per bestand dat is verschenen, gewijzigd, verdwenen of opzij is gezet (drift), met de tijd in event_at en de reden in detail.
   mappen, volumes	Mapgroottes en -aantallen, en de schijven of gedeelde mappen waarop de hoofdbestanden zich bevinden.
   _bronbestand, _rij_id	Elke gegevensrij bevat twee kolommen: het bestand waar de rij vandaan komt en een stabiele rij-ID binnen dat bestand. Groeperen op _bronbestand om bestanden te vergelijken.

3. Verbind Claude

   Open Streams → Live → MCPEr zijn twee ingangen, en ze leiden allebei naar dezelfde plek:

   Chat-apps · geen sleutel

   claude.ai, Claude Desktop, ChatGPT

   Open in claude.ai en Claude Desktop de Lijst met querystreams Klik in de Connectors Directory van Anthropic op Verbinden en goedkeuren. Toevoegen via URL, https://mcp.querystreams.com/mcpDit is de terugvaloptie. In ChatGPT voeg je querystreams toe vanuit de app (voorlopig in de ontwikkelaarsmodus) en meld je je aan met querystreams. In beide gevallen wordt een pagina voor querystreams geopend: kies de organisatie en de machtigingen en klik. Verbinding goedkeurenNiets om te kopiëren. De verbinding verschijnt op de Verbindingen tab en kan daar worden ingetrokken.

   Ontwikkelaarstools · een sleutel

   Claude Code, Cursor, VS Code en vrienden

   Klik op de MCP-pagina Verbind een AI-clientDe gids vraagt Hoe zal uw AI-client verbinding maken?: kiezen Gebruik een sleutel in een configuratiebestand, kies je gereedschap, en dan Genereer een sleutel voor het: een Sleutelnaam, Lezen en Voer query's uit aangevinkt, een Vervaldatum (Nooit, 30 dagen, 90 dagen of 1 jaar). Stel het in toont het fragment met de sleutel ingevuld, en Controleer de verbinding wacht op het eerste telefoontje.

   Beide methoden gebruiken dezelfde drie machtigingen, die u kiest op het toestemmingsscherm of in de legenda:

   Lezen

   Toont connectoren, bladert door tabellen en kolommen, leest uw opgeslagen query's en waarschuwingsregels. Geeft nooit rijgegevens terug.

   Voer query's uit

   Voer alleen-lezen SQL-query's en opgeslagen query's uit via uw agent en retourneer de rijen. Zonder dit kan uw AI-client uw gegevens wel beschrijven, maar er geen antwoorden op geven.

   Analyseren

   Profileer tabellen, ontdek relaties en zet een Semantic Intelligence-run in de wachtrij. Profilering en ontdekking zijn gratis; een Semantic Intelligence-run verbruikt Nova AI-tegoed en gegevenslimiet, daarom is deze optie op het toestemmingsscherm nooit vooraf aangevinkt.

   Sleutel kwijt? Het staat vermeld op de Verbindingen tab: Onthul de volledige sleutel laat het opnieuw zien en Kopieer de volledige sleutel kopieert het. Trek het daar in als een laptop vermist raakt; elke klant die het gebruikt, faalt bij het volgende gesprek, binnen ongeveer vijf minuten.

   Kies vervolgens het recept voor de Claude die je gebruikt. Het serveradres is overal hetzelfde: https://mcp.querystreams.com/mcp.

   Claude op het web, Claude voor desktop en mobiel geen sleutel

   1. Open de Lijst met querystreams in de Connectors Directory van Anthropic en klik VerbindenIn de desktopversie bevindt het zich dan onder + → Connectors.
   2. Terugvaloptie, als uw organisatie directory-connectoren verbergt: Instellingen → Connectoren → Aangepaste connector toevoegen, naam Query-stromen, URL https://mcp.querystreams.com/mcp, OAuth-velden leeg, Toevoegen; vervolgens in een chat + → Query-stromen → Verbinden.
   3. Er wordt een tabblad 'Query Streams' geopend. Meld u aan als daarom wordt gevraagd, selecteer de organisatie en bekijk de resultaten. Lezen en Voer query's uit, optioneel Beperk tot specifieke connectorenen klik Verbinding goedkeuren.
   4. In Claude zie je 'Verbonden met querystreams'. De eerste keer dat Claude een tool gebruikt, wordt er om een keuze gevraagd; kies Altijd toestaan.

   Als je het handmatig toevoegt in Claude Desktop, gebruik dan het volgende: Instellingen → Connectoren → Toevoegen, niet de chatfunctie Voeg een marktplaats toe Deze optie vereist een Git-repository. Connectors synchroniseren met je Claude-account, waardoor de mobiele apps en de desktopversie deze automatisch herkennen. Menunamen zijn van Anthropic en kunnen worden gewijzigd.

   Claude Code sleutel

   Eén commando, met uw sleutel uit het tabblad Verbindingen:

   Terminal

   claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp \ --header "X-MCP-Key: qsmcp_PASTE_YOUR_KEY_HERE"

   Dat schrijft het huidige project. .mcp.json. Toevoegen --scope gebruiker Om querystreams in elk project te hebben. Uitvoeren /mcp Kijk binnen in de Claude-code om te zien hoe het werkt.

   Cursor sleutel

   Open Cursorinstellingen → MCP → Nieuwe MCP-server toevoegenof bewerken .cursor/mcp.json aan de basis van je werkruimte:

   .cursor/mcp.json

   { "mcpServers": { "querystreams": { "url": "https://mcp.querystreams.com/mcp", "headers": { "X-MCP-Key": "qsmcp_PASTE_YOUR_KEY_HERE" } } } }

   Cursor opnieuw starten of uitvoeren MCP: Servers opnieuw opstarten; A querystreams Het badge verschijnt in de statusbalk van het MCP.

   Gebruik je iets anders? De portal Verbind een AI-client gids Bevat kant-en-klare recepten voor ChatGPT, VS Code, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev en JetBrains AI, plus een Plakken en samenvoegen gereedschap dat de querystreams een invoer in een configuratiebestand dat je al hebt. Elke client die MCP via HTTP ondersteunt, werkt: server https://mcp.querystreams.com/mcp, koptekst X-MCP-sleutel (een Autorisatie: Houder Een header met dezelfde sleutel werkt ook.

4. Stel je eerste vraag

   Begin met iets dat je kunt controleren door de map te openen, zodat je ziet dat Claude de juiste tabel selecteert. Drie voorbeelden die goed werken met een map vol JSON-bestanden:

   Welke JSONL-bestanden zijn de afgelopen dag gewijzigd?

   Claude voert een query uit op fileset.files voor relative_path, size_bytes en modified_utc, waarbij de nieuwste bestanden eerst worden opgevraagd.

   "Hoeveel gebeurtenissen van elk gebeurtenistype hebben we deze week per dag gehad?"

   Claude groepeert de gegevenstabel op dag en gebeurtenistype. Geneste velden zijn al kolommen, dus er kan direct op gefilterd worden.

   “Zijn er JSONL-bestanden apart gezet, en waarom?”

   Claude leest de afwijkende en geweigerde rijen in files_events, met de nieuwste event_at eerst, en benoemt elk bestand en geeft de reden daarvoor.

   Om de bedrading te controleren, kunt u vragen Welke Query Streams-connectoren heb ik?Claude belt qs_list_connectors, de Portal-gids Controleer de verbinding stap zegt Aangeslotenen de sleutel of app op de Verbindingen tab toont zijn Laatst gebruikt tijd binnen enkele seconden.

Een bestand openen op een gedeelde netwerkmap

De agent opent bestanden als een achtergrondservice, niet als een gewone gebruiker. Daarom is er voor een bestand op een andere computer een extra stap nodig. Welke stap dat is, hangt af van de computer waarop de agent draait.

Als de test het aandeel niet kan vinden, zoek dan in het resultaat naar de volgende woorden: onbereikbaar Dit betekent dat de computer van de agent geen antwoord van de server heeft ontvangen. Op Linux of een Mac, niet gemonteerd Dit betekent dat de gedeelde map nog moet worden aangekoppeld, en dat bericht bevat het exacte aankoppelcommando voor uw server.

Hoe nieuwe, gewijzigde en verwijderde bestanden worden weergegeven

Wat Claude kan doen zodra hij verbonden is.

Uw AI-client ziet de Query Streams-tools en kiest de juiste tool voor uw vraag. Het portaal Hulpmiddelen tabblad geeft een overzicht van alle tools en modi die bij je abonnement zijn inbegrepen. Query Streams vraagt je AI-client om de kolommen van elke tabel te lezen voordat deze een query uitvoert, zodat de echte namen worden gebruikt in plaats van te gokken. Bij elk abonnement, ook Free:

De analytische hulpmiddelen. Bij betaalde abonnementen doet de Agent het voorbereidende werk in de map waar uw JSONL-bestand zich bevindt, zodat uw AI-client zich kan concentreren op het denkwerk. De gratis versie werkt zoals altijd.

De standaardinstellingen bevinden zich op de Context tabblad: limiet voor tekstcellen, schemaweergave, resultaatgrootte, standaardinstellingen voor analyse en vastgehouden resultaten.

Waarom semantische intelligentie hier van belang is

Elk antwoord dat Claude ontvangt, is voorzien van een label dat aangeeft waar de structuur vandaan komt, en Claude past vervolgens aan in hoeverre hij de informatie die hij ziet vertrouwt.

Als een database van belang is, voer er dan eenmaal een Semantic Intelligence-test op uit. Nova → IntelligentieDe Verbindingen Het tabblad toont een overzichtspaneel per connector. Hoe werkt semantische intelligentie?.

Wat de plannen toestaan

MCP is bij elk abonnement inbegrepen, ook bij het gratis abonnement, zonder extra kosten. Elk abonnement bepaalt hoeveel sleutels of verbonden apps je kunt vasthouden en hoeveel gesprekken je AI-client per minuut mag voeren.

Een gekoppelde app telt als een sleutel. Naast het bedrag per minuut mag één sleutel maximaal 10 query's per minuut uitvoeren. Een query duurt maximaal 60 seconden, tenzij uw AI-client om meer vraagt, tot maximaal vijf minuten. Uw abonnement bepaalt ook hoeveel rijen één query retourneert en, met de Analytic-toolset, hoe lang en hoe groot een vastgehouden resultaat mag zijn. de volledige MCP-handleiding geeft alle plannen weer. Wat je AI-client ontvangt, telt mee voor je Data Realm-limiet, dezelfde limiet die je Excel- en Sheets-query's gebruiken: bij AI-agentgebruik (MCP) telt elke byte die aan je AI-client wordt geleverd mee, zowel resultaten, schemalezingen als pagina's met vastgehouden resultaten, vóór eventuele transportcompressie die je client onderhandelt; bij spreadsheetquery's telt het gecomprimeerde resultaat dat je Network Agent levert. Semantic Intelligence-runs die vanuit je AI-client worden gestart, verbruiken Nova AI-tegoed, net als wanneer ze vanuit de Portal worden gestart. Bekijk de prijspagina. voor de toeslagen.

Het veilig bewaren

Goede volgende stappen

• Voer Semantische Intelligentie uit Op de connector zodat Claude beschrijvingen in begrijpelijke taal krijgt van uw eigen kolommen. De bestandstabellen bevatten al ingebouwde beschrijvingen.
• Verkort het scaninterval Als er vaak nieuwe bestanden binnenkomen, controleert de agent de map standaard elk uur.
• Lees de volledige handleiding voor JSONL-mappen. in Zet een map met JSON-bestanden om in SQL-tabellen. voor elke instelling.

Als iets niet werkt

Vragen die mensen stellen

Gerelateerde handleidingen

• Een map met CSV-bestanden koppelen aan Claude met MCP
• Een map met Excel-bestanden koppelen aan Claude met MCP
• Verbind een map met SQLite-databases met Claude via MCP.
• Verbind een map met Parquet-bestanden met Claude via MCP.
• Handleiding voor de JSONL Folder-connector
• Querystreams verbinden met Claude via MCP: configuratie, machtigingen en probleemoplossing
• Alle MCP-handleidingen