Verbinden Sie einen Ordner mit CSV-Dateien mit Claude mithilfe von MCP.

MCP · CSV-Ordner an Claude

Fragen Claude über Ihre CSV-Ordnerdatei, in einfachem Englisch

Verbinden Sie Claude, Claude Code, Cursor oder einen beliebigen MCP-Client einmalig mit Query Streams. Claude liest die Struktur Ihrer CSV-Datei, generiert die SQL-Abfrage, führt sie schreibgeschützt über den Agenten aus, der bereits mit Ihren Daten arbeitet, und liefert die Ergebnisse. Das Datenbankpasswort gelangt niemals an die KI. Der Vorgang dauert etwa zehn Minuten und ist im kostenlosen Plan enthalten.

Ungefähr 10 Minuten Claude, ChatGPT, Cursor + 11 weitere Kunden Die Datei bleibt an ihrem Speicherort. Schreibgeschützt, immer

Was am Ende dabei herauskommt

A Claude that can answer questions about a folder of CSV 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 · verbunden mit Abfrageströmen Schreibgeschützt

Welche Dateien speisen fileset.sales, und wie viele Zeilen fügt jede Datei hinzu?

qs_get_table_schema qs_run_query Schema-Intelligenz

Drei CSV-Dateien werden gespeist fileset.salesDer Export im September ist mit etwas über 18.000 Reihen der größte.

_Quelldatei	Zeilenanzahl	erste_Zeilen-ID
exports/sales_2026_09.csv	18422	exports/sales_2026_09.csv:0000000
exports/sales_2026_08.csv	17305	exports/sales_2026_08.csv:0000000
exports/sales_2026_07.csv	16988	exports/sales_2026_07.csv:0000000

Soll ich die Gesamtumsätze pro Monat über alle drei Dateien hinweg anzeigen?

Which regions grew the most this month against last month, and did anything drop?

qs_run_query qs_run_query

Every CSV is already one table, so I summed Menge von Region for each month straight from fileset.sales. Two read-only queries:

Region	This month	Last month	Change
West	412,300	348,900	+18%
Mitte	388,120	391,000	−1%
Ost	201,450	262,800	−23%

West is up on more orders, not bigger ones. Ost fell 23%, and it is one account: Harbour Foods ordered every week last month and not once this month. Central is flat. Want the East orders by customer?

Nur SELECT, geprüft vom Agenten Im MCP-Aktivitäts-Tab angemeldet 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.

Der CSV-Ordner Die Karte führt alle CSV-Dateien eines Ordners in einer SQL-Tabelle zusammen, die Claude abfragen kann, und versieht jede Zeile mit dem entsprechenden Dateinamen. Dateien müssen nicht in den Chat hochgeladen werden. Sie geben dem Agenten einmalig den Ordner an, er kopiert die Zeilen in einen lokalen Cache auf seinem Computer und aktualisiert die Tabelle automatisch, sobald neue oder geänderte Dateien eintreffen.

Was Sie benötigen

Ein Query Streams-Konto

MCP ist in allen Tarifen enthalten, auch in der kostenlosen Version. Die kostenlose Version erlaubt einen Schlüssel oder eine verbundene App – mehr benötigt dieser Leitfaden nicht. Melden Sie sich an unter mein.querystreams.de.

Der Agent auf einem Computer, der den Ordner öffnen kann

Version 2.6.0 oder höher. Der Ordner kann sich auf diesem Computer oder auf einer erreichbaren Dateifreigabe befinden. Der Agent läuft als Dienst, daher geben Sie Freigaben als … ein. \\server\share\folder, nicht als zugeordneter Laufwerksbuchstabe. Neu beim Agenten? Installieren Sie es unter Windows, macOS oder Linux.

MCP ist für Sie aktiviert

Ersteller, Eigentümer und Administratoren haben von Anfang an Zugriff darauf. Alle anderen benötigen einen Administrator, der die Einstellungen ändert. MCP Schalter neben ihrem Namen unter Konto → ZugriffskontrolleBis dahin heißt es auf der MCP-Seite: „MCP ist für Ihr Konto deaktiviert.“

Ein KI-Client

Claude im Web, Claude Desktop oder die Claude-Mobil-Apps verbinden sich ohne Schlüssel. Claude Code, Cursor, ChatGPT und etwa zehn weitere Tools funktionieren ebenfalls; das Portal bietet für jedes Tool eine vorkonfigurierte Konfiguration.

Richten Sie es in vier Schritten ein

1. Richten Sie den Agenten auf den Ordner aus.

   Im Portal geöffnet Daten → DatenagentenSuchen Sie den Agenten, der den Ordner öffnen kann, und klicken Sie darauf. Anschluss hinzufügen Schaltfläche. Unterhalb der Dateien und Ordner Klicken Sie auf die Pille. CSV-Ordner Karte. Der Zauberer führt Sie dann durch Ordner, Überprüfen, Einstellungen, Reich und Rezension:

   Ordner

   Geben Sie die Stammverzeichnisse, einer pro Zeile, als Pfade auf dem Computer des Agenten. Unterordner scannen ist eingeschaltet, Maximale Tiefe ist 8. Muster einbeziehen beginnt mit dem richtigen Glob für diesen Dateityp; hinzufügen Ausschlussmuster Wenn der Ordner Dateien enthält, die Sie nicht benötigen. Ein zugeordneter Laufwerksbuchstabe wird mit einer gelben Warnung angezeigt: Der Agent kann ihn nicht erkennen, verwenden Sie daher den \\server\share stattdessen den Pfad.

   Überprüfen

   Der Agent liest eine Stichprobe von bis zu 64 Dateien und zeigt an, was er erstellen wird. Es wird noch nichts erstellt. Bereit zum Erstellen Das bedeutet, dass jede Stichprobendatei passt. Ein gelbes Banner mit der Aufschrift „{n} von {m} Dateien werden beiseitegelegt“ listet die Dateien auf, die nicht passen. Zeigen Sie, welche Dateien und warumSie können den Konnektor trotzdem erstellen und ihn später korrigieren. Wenn der Ordner verschiedene Layouts enthält, wird ein blaues Bedienfeld angezeigt. Wechseln Sie zu einer Tabelle pro Layout.

   Einstellungen

   Scanintervall (Standardmäßig stündlich, von alle 5 Minuten bis täglich) ist die Häufigkeit, mit der der Agent nach neuen, geänderten und verschwundenen Dateien sucht. Ordner auf Änderungen überwachen Reagiert innerhalb von Sekunden auf lokalen Festplatten. Wenn eine Datei verschwindet Ist Entferne die Zeilen standardmäßig.

   Realm, Rezension

   Wählen Sie den Datenbereich aus, für den die Zeilen gezählt werden, überprüfen Sie die Zusammenfassung und klicken Sie auf Konnektor erstellenDer erste Scan startet sofort; der Anschluss Manifest Der Tab zeigt an, was erstellt wurde und welche Dateien beiseitegelegt wurden.

   • Typ a Tabellenname, Zum Beispiel VerkäufeEs ist auf dieser Karte erforderlich.
   • Muster einbeziehen beginnt als **/*.csv.
   • Wähle ein Tabellenlayout. Ein fixiertes Layout (Standard) Geeignet für wiederkehrende Exporte, die alle einen gemeinsamen Header haben. Ein Tisch pro Layout Geeignet für Ordner, die von Hand zusammengestellt werden, bis zu 25 Layouts.
   • An ÜberprüfenDer Agent liest eine Stichprobe und zeigt die Anzahl der Dateien, die geschätzte Zeilenanzahl und die zu erstellenden Tabellen an. Bei gemischten Ordnerlayouts wird dies in einem blauen Feld angezeigt. Klicken Sie Wechseln Sie zu einer Tabelle pro Layout.
   • Ein gelber Banner listet Dateien auf, die aussortiert werden. Öffnen Zeigen Sie, welche Dateien und warum um den jeweiligen Grund dafür zu erfahren.

2. Schau dir an, welche Tabellen du erhältst

   Alles befindet sich im Dateisatz Schema. Die Datentabelle übernimmt den von Ihnen eingegebenen Namen. TabellennameDie Spalten stammen aus dem CSV-Header, plus _Quelldatei und _row_id in jeder Zeile.

   Tisch	Was es enthält
   fileset.sales	Mit Ein angeheftetes Layouteine Tabelle, benannt nach Ihrem Tabellenname, wobei die Zeilen jeder übereinstimmenden CSV-Datei gespeichert werden.
   Dateiensatz.Bestellungen, fileset.returns	Mit Ein Tisch pro Layout, eine Tabelle pro Layout, benannt nach dem gemeinsamen Teil der Dateinamen. orders_2026_01.csv zu orders_2026_03.csv werden Bestellungen.
   fileset.files	Eine Zeile pro aktuell vorhandener CSV-Datei mit Pfad, Größe und Änderungsdatum.
   fileset.files_events	Die Änderungshistorie, einschließlich einer Drift Zeile für jede beiseitegelegte Datei, mit Angabe des Grundes in Detail.

   Jeder Ordnerverbinder liefert Claude außerdem dieselben Buchhaltungstabellen, alle im Dateisatz Schema:

   Tisch	Was es enthält
   Dateien	Alle Dateien im Ordner: Pfad, Name, Dateiendung, Größe, Erstellungs- und Änderungsdatum. Fragt man „Was befindet sich in diesem Ordner?“, liest Claude dies vor.
   Dateien_Ereignisse	Die Änderungshistorie: eine Zeile pro Datei, die hinzugefügt, geändert, entfernt oder beiseitegelegt wurde (Drift), mit der Zeit in event_at und der Grund dafür Detail.
   Verzeichnisse, Bände	Ordnergrößen und -anzahlen sowie die Datenträger oder Freigaben, auf denen die Stammverzeichnisse liegen.
   _Quelldatei, _row_id	Jede Datenzeile enthält zwei Spalten: die Datei, aus der die Zeile stammt, und eine eindeutige Zeilen-ID innerhalb dieser Datei. Gruppieren nach _Quelldatei um Dateien zu vergleichen.

3. Verbinde dich mit Claude

   Öffnen Streams → Live → MCPEs gibt zwei Wege hinein, und sie enden am selben Ort:

   Chat-Apps · keine Taste

   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/mcpund stellen Sie eine Verbindung über einen Chat her. Es öffnet sich eine Seite mit Abfragestreams. Sie wählen die Organisation und die Berechtigungen aus und klicken auf Verbindung genehmigenNichts zu kopieren, nichts geheim zu halten. Die Verbindung erscheint unter Verbundene Apps und kann dort widerrufen werden.

   Entwicklertools · ein Schlüssel

   Claude Code, Cursor, VS Code und Freunde

   An Meine Schlüssel klicken Schlüssel generierenGib ihm ein Schlüsselname wie zum Beispiel „Claude Code auf meinem Laptop“, behalten Sie Lesen und Ausführen Wenn Sie ein Häkchen gesetzt haben, wählen Sie eine Ablauf (Nie, 30 Tage, 90 Tage oder 1 Jahr) und klicken Schlüssel generierenKopiere es dann Installation fortsetzen: Die Verbinden Der Tab zeigt den genauen Codeausschnitt für Ihr Tool, wobei der Schlüssel bereits ausgefüllt ist.

   Beide Methoden verwenden dieselben drei Berechtigungen, die Sie entweder auf dem Zustimmungsbildschirm oder auf dem Schlüssel auswählen:

   Lesen

   Listen Sie Konnektoren auf, durchsuchen Sie Tabellen und Spalten, lesen Sie Ihre gespeicherten Abfragen und Benachrichtigungsregeln. Es werden niemals Zeilendaten zurückgegeben.

   Ausführen

   Führen Sie schreibgeschützte SQL-Abfragen und gespeicherte Abfragen über Ihren Agenten aus und geben Sie die Zeilen zurück. Ohne diese kann Claude Ihre Daten zwar beschreiben, aber keine Antworten darauf geben.

   Analysieren

   Tabellenprofile erstellen, Beziehungen ermitteln und einen Schema Intelligence-Lauf in die Warteschlange stellen. Dies verbraucht Nova AI-Credits und Datenvolumen, sodass die Zustimmungsabfrage diese Option nicht vorauswählt.

   Schlüssel verloren? Öffnen Meine SchlüsselDas Augensymbol zeigt es erneut an und Vollständigen Schlüssel kopieren Kopiert es. Entzieht es dort, wenn ein Laptop verloren geht; jeder Client, der es benutzt, schlägt beim nächsten Anruf innerhalb von etwa fünf Minuten fehl.

   Wählen Sie dann das Rezept für den Claude aus, den Sie verwenden möchten. Die Serveradresse ist überall dieselbe: https://mcp.querystreams.com/mcp.

   Claude im Web, Claude Desktop und Mobilgeräte kein Schlüssel

   1. Öffnen Einstellungen → Konnektoren und klicken Sie Konnektoren durchsuchen. Query Streams is listed in the Anthropic Connectors Directory: find Abfrageströme und klicken Sie Verbinden. (Or open the directory listing directly and click Verbinden there.)
   2. If your organization hides directory connectors, click Benutzerdefinierten Konnektor hinzufügen instead. Name it Abfrageströme, Paste https://mcp.querystreams.com/mcp, leave the OAuth fields empty, click Hinzufügen, then in any chat click + → Konnektoren durchsuchen → Abfrageströme → Verbinden.
   3. Es öffnet sich ein Tab „Abfrageströme“. Melden Sie sich gegebenenfalls an, wählen Sie die Organisation aus und überprüfen Sie die Abfrage. Lesen und Ausführenoptional Beschränkung auf bestimmte Anschlüsseund klicken Sie Verbindung genehmigen.
   4. Zurück in Claude sehen Sie „Mit Abfrageströmen verbunden“. Wenn Claude zum ersten Mal ein Tool verwendet, werden Sie gefragt; wählen Sie Immer erlauben.

   If you do add it by hand in Claude Desktop, use Einstellungen → Konnektoren → Hinzufügennicht der Chat Marktplatz hinzufügen 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 Schlüssel

   Ein Befehl, mit Ihrem Schlüssel aus „Meine Schlüssel“:

   Terminal

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

   Das schreibt das aktuelle Projekt. .mcp.json. Hinzufügen --scope Benutzer Query Streams in jedem Projekt haben. Ausführen /mcp Im Claude-Code sehen Sie, ob die Verbindung besteht.

   Cursor Schlüssel

   Öffnen Cursor-Einstellungen → MCP → Neuen MCP-Server hinzufügenoder bearbeiten .cursor/mcp.json im Stammverzeichnis Ihres Arbeitsbereichs:

   .cursor/mcp.json

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

   Cursor neu starten oder ausführen MCP: Server neu starten; A Abfrageströme Das Symbol erscheint in der MCP-Statusleiste.

   Etwas anderes verwenden? Der Verbinden Registerkarte enthält sofort einsatzbereite Rezepte für ChatGPT, VS Code, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev und JetBrains AI sowie ein Einfügen und Zusammenführen Werkzeug, das die Abfrageströme Eintrag in eine bereits vorhandene Konfigurationsdatei. Jeder Client, der MCP über HTTP unterstützt, funktioniert: Server https://mcp.querystreams.com/mcp, Kopfzeile X-MCP-Schlüssel (ein Autorisierung: Inhaber (Auch eine Kopfzeile mit demselben Schlüssel funktioniert.)

4. Stelle deine erste Frage

   Beginnen Sie mit etwas, das Sie überprüfen können, indem Sie den Ordner öffnen, sodass Sie sehen können, wie Claude die richtige Tabelle auswählt. Drei Beispiele, die gut mit einem Ordner mit CSV-Dateien funktionieren:

   „Welche CSV-Dateien befinden sich in dem Ordner, und wann wurde jede einzelne zuletzt geändert?“

   Claude fragt nach fileset.files (Ausführen) und listet jede Datei auf mit Größe_Bytes und modifiziert_utc, neueste zuerst.

   „Summieren Sie die Beträge in der Spalte „fileset.sales“ nach Monaten.“

   Claude liest zuerst das Tabellenschema, um die tatsächlichen Spaltennamen zu finden (Lesen), und führt dann einen DuckDB-Ablauf aus. GROUP BY über Ihren Agenten (Ausführen). Sie erhalten eine kleine Tabelle mit den monatlichen Summen.

   „Wurden CSV-Dateien beiseitegelegt, und warum?“

   Claude fragt nach fileset.files_events für Drift und abgelehnt Zeilen, sortiert nach event_at (Ausführen). Sie erhalten jede Datei und den Grund dafür in Detail.

   Um die Verkabelung zu überprüfen, fragen Sie „Welche Query Streams-Konnektoren habe ich?“Claude ruft an qs_list_connectorsund auf Meine Schlüssel der Schlüssel Zuletzt verwendet Die Zeit wird innerhalb weniger Sekunden aktualisiert.

Wie neue, geänderte und gelöschte Dateien angezeigt werden

Was Claude tun kann, sobald er verbunden ist

Claude sieht neunzehn kleine Werkzeuge. Man ruft sie nie selbst an; Claude wählt das passende für die jeweilige Frage aus. Einfach ausgedrückt:

Warum Schema-Intelligenz hier wichtig ist

Jede Antwort, die Claude erhält, wird mit dem Hinweis versehen, woher die Struktur stammt, und Claude passt an, wie sehr er dem Gesehenen vertraut.

Wenn eine Datenbank wichtig ist, führen Sie Schema Intelligence einmalig darauf aus. Nova → Intelligenz. Der Meine Schlüssel Die Registerkarte zeigt ein Abdeckungsfeld pro Anschluss an. Wie Schema Intelligence funktioniert.

Was die Pläne erlauben

MCP ist in allen Tarifen, auch im kostenlosen Tarif, ohne zusätzliche Gebühren enthalten. Jeder Tarif legt fest, wie viele Tasten oder verbundene Apps Sie halten können und wie viele Anrufe Claude pro Minute tätigen darf:

Eine verbundene App zählt als Schlüssel. Zusätzlich zum Minutenwert kann jeder Schlüssel maximal 10 Abfragen pro Minute ausführen. Eine Abfrage liefert bis zu 1.000 Zeilen und läuft bis zu 60 Sekunden, sofern Claude keine weiteren Abfragen anfordert. Die maximale Anzahl an Zeilen und die maximale Laufzeit betragen fünf Minuten. Die von Claude empfangenen Zeilen werden auf Ihr Datenkontingent angerechnet, das gleiche Kontingent, das auch Ihre Excel- und Tabellenkalkulationsabfragen nutzen. Die MCP-Werte werden vor der Komprimierung gemessen, daher sind die Kosten für ein umfangreiches Ergebnis hier höher als für dieselben Zeilen in einer Tabellenkalkulation. Schema Intelligence-Abfragen, die von Claude gestartet werden, verbrauchen Nova AI-Credits, genau wie Abfragen über das Portal. Siehe die Preisseite für die Zulagen.

Es sicher aufbewahren

Gute nächste Schritte

• Run Schema Intelligence auf dem Konnektor, damit Claude Beschreibungen Ihrer eigenen CSV-Spalten sieht, nicht nur die Dateitabellen.
• Fügen Sie einen zweiten Connector im selben Ordner hinzu. Wenn es auch Parquet- oder Excel-Dateien enthält. Ein Konnektor liest einen Dateityp.
• Lesen Sie die Anleitung zum CSV-Ordner. bei Mehrere CSV-Dateien in einer Tabelle zusammenführen für jede Einstellung.

Wenn etwas nicht funktioniert

Fragen, die Menschen stellen

Verwandte Leitfäden

• Verbinden Sie einen Ordner mit Excel-Dateien mit Claude mithilfe von MCP.
• Verbinden Sie einen Ordner mit SQLite-Datenbanken mit Claude mithilfe von MCP
• Verbinden Sie einen Ordner mit Parquet-Dateien mit Claude mithilfe von MCP
• Verbinden Sie einen Ordner mit JSONL-Dateien mit Claude mithilfe von MCP.
• Leitfaden zum CSV-Ordner-Connector
• Query Streams über MCP mit Claude verbinden: Einrichtung, Berechtigungen und Fehlerbehebung
• Alle MCP-Leitfäden