Verbind uw bestandssysteem met Claude via MCP.

MCP · Bestandssysteem naar Claude

Vragen Claude over uw bestandssysteembestand, in begrijpelijke taal

Verbind Claude, Claude Code, Cursor of een andere MCP-client eenmalig met Query Streams. Claude leest de structuur van uw bestandssysteem, schrijft de SQL-query, voert deze alleen-lezen uit via de agent die al bij uw gegevens is geïnstalleerd en geeft de rijen als antwoord. Er komt geen enkel databasewachtwoord bij de AI terecht. Het duurt ongeveer tien minuten en is inbegrepen in het gratis abonnement.

Ongeveer 10 minuten Claude, ChatGPT, Cursor + 11 andere klanten Het bestand blijft op zijn plaats. Alleen-lezen, altijd

Wat je uiteindelijk overhoudt

Een Claude die vragen kan beantwoorden over de bestanden en mappen op uw computer of gedeelde map met live, alleen-lezen query's op de tabellen die de agent opbouwt op basis van uw bestanden, en u vertelt uit welk bestand elk antwoord afkomstig is — zonder ooit een login of bestandspad te hoeven zien, en zonder een wijziging in de firewall: 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 bestanden in fileset.files zijn het meest recent gewijzigd en hoe groot zijn ze?

qs_get_table_schema qs_run_query schema_intelligentie

Hieronder staan de drie meest recent gewijzigde bestanden in uw mappen. Het werkblad voor de kwartaalafsluiting is gisteren laat in de middag gewijzigd.

relatief pad	grootte_bytes	modified_utc
Finance/2026/Q3-close.xlsx	482113	2026-09-25 17:42:10
Contracts/Acme-renewal-2026.pdf	1893402	2026-09-25 14:05:37
Rapporten/wekelijks/ops-samenvatting-w39.docx	96120	2026-09-25 09:18:54

Wil je dat ik laat zien welke mappen deze maand het meest gegroeid zijn? map_snapshots?

Welke mappen zijn deze maand het meest gegroeid, en is er iets opvallend groot tussen?

qs_run_query qs_run_query

Ik heb gelezen bestandenset.mappen voor de grootte per map, dan bestandenset.bestanden voor het nieuwste bestand in elk. Beide query's waren alleen-lezen:

pad	bestanden	maat	nieuwste bestand
Exporten/dagelijks	27	10,8 GB	2026-09-27 03:10
Financiën/2026	412	2,1 GB	2026-09-27 17:42
Foto's/locatiebezoeken	1,930	6,4 GB	2026-09-19 08:55

Exporten/dagelijks Dit is de map die je moet bekijken: 27 kopieën van dezelfde dump van 400 MB, één per nacht, en niets verwijdert de oude bestanden. Financiën groeit zoals je zou verwachten. Wil je de tien grootste bestanden onder Exports met hun datums zien?

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 beschikt over alle tools die Claude hier heeft, plus de tools die Claude 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 met Claude, Cursor of ChatGPT werken; gebruik Nova als u de antwoorden direct in het portaal wilt hebben.

De Bestandssysteem De kaart zet de mappen op uw computer of bestandsshare om in SQL-tabellen die uw bestanden beschrijven: elke naam, pad, grootte en datum, plus een wijzigingsgeschiedenis en mapgroottes. Het indexeert alleen bestandsmetadata en leest geen bestandsinhoud, dus het is geen bestandslezer zoals de referentiebestandsysteemserver van Anthropic, en Claude kan er geen bestanden mee openen, wijzigen of verwijderen. U wijst de agent naar mappen in plaats van naar een databaseserver, en deze bouwt en vernieuwt de tabellen zelf.

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\folderNiet als een toegewezen stationsletter. 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 Bestandssysteem 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.

   • Er is geen Tabelnaam veld. Het bestandssysteem bouwt alleen de inventaristabellen aan.
   • Plaats één map per regel in HoofdmappenDe paden bevinden zich op de agentcomputer. Typ een netwerkshare als \\server\share\folderNiet als een toegewezen stationsletter zoals Z:, omdat de agent als een service draait en geen stations kan zien die bij uw aanmelding zijn toegewezen.
   • Voeg patronen toe begint als **/*.csvVoeg patronen toe voor elk bestandstype dat u wilt weergeven en gebruik ze. Sluit patronen uit Voor alles wat je er liever niet op wilt hebben.
   • Op RekeningDe agent leest een voorbeeld en laat zien hoeveel mappen bereikbaar zijn, hoeveel bestanden overeenkomen en wat hun totale grootte is. Er wordt nog niets aangemaakt.

2. Kijk welke tafels je krijgt

   Het bestandssysteem heeft geen gegevenstabel. Alles bevindt zich in één schema genaamd bestandenset, die de agent in de cache van zijn computer opslaat en bij elke scan vernieuwt. Claude ziet ingebouwde beschrijvingen voor elk van deze tabellen zonder dat er een Semantic Intelligence-run nodig is.

   Tafel	Wat het bevat
   bestandenset.bestanden	Eén rij per bestand dat er nu is: relatief pad, naam, verlenging, grootte_bytes, created_utc, modified_utc en eigenaar (Alleen voor Windows).
   fileset.files_events	De wijzigingsgeschiedenis. Elke rij heeft een event_type zoals verschenen, gewijzigd of verdwenen, de tijd in event_aten de vorige grootte.
   bestandenset.mappen	Eén rij per map met het aantal bestanden. subboom_bytes, oudste en nieuwste bestand, en een reden overslaan wanneer een map niet is gelezen.
   fileset.directory_snapshots	Maximaal één momentopname van de grootte per map per dag, zodat u kunt zien welke mappen groeien.
   bestandenset.volumes	Capaciteit en vrije ruimte van elke schijf, met capaciteit_bytes en vrije_bytes.

   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

   In Claude bevindt Query Streams zich in de Directory van antropische connectoren: blader door connectoren, klik VerbindenElders plak je één adres in de app, https://mcp.querystreams.com/mcpen maak verbinding vanuit een chat. Er wordt een pagina 'Query Streams' geopend, waar u de organisatie en de machtigingen selecteert en klikt. Verbinding goedkeurenNiets om te kopiëren, niets om geheim te houden. De verbinding verschijnt onder Verbonden apps en kan daar worden ingetrokken.

   Ontwikkelaarstools · een sleutel

   Claude Code, Cursor, VS Code en vrienden

   Op Mijn sleutels klik Sleutel genererenGeef het eens een Sleutelnaam zoals "Claude Code op mijn laptop", bewaar Lezen en Uitvoeren aangevinkt, kies een Vervaldatum (Nooit, 30 dagen, 90 dagen of 1 jaar) en klik Sleutel genererenKopieer het vervolgens. Ga verder met installeren: de Verbinden Het tabblad toont het exacte codefragment voor uw tool, waarbij de sleutel al is ingevuld.

   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.

   Uitvoeren

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

   Analyseren

   Profieltabellen, ontdek relaties en plan een Semantic Intelligence-run in. Het verbruikt Nova AI-credits en data, dus het toestemmingsscherm vinkt het nooit vooraf aan.

   Sleutel kwijt? Open Mijn sleutelsHet oogpictogram laat het nogmaals 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 Instellingen → Connectoren en klik Connectoren bekijkenQuery Streams wordt vermeld in de Directory van antropische connectoren: vinden Query-stromen en klik Verbinden(Of open de directorylijst direct en klik) Verbinden daar.)
   2. Als uw organisatie directory-connectoren verbergt, klik dan hier. Voeg een aangepaste connector toe Geef het in plaats daarvan een naam. Query-stromen, plakken https://mcp.querystreams.com/mcpLaat de OAuth-velden leeg en klik. Toevoegenklik vervolgens in een willekeurige chat + → Connectoren bekijken → 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 Uitvoeren, 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 Mijn sleutels:

   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 Verbinden tabblad 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 wat je kunt controleren door de map te openen, zodat je ziet dat Claude naar de juiste tafel grijpt. Drie opties die goed werken met de bestanden en mappen op je computer of gedeelde map:

   “Welke soorten bestanden bevinden zich in deze map en hoeveel ruimte neemt elk bestandstype in beslag?”

   Claude leest de bestandenset.bestanden schema (Lezen), voert vervolgens één query uit die groepeert op verlenging en sommen grootte_bytes (Uitvoeren). Je krijgt een telling en de totale grootte per bestandstype.

   “Welke mappen zijn het grootst en welke zijn overgeslagen?”

   Claude stelt vragen bestandenset.mappen (Uitvoeren), sorteert op subboom_bytes en geeft een lijst weer van alle mappen met een reden overslaan, zoals een in het verleden Maximale diepte.

   “Wat is er de afgelopen zeven dagen uit het gedeelde account verwijderd?”

   Claude stelt vragen fileset.files_events voor verdwenen rijen, gefilterd en gesorteerd op event_at (Uitvoeren). Je krijgt elk ontbrekend bestand te zien en de datum waarop de scan het heeft gedetecteerd.

   Om de bedrading te controleren, kunt u vragen Welke Query Streams-connectoren heb ik?Claude belt qs_list_connectorsen op Mijn sleutels de sleutel is Laatst gebruikt De tijd wordt binnen enkele seconden bijgewerkt.

Hoe nieuwe, gewijzigde en verwijderde bestanden worden weergegeven

Wat Claude kan doen zodra hij verbonden is.

Claude ziet negentien kleine gereedschappen. Je benoemt ze zelf nooit; Claude kiest de juiste uit voor jouw vraag. Simpel gezegd:

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 Mijn sleutels 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 toetsen of verbonden apps je kunt vasthouden en hoeveel gesprekken Claude per minuut mag voeren.

Een verbonden app telt als een sleutel. Naast het bedrag per minuut mag één sleutel maximaal 10 query's per minuut uitvoeren. Een query retourneert maximaal 1.000 rijen en duurt maximaal 60 seconden, tenzij Claude om meer vraagt, tot een maximum van 50.000 rijen en vijf minuten. De rijen die Claude ontvangt, tellen mee voor uw Data Realm-limiet, dezelfde limiet die uw Excel- en Sheets-query's gebruiken. MCP wordt gemeten vóór compressie, dus een breed resultaat kost hier meer dan dezelfde rijen in een spreadsheet. Semantische intelligentie-runs die vanuit Claude worden gestart, verbruiken Nova AI-credits, net zoals vanuit de portal. Bekijk de prijspagina. voor de toeslagen.

Het veilig bewaren

Goede volgende stappen

• Schakel de functie 'Map bewaken op wijzigingen' in. Als je wilt dat nieuwe bestanden binnen enkele seconden op een lokale schijf verschijnen.
• Vraag hoe actueel de gegevens zijn. Claude geeft antwoord vanuit de nieuwste laatst_gezien_utc in bestanden_huidig en de nieuwste event_at in bestanden_gebeurtenissen.
• Lees de volledige handleiding voor bestandssystemen. bij Indexeer een bestandssysteem en voer er query's op uit met SQL. 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.
• De handleiding voor de bestandssysteemconnector
• Querystreams verbinden met Claude via MCP: configuratie, machtigingen en probleemoplossing
• Alle MCP-handleidingen