Een map met Excel-bestanden koppelen aan Claude met MCP

MCP · Excel-map voor Claude

Vragen Claude over uw Excel-mapbestand, in begrijpelijke taal

Verbind Claude, Claude Code, Cursor of een andere MCP-client eenmalig met Query Streams. Claude leest de structuur van uw Excel-map, schrijft de SQL-query, voert deze alleen-lezen uit via de agent die al met uw gegevens werkt en geeft de rijen als antwoord. Er komt geen 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

A Claude that can answer questions about a folder of Excel workbooks 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 · verbonden met querystreams Alleen-lezen

Welke werkmappen leveren gegevens aan fileset.data_orders, en hoeveel rijen komen er uit elk?

qs_get_table_schema qs_run_query schema_intelligentie

Het bestelformulier is afkomstig uit drie regionale werkboeken. Het werkboek 'West' bevat de meeste rijen.

_bronbestand	rij_aantal	eerste_rij_id
Regions/West-orders-2026.xlsx	4210	Regions/West-orders-2026.xlsx:orders:000000
Regions/East-orders-2026.xlsx	3876	Regions/East-orders-2026.xlsx:orders:000000
Regio's/Centrale-orders-2026.xlsx	2954	Regions/Central-orders-2026.xlsx:orders:000000

Wil je dat ik de ordertotalen per regio voor dit kwartaal vergelijk?

Compare the regions’ September orders. Which one is behind, and why?

qs_run_query qs_run_query

Each workbook is a region and they merge into one table, so one GROEP DOOR op bestandenset.data_orders covers all of them:

Regio	Bestellingen	Winst	vs August
West	4,210	1,210,400	+6%
Oost	3,880	1,041,200	+3%
Noorden	1,905	402,100	−19%

Noorden is behind, and it is not demand: two SKUs (NX-200, NX-210) that were a third of North’s August revenue show zero orders after 9 September. That is the shape of a stock-out, not a sales problem.

Alleen SELECTEREN, gecontroleerd door de agent ingelogd op het tabblad MCP-activiteit 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.

De Excel-map De kaart voegt een map met .xlsx-werkmappen samen tot SQL-tabellen, één per werkblad, zodat Claude vragen over alle werkmappen tegelijk kan beantwoorden. Het is geen invoegtoepassing in Excel. De agent leest de werkmappen op zijn computer, slaat de rijen daar in de cache op en levert ze aan Claude via MCP, waarbij een werkmap opnieuw wordt ingelezen telkens wanneer er wijzigingen in voorkomen.

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 Excel-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.

   • Er is geen Tabelnaam veld. Bladen worden tabellen zoals data_orders.
   • Voeg patronen toe begint als **/*.xlsx. Gebruik Vellen om te beperken welke werkbladen tabellen worden.
   • Kies een Tabelindeling. Eén vastgezette lay-out (standaard) Geschikt voor werkboeken die allemaal dezelfde werkbladen gebruiken. Eén tafel per lay-out Geschikt voor mappen die mensen met de hand in elkaar zetten, tot wel 25 lay-outs.
   • Op RekeningDe agent leest een voorbeeld en geeft een lijst van de tabellen die hij gaat maken. Als de werkmappen verschillende lay-outs bevatten, verschijnt er een blauw paneel met suggesties. Schakel over naar één tabel per lay-out.Een bestand dat geen echte werkmap is, wordt hieronder weergegeven. Geef aan welke bestanden het betreft en waarom.bijvoorbeeld: "onleesbaar als Excel: niet leesbaar als een XLSX-werkmap".

2. Kijk welke tafels je krijgt

   Alles bevindt zich in de bestandenset schema. Tabellen worden voor u benoemd, omdat er geen schema is. Tabelnaam veld. Elke rij bevat _bronbestand en _rij_id.

   Tafel	Wat het bevat
   bestandenset.data_orders	Met Eén vastgezette lay-out, één tabel per blad met de naam data_<sheet>waarbij de rijen van dat blad uit elk werkboek worden bewaard.
   fileset.budget	Met Eén tafel per lay-out, één tabel per lay-out, genoemd naar het gemeenschappelijke deel van de bestandsnamen, of naar de bladnaam als er niets bruikbaars meer over is.
   bestandenset.bestanden	Eén rij per werkmap die er nu is, met het bijbehorende pad, de grootte en de wijzigingsdatum.
   fileset.files_events	De wijzigingsgeschiedenis, inclusief een drift Voor elk werkboek dat apart is gelegd, een rij met de reden daarvoor.

   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, Query Streams is in the Anthropic Connectors Directory: browse connectors, click Verbinden. Elsewhere you paste one address into the 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

   Profileer tabellen, ontdek relaties en plan een Schema Intelligence-run in. Dit verbruikt Nova AI-credits en data, waardoor het toestemmingsscherm dit nooit vooraf aanvinkt.

   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 bekijken. Query Streams is listed in the Anthropic Connectors Directory: find Query-stromen en klik Verbinden. (Or open the directory listing directly and click Verbinden there.)
   2. If your organization hides directory connectors, click Voeg een aangepaste connector toe instead. Name it Query-stromen, plakken https://mcp.querystreams.com/mcp, leave the OAuth fields empty, click Toevoegen, then in any chat click + → 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.

   If you do add it by hand in Claude Desktop, use Instellingen → Connectoren → Toevoegen, niet de chatfunctie Voeg een marktplaats toe 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.

   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 de juiste tabel selecteert. Drie voorbeelden die goed werken met een map vol Excel-werkmappen:

   Welke werkmappen zitten er in de map en wie heeft ze voor het laatst gewijzigd?

   Claude stelt vragen bestandenset.bestanden (Uitvoeren) en geeft een lijst van elk werkboek met modified_utc en eigenaarDe eigenaar wordt alleen in Windows ingevuld.

   "Laat me de kolommen in fileset.data_orders zien en de tien grootste bestellingen."

   Claude leest eerst het tabelschema (Read), en voert vervolgens één bewerking uit. SELECT gesorteerd op de kolom 'bedrag' met LIMIET 10 via uw agent (Uitvoeren).

   “Zijn er deze week werkboeken apart gelegd? Waarom?”

   Claude stelt vragen fileset.files_events voor drift rijen, gefilterd en gesorteerd op event_at (Uitvoeren). Je krijgt elk werkblad en de reden in detail.

   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 schema-intelligentie hier belangrijk 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 belangrijk is, voer dan eenmaal Schema Intelligence erop uit. Nova → IntelligentieDe Mijn sleutels Het tabblad toont een overzichtspaneel per connector. Hoe schema-intelligentie werkt.

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 pool 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. Schema Intelligence-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

• Schema-intelligentie uitvoeren op de connector zodat Claude de beschrijvingen van je eigen spreadsheetkolommen kan zien.
• Vraag hoe actueel de gegevens zijn. Claude ziet de gegevens van de laatste scan en de antwoorden van de meest recente versie. event_at in bestanden_gebeurtenissen.
• Lees de handleiding voor Excel-mappen. bij Meerdere Excel-bestanden samenvoegen tot één tabel. voor elke instelling.

Als iets niet werkt

Vragen die mensen stellen

Gerelateerde handleidingen

• Een map met CSV-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.
• Verbind een map met JSONL-bestanden met Claude via MCP.
• Handleiding voor de Excel-mapconnector
• Querystreams verbinden met Claude via MCP: configuratie, machtigingen en probleemoplossing
• Alle MCP-handleidingen