Multi-record CSV → Claude · mit Query Streams
Mit Query Streams können Sie Claude in einfachem Deutsch Fragen zu Ihrer Multi-record-CSV-Datei stellen: Der Agent, der sich bereits in Ihrem Netzwerk befindet, führt SQL schreibgeschützt aus, und kein Datenbankpasswort gelangt jemals zur KI. Die Einrichtung dauert etwa zehn Minuten und ist im kostenlosen Tarif enthalten.
Kostenlos starten
Was am Ende dabei herauskommt
Ein Agent namens Claude kann Fragen zu CSV-Dateien beantworten, die verschiedene Datensatztypen mischen. Er führt Live-Abfragen im Nur-Lese-Modus über die Tabellen durch, die er aus Ihren Dateien erstellt, und gibt an, aus welcher Datei jede Antwort stammt – ohne jemals einen Login oder Dateipfad zu sehen und ohne Firewall-Änderungen: Der Agent, der sich bereits in Ihrem Netzwerk befindet, liest den Ordner und sendet nur die Zeilen zurück. Sobald der Agent eingerichtet ist, dauert die Verbindung zu Claude etwa 90 Sekunden, wenn Sie mit der Bedienung eines Einstellungsbildschirms vertraut sind. So geht's:
Listen Sie die Batch-Header der Dateien dieser Woche auf, beginnend mit der ältesten.
Claude liest die Struktur von fileset.data_hdr und erkennt Positionsspalten. Es führt eine SELECT-Anweisung über Ihren Agenten aus und meldet Ihnen, dass es liest. Feld_1 als Chargennummer und Feld_2 als Chargendatum.
| _Quelldatei | Feld_1 | Feld_2 |
|---|---|---|
| inbound/2026-09-21/batch_0917.csv | B-000917 | 2026-09-21 |
| inbound/2026-09-23/batch_0918.csv | B-000918 | 2026-09-23 |
| inbound/2026-09-25/batch_0919.csv | B-000919 | 2026-09-25 |
Folgen Sie den Details. Claude schließt sich an. data_hdr zur Detailtabelle auf _Quelldatei und _seq, im selben Chat.
Die Summe jeder Charge wird diese Woche anhand ihrer Detailzeilen ermittelt. Alle Chargen, deren Summe nicht mit der Kopfsumme übereinstimmt, werden gekennzeichnet.
Ich habe mich angeschlossen data_hdr zu data_dtl An _Quelldatei und _seq, zusammengefasst Feld_4 auf die Details und verglichen sie mit den Angaben in der Überschrift. Feld_3:
| Charge | Gesamtsumme im Header | Detail Gesamt | Übereinstimmen |
|---|---|---|---|
| B-000917 | 48,210.00 | 48,210.00 | ✓ |
| B-000918 | 51,904.50 | 51,904.50 | ✓ |
| B-000919 | 46,300.00 | 39,115.25 | ✗ −7.184,75 |
B-000919 ist um 7.184,75 zu niedrig. Das letzte Detail _seq Die Datei hat 214 Zeilen, während im Header 228 Zeilen angegeben sind. Daher wurde die Datei vor dem Trailer abgeschnitten. Es empfiehlt sich, die Datei vor der Rechnungsstellung erneut anzufordern.
Lieber gar keinen KI-Client einrichten? Zum Geschäftsplan Nova Der in Query Streams integrierte Assistent nutzt dieselben Agenten-Tools wie Ihr KI-Client und bietet darüber hinaus Funktionen, die externe Clients nicht haben: Er erstellt und validiert die SQL-Abfrage anhand Ihres Semantic-Intelligence-Modells, wandelt das Ergebnis in ein Diagramm um und speichert es als Abfrage, die Ihr Team aus Excel, Google Sheets oder der REST-API ausführen kann – ganz ohne Schlüssel, Konnektor oder Installation. Nutzen Sie MCP, wenn Ihre Mitarbeiter bereits mit Claude, Cursor oder ChatGPT arbeiten; verwenden Sie Nova, wenn Sie die Ergebnisse direkt im Portal benötigen.
Manche Systeme erstellen CSV-Dateien, die verschiedene Datensatztypen in einer Datei mischen, z. B. Kopfzeile, Detailzeilen und einen Nachtrag, jeweils gekennzeichnet durch ein Tag in einer Spalte. Der Multi-Record-CSV-Connector trennt diese Daten, sodass Claude jeden Datensatztyp als separate Tabelle abfragen kann. Es muss keine Datenbank eingerichtet werden. Der Agent liest den Ordner auf seinem Computer und speichert die Zeilen dort als SQL-Tabellen im Cache.
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\folderNicht als zugeordneter Laufwerksbuchstabe. Unter Windows kann man sich mit einem gespeicherten Login bei einer Freigabe anmelden; unter Linux oder Mac muss die Freigabe zuerst eingebunden werden (Linux unter /mnt oder /Medien, ein Mac unter /VolumesNeu 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.
Wo findet die Arbeit statt? Auf dem Computer, auf dem der Agent läuft, wird der Ordner gescannt, die Zeilen werden dort in einen lokalen Cache kopiert und die von Claude geschriebenen SQL-Abfragen werden auf diesen Cache angewendet. Die Dateien selbst verlassen diesen Computer nie, und auch nichts, was Claude nicht angefordert hat.
Richten Sie es in vier Schritten ein
-
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-Datei mit mehreren Datensätzen 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\sharestattdessen 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.
- Es gibt kein Tabellenname Feld. Tabellen werden anhand der Datensatz-Tags benannt.
- Satz Dateilayout, Die Spalte mit Datensatz-Tag (Nummer) das das Etikett hält, und das Trennzeichen.
- Wählen TabellenumfangStandardmäßig wird pro Tag eine Tabelle erstellt. Eine Tabelle pro Dateierweiterung und Tag sorgt dafür, dass gleiche Tags aus verschiedenen Dateitypen getrennt werden.
- Vor der Konfiguration weist der Assistent darauf hin, dass alle übereinstimmenden Dateien dasselbe Layout verwenden müssen. Die erste Synchronisierung übernimmt dieses Layout von einem Beispiel, und Dateien, die später abweichen, werden beiseitegelegt und gemeldet.
- An ÜberprüfenDer Agent liest eine Stichprobe und listet die zu erstellenden Tabellen auf. Dateien, die beiseitegelegt werden, erscheinen unter Zeigen Sie, welche Dateien und warum.
-
Schau dir an, welche Tabellen du erhältst
Die Tabellen werden für Sie benannt, eine pro Datensatz-Tag, zum Beispiel
data_hdrfür das Tag HDR. Die Spalten sind positionsbezogen nummeriert.Feld_1zuFeld_N, ohne die Tag-Spalte. Datensatztypen verknüpfen nach_Quelldateiund_seq.Tisch Was es enthält data_<tag>, Zum Beispieldata_hdrJede Zeile mit diesem Tag aus jeder Datei, wie Feld_1zuFeld_N, plus_seq,_Quelldateiund_row_id.data_<extension>_<tag>Dasselbe gilt auch für die Aufteilung nach Dateierweiterung, wenn Tabellenumfang Ist Eine Tabelle pro Dateierweiterung und Tag. DateienAlle übereinstimmenden Dateien befinden sich noch im Ordner, inklusive Pfad, Größe und Änderungsdatum. Dateien_EreignisseÄnderungshistorie, einschließlich Abweichungszeilen für Dateien, die aufgrund eines unbekannten Tags oder einer falschen Spaltenanzahl zurückgestellt wurden. Sortieren nach event_at.VerzeichnisseAnzahl und Größe der Dateien in jedem Ordner unterhalb des Stammverzeichnisses. Jeder Ordnerverbinder liefert Claude außerdem dieselben Buchhaltungstabellen, alle im
DateisatzSchema:Tisch Was es enthält DateienAlle Dateien im Ordner: Pfad, Name, Dateiendung, Größe, Erstellungs- und Änderungsdatum. Fragt man „Was befindet sich in diesem Ordner?“, liest Claude dies vor. Dateien_EreignisseDie Änderungshistorie: eine Zeile pro Datei, die hinzugefügt, geändert, entfernt oder beiseitegelegt wurde ( Drift), mit der Zeit inevent_atund der Grund dafürDetail.Verzeichnisse,BändeOrdnergrößen und -anzahlen sowie die Datenträger oder Freigaben, auf denen die Stammverzeichnisse liegen. _Quelldatei,_row_idJede Datenzeile enthält zwei Spalten: die Datei, aus der die Zeile stammt, und eine eindeutige Zeilen-ID innerhalb dieser Datei. Gruppieren nach _Quelldateium Dateien zu vergleichen. -
Verbinde dich mit Claude
Öffnen Streams → Live → MCPEs gibt zwei Wege hinein, und sie enden am selben Ort:
Chat-Apps · keine Tasteclaude.ai, Claude Desktop, ChatGPT
Öffnen Sie in claude.ai und Claude Desktop die Abfragestreams-Liste Klicken Sie im Connectors Directory von Anthropic darauf. Verbinden und genehmigen. Hinzufügen per URL,
https://mcp.querystreams.com/mcpDies ist die Ausweichlösung. In ChatGPT fügen Sie Abfragestreams über die App hinzu (derzeit im Entwicklermodus) und melden sich mit Abfragestreams an. In beiden Fällen öffnet sich eine Abfragestreams-Seite: Wählen Sie die Organisation und die Berechtigungen aus und klicken Sie auf Verbindung genehmigenNichts zum Kopieren. Die Verbindung erscheint auf dem Verbindungen Der Tab kann dort aufgerufen und widerrufen werden.Entwicklertools · ein SchlüsselClaude Code, Cursor, VS Code und Freunde
Klicken Sie auf der MCP-Seite Verbinden Sie einen KI-ClientDer Reiseführer fragt Wie wird Ihr KI-Client die Verbindung herstellen?: wählen Verwenden Sie einen Schlüssel in einer KonfigurationsdateiWähle dein Werkzeug aus, dann Generieren Sie einen Schlüssel für es: ein Schlüsselname, Lesen und Abfragen ausführen angekreuzt, ein Ablauf (Nie, 30 Tage, 90 Tage oder 1 Jahr). Richten Sie es ein. zeigt den Codeausschnitt mit der ausgefüllten Legende, und Überprüfen Sie die Verbindung. wartet auf den ersten Anruf.
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.
- Abfragen ausführen
- Führen Sie schreibgeschützte SQL-Abfragen und gespeicherte Abfragen über Ihren Agenten aus und geben Sie die Zeilen zurück. Andernfalls kann Ihr KI-Client Ihre Daten zwar beschreiben, aber keine Antworten darauf geben.
- Analysieren
- Erstelle Tabellenprofile, entdecke Beziehungen und stelle einen Semantic-Intelligence-Lauf in die Warteschlange. Profiling und Discovery sind kostenlos; ein Semantic-Intelligence-Lauf verbraucht Nova-AI-Credits und Datenkontingent und wird daher auf dem Zustimmungsbildschirm nie vorab ausgewählt.
Schlüssel verloren? Es ist aufgeführt auf der Verbindungen Tab: Vollständigen Schlüssel anzeigen zeigt es erneut 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
- Öffnen Sie die Abfragestreams-Liste im Connectors Directory von Anthropic und klicken Sie VerbindenIn der Desktop-Umgebung befindet es sich dann unter + → Connectoren.
- Ausweichlösung, falls Ihre Organisation Verzeichnisverbindungen ausblendet: Einstellungen → Konnektoren → Benutzerdefinierten Konnektor hinzufügen, Name Abfrageströme, URL
https://mcp.querystreams.com/mcp, OAuth-Felder leer, Hinzufügendann in einem Chat + → Abfrageströme → Verbinden. - 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 Abfragen ausführenoptional Beschränkung auf bestimmte Anschlüsseund klicken Sie Verbindung genehmigen.
- 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.
Wenn Sie es manuell in Claude Desktop hinzufügen, verwenden Sie Einstellungen → Konnektoren → Hinzufügennicht der Chat Marktplatz hinzufügen Diese Option erfordert ein Git-Repository. Konnektoren werden mit Ihrem Claude-Konto synchronisiert, sodass die mobilen Apps und die Desktop-Version es automatisch erkennen. Die Menünamen stammen von Anthropic und können geändert werden.
Claude Code Schlüssel
Ein Befehl, mit Ihrem Schlüssel aus der Registerkarte „Verbindungen“:
Terminalclaude 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 BenutzerQuery Streams in jedem Projekt haben. Ausführen/mcpIm Claude-Code sehen Sie, ob die Verbindung besteht.Cursor Schlüssel
Öffnen Cursor-Einstellungen → MCP → Neuen MCP-Server hinzufügenoder bearbeiten
.cursor/mcp.jsonim 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ömeDas Symbol erscheint in der MCP-Statusleiste.Etwas anderes verwenden? Das Portal Verbinden Sie einen KI-Client Führung 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ömeEintrag in eine bereits vorhandene Konfigurationsdatei. Jeder Client, der MCP über HTTP unterstützt, funktioniert: Serverhttps://mcp.querystreams.com/mcp, KopfzeileX-MCP-Schlüssel(einAutorisierung: Inhaber(Auch eine Kopfzeile mit demselben Schlüssel funktioniert.) -
Stelle deine erste Frage
Beginnen Sie mit etwas, das Sie überprüfen können, indem Sie den Ordner öffnen, damit Sie sehen können, wie Claude die richtige Tabelle auswählt. Drei davon eignen sich gut für CSV-Dateien, die verschiedene Datensatztypen enthalten:
- „Welche Dateien sind heute im Ordner angekommen?“
- Claude fragt fileset.files nach relativem Pfad, Größe in Bytes und geänderter UTC ab, wobei die neueste Datei zuerst angezeigt wird.
- „Setzen Sie den Dateikopf neben den zugehörigen Trailer und zeigen Sie beides an.“
- Claude verknüpft data_hdr mit Ihrer Trailer-Tabelle über _source_file und _seq und gibt eine Zeile pro Datei zurück.
- „Wurden Dateien aufgrund eines unbekannten Tags oder einer falschen Spaltenanzahl aussortiert?“
- Claude liest die Driftzeilen in files_events, beginnend mit dem neuesten Ereignis, und benennt jede Datei sowie den Grund.
Um die Verkabelung zu überprüfen, fragen Sie „Welche Query Streams-Konnektoren habe ich?“Claude ruft an
qs_list_connectors, der Portal-Leitfaden Überprüfen Sie die Verbindung. Schritt sagt Verbundenund der Schlüssel oder die App auf dem Verbindungen Der Tab zeigt seine Zuletzt verwendet Zeit innerhalb weniger Sekunden.
Das war’s. Legen Sie eine neue Datei in den Ordner, und nach dem nächsten Scan kann Claude daraus antworten. Die Dateien haben den Computer, auf dem sie sich befanden, nie verlassen, und niemand hat ein Passwort in eine KI eingegeben.
Auf eine Datei in einer Netzwerkfreigabe zugreifen
Der Agent öffnet Dateien als Hintergrunddienst, nicht als Sie. Daher ist für eine Datei auf einem anderen Computer ein zusätzlicher Schritt erforderlich. Welcher Schritt, hängt vom Computer ab, auf dem der Agent ausgeführt wird.
Falls der Test die Aktie nicht erreichen kann, suchen Sie in seinem Ergebnis nach folgenden Wörtern: nicht erreichbar Das bedeutet, dass der Computer des Agenten keine Antwort vom Server erhalten hat. Unter Linux oder einem Mac, nicht montiert Das bedeutet, dass die Freigabe noch eingebunden werden muss, und diese Meldung enthält den genauen Mount-Befehl für Ihren Server.
Ordner auf einer Netzwerkfreigabe? Unter Windows deckt ein einziger Login alle Ordner ab, die Sie vom selben Server hinzufügen. Ordner auf Änderungen überwachen Funktioniert auch bei geteilten Daten, nach dem besten Bemühen; der geplante Scan stellt sicher, dass jede Änderung erfasst wird.
Wie neue, geänderte und gelöschte Dateien angezeigt werden
Neue und geänderte Dateien
Auf jedem Scanintervall Der Agent vergleicht die Größe und Änderungszeit jeder Datei mit dem zugehörigen Ledger. Eine neue, passende Datei wird hinzugefügt; eine geänderte Datei wird vollständig neu eingelesen, sodass eine Tabelle niemals zwei Versionen derselben Datei enthält. Aktivieren Ordner auf Änderungen überwachen um innerhalb von Sekunden auf einer lokalen Festplatte zu reagieren.
Gelöschte Dateien
Eine Datei, die verschwindet, verliert ihre Zeilen, es sei denn, Sie haben dies anders ausgewählt. Zeilen beibehalten, gelöschte Zeilen als gelöscht markierenWenn eine Freigabe offline geht und die meisten Dateien auf einmal verschwinden, behält der Agent den zuletzt intakten Bestand bei, anstatt alles zu löschen.
Beiseite gelegte Dateien
Eine Datei, die nicht dem Layout entspricht, nicht geöffnet werden kann oder gesperrt ist, wird beiseitegelegt: Keine ihrer Zeilen wird geladen, und Dateien_Ereignisse Es wird protokolliert, welche Datei und warum. Der Scan wird beim nächsten Ändern automatisch wiederholt. Es gibt keine Schaltfläche „Erneut scannen“.
Was Claude sieht
Die Daten stammen vom letzten Scan. Da kein MCP-Tool einen Scan auslöst, fragen Sie: „Wann wurde dies zuletzt aktualisiert?“ und Claude liest die neuesten Daten vor. event_at In Dateien_Ereignisse für dich.
Was Claude tun kann, sobald er verbunden ist
Ihr KI-Client erkennt die Abfragestream-Tools und wählt das passende für Ihre Frage aus. Das Portal Werkzeuge Registerkarte listet alle Tools und Modi auf, die in deinem Tarif enthalten sind. Query Streams fordert deinen KI-Client auf, vor einer Abfrage die Spalten jeder Tabelle auszulesen, damit er die tatsächlichen Namen verwendet, statt zu raten. In jedem Tarif, auch im kostenlosen:
Ordnen Sie Ihre Daten zu.
Konnektoren, Datenbanken und Agenten; die Tabellen und Spalten Ihrer Multi-Record-CSV-Datei mit Beschreibungen, Beispielwerten und Verknüpfungen, sobald Semantic Intelligence ausgeführt wurde.
Profil erstellen und erkunden
Erstelle ein Profil einer Spalte, bevor du sie filterst; entdecke Joins, die niemand deklariert hat. Für Live-Ausführungen ist Analyze erforderlich.
Führe schreibgeschütztes SQL aus
Eine SELECT-Anweisung im richtigen Dialekt für CSV-Dateien mit mehreren Datensätzen, standardmäßig 60 Sekunden, maximal fünf Minuten. Ihr Ausführungsplan legt die maximale Anzahl der von einer Abfrage zurückgegebenen Zeilen fest. (Abfragen ausführen)
Gespeicherte Abfragen, föderierte Abfragen und Benachrichtigungen
Führen Sie die gespeicherten Abfragen, denen Ihr Team vertraut, mit neuen Werten aus; föderierte Abfragen werden als bereits verknüpft zurückgegeben. Lesen Sie die Alarmregeln und erstellen Sie eine als Testlauf.
Das Analyse-Toolset. Bei kostenpflichtigen Tarifen übernimmt der Agent die Vorarbeit im selben Verzeichnis wie Ihre CSV-Datei mit mehreren Datensätzen, sodass sich Ihr KI-Client auf die eigentliche Verarbeitung konzentrieren kann. Die kostenlose Version funktioniert wie gewohnt.
Kontextmanagement
Persönlicher Kern und darüber hinausGröße des Ergebnisses vor dem Lesen (Form), durchlaufen Sie eine große Datenbank Bereich für Bereich (Ebenen), und die Antworten innerhalb eines Token-Budgets mit nur den Spalten und die benötigten Zelllängen.
Ergebnisanalyse
Persönlicher Kern und darüber hinausA Profil des gesamten Ergebnisses anstelle von Zeilen. Ergebnisse mit Labels, die Folgefragen beantworten und nach Summen gruppieren, ohne eine zweite Abfrage. Datenaktualität und seit Lies nur, was neu ist.
Vertiefende Analyse
Business Core und höherDaten Qualität Bericht, Anomalien, Segmente, eine statistische vergleichen und ein diff zwischen zwei gehaltenen Ergebnissen.
Die Standardeinstellungen befinden sich auf der Kontext Registerkarte: Textzellenlimit, Schemaansicht, Ergebnisgröße, Analysevorgaben und gespeicherte Ergebnisse.
Die Namen der Werkzeuge, falls Sie diese in den Antworten Ihres KI-Clients erkennen möchten.
| Erlaubnis | Werkzeuge |
|---|---|
| Lesen | qs_list_organizations qs_list_agents qs_list_connectors qs_get_si_status qs_get_connector_schema qs_find_tables qs_get_table_schema qs_get_relationships qs_profile_table qs_discover_relationships qs_list_saved_queries qs_alerts qs_result (op=windows) |
| Analysieren | qs_request_si_analysis qs_setup_si qs_get_task_status, wird nur Schlüsselinhabern mit Analyze aufgeführt; Live-Ausführungen von qs_profile_table und qs_discover_relationships |
| Abfragen ausführen | qs_run_query qs_run_saved_query qs_data_freshness qs_result (jeder andere op) qs_result_release qs_create_alert_rule (nur Vorschläge) |
Warum semantische 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.
| Stufe | Was Claude sieht | Ergebnis |
|---|---|---|
| Semantische Intelligenz | Beschreibungen für jede Tabelle und Spalte, Beispielwerte, Bedeutungen der Aufzählungszeichen, deklarierte und erkannte Joins. | Claude schreibt auf Anhieb die richtige Multi-Record-CSV-SQL-Abfrage und erklärt die Daten in Ihren Geschäftsbegriffen. |
| Erfasstes Schema | Tabellen- und Spaltennamen, Datentypen, Schlüssel. | Claude arbeitet, erschließt aber die Bedeutung aus den Namen und fragt möglicherweise nach. |
| Live-Schema | Die Datenbank liegt außerhalb des Erfassungsbereichs des Konnektors, daher wird die Struktur bei jeder Anfrage live gelesen (erfordert die Berechtigung "Abfragen ausführen"; SQL Server, MySQL und PostgreSQL). | Die Abfragen werden weiterhin ausgeführt. Claude verwendet bei Bedarf kleinere SELECT-Anweisungen. |
Wenn eine Datenbank wichtig ist, führen Sie Semantic Intelligence einmalig darauf aus. Nova → Intelligenz. Der Verbindungen Die Registerkarte zeigt ein Abdeckungsfeld pro Anschluss an. Wie semantische Intelligenz funktioniert.
Was die Pläne erlauben
MCP ist in jedem Tarif, auch im kostenlosen Tarif, ohne zusätzliche Gebühren enthalten. Jeder Tarif legt fest, wie viele Schlüssel oder verbundene Apps Sie halten können und wie viele Anrufe pro Minute Ihr KI-Client tätigen darf:
| Planen | Schlüssel pro Benutzer | Schlüssel pro Organisation | Anrufe pro Minute |
|---|---|---|---|
| Kostenlos | 1 | 1 | 30 |
| Persönlicher Kern | 1 | 1 | 60 |
| Personal Plus | 1 | 1 | 90 |
| Kerngeschäft | 2 | 3 | 120 |
| Business Plus | 3 | 5 | 150 |
| Business Max | 5 | 10 | 240 |
| Enterprise Core | 5 | 25 | 300 |
| Enterprise Plus | 8 | 50 | 450 |
| Enterprise Max | 10 | 100 | 600 |
Eine verbundene App zählt als Schlüssel. Zusätzlich zur Minutenzahl kann jeder Schlüssel maximal 10 Abfragen pro Minute ausführen. Eine Abfrage dauert bis zu 60 Sekunden, es sei denn, Ihr KI-Client fordert mehr an, bis zu fünf Minuten. Ihr Plan legt außerdem fest, wie viele Zeilen eine Abfrage zurückgibt und, mit den Analysetools, wie lange und wie groß ein gespeichertes Ergebnis sein darf; der vollständige MCP-Leitfaden listet alle Pläne auf. Was Ihr KI-Client empfängt, wird auf Ihr Data-Realm-Kontingent angerechnet – denselben Pool, den auch Ihre Excel- und Sheets-Abfragen nutzen: Bei der Nutzung des KI-Agenten (MCP) zählt jedes Byte, das an Ihren KI-Client geliefert wird, also Ergebnisse, Schema-Lesevorgänge und Seiten mit zurückgehaltenen Ergebnissen, und zwar vor einer etwaigen Transportkomprimierung, die Ihr Client aushandelt. Bei Tabellenkalkulationsabfragen zählt hingegen das komprimierte Ergebnis, das Ihr Network Agent liefert. Semantic-Intelligence-Ausführungen, die von Ihrem KI-Client gestartet werden, verbrauchen Nova-AI-Credits – genau wie Ausführungen über das Portal. Siehe die Preisseite für die Zulagen.
Es sicher aufbewahren
Schreibgeschützt, vom Agenten geprüft
Es werden ausschließlich SELECT-Anweisungen ausgeführt. Die Prüfung erfolgt auf dem Computer, auf dem der Agent ausgeführt wird, bevor Ihre CSV-Datei mit mehreren Datensätzen die SQL-Anweisungen sieht. Dadurch kann nichts, was Ihr KI-Client schreibt, die Daten verändern.
Keine Anmeldeinformationen in der KI
Die Anmeldung für die CSV-Datei mit mehreren Datensätzen bleibt auf dem Agenten bestehen. Claude verfügt über einen Query-Streams-Schlüssel bzw. eine Verbindung, die Sie auf der MCP-Seite widerrufen können; die Änderung wird innerhalb von etwa fünf Minuten wirksam.
Alles wird protokolliert.
Jeder Werkzeugaufruf erscheint auf dem MCP. Aktivität Alle Abfragen im Abfrageverlauf werden als Clienttyp MCP angezeigt und dem Benutzer zugeordnet, dessen Schlüssel oder Verbindung die Abfrage durchgeführt hat. Der SQL-Text und der Schlüssel selbst werden niemals im Aktivitätsprotokoll gespeichert.
Was der KI-Anbieter erhält
Tabellen- und Spaltennamen, die Beschreibungen der semantischen Intelligenz inklusive Beispielwerten und die Zeilen Ihrer Abfragen werden erfasst. Mit dem Analysetoolset wird stattdessen häufig eine Größenschätzung, ein Profil oder ein vorläufiges Ergebnis abgerufen, während das vollständige Ergebnis beim Agenten verbleibt. Die abgerufenen Daten werden gemäß den Nutzungsbedingungen an den verbundenen KI-Anbieter übermittelt. Query Streams hat keinen Zugriff auf Ihren Chat.
Gute nächste Schritte
- Semantische Intelligenz ausführen Claude erfährt also, was
Feld_1zuFeld_NDer Mittelwert ist in jedem Datensatztyp enthalten. Die Dateitabellen enthalten bereits integrierte Beschreibungen. - Überprüfen Sie files_events nach der ersten Synchronisierung einer beliebigen Datei, die für ein unbekanntes Tag reserviert wurde.
- Lesen Sie den vollständigen Leitfaden für CSV-Dateien mit mehreren Datensätzen In Abfragen von CSV-Dateien mit mehreren Datensätzen mithilfe von SQL für jede Einstellung.
Wenn etwas nicht funktioniert
| Was Sie sehen | Was es bedeutet | Fix |
|---|---|---|
| Ihr KI-Client zeigt keine Query Streams-Tools an. | Der Stecker wurde zwar angebracht, aber nie angeschlossen, oder der Schlüssel wurde an der falschen Stelle eingeklebt. | In Claude: + → Abfrageströme → VerbindenIn einem Entwicklertool: Starten Sie es neu und verwenden Sie dann Überprüfen Sie die Verbindung. im Portal-Leitfaden. |
MCP_KEY_REQUIRED oder 401 | Es ist kein Schlüssel auf dem Server angekommen, üblicherweise aufgrund eines versehentlich eingefügten Zeilenumbruchs beim Kopieren oder Einfügen oder weil sich der Schlüssel im falschen Header befindet. | Kopieren Sie den Schlüssel erneut vom Tab „Verbindungen“ und senden Sie ihn an die X-MCP-Schlüssel Kopfzeile. |
MCP_USER_DISABLED | Ein Administrator hat MCP für Ihren Benutzer deaktiviert. | Bitten Sie sie, die MCP unter wieder einschalten Konto → Zugriffskontrolle. |
MCP_SCOPE_REQUIRED oder MCP_SCOPE_DENIED | Der Schlüssel oder die Verbindung verfügt nicht über die Berechtigung für diese Aktion, in der Regel für das Ausführen von Abfragen. | Bearbeiten Sie den Schlüssel auf der Registerkarte „Verbindungen“ und aktivieren Sie das Kontrollkästchen. Abfragen ausführenOder verbinden Sie die App erneut und genehmigen Sie sie. |
MCP_KEY_ORG_LIMIT_EXCEEDED | Das in Ihrem Tarif enthaltene Lizenzlimit ist aufgebraucht. Im kostenlosen Tarif entspricht dies einer Lizenz oder einer verbundenen App. | Kündigen Sie einen Tarif, den Sie nicht mehr nutzen, oder wechseln Sie zu einem höheren Tarif. |
MCP_AGENT_NOT_CONNECTED oder MCP_AGENT_NOT_REGISTERED | Der Agent, dem Ihre CSV-Datei mit mehreren Datensätzen gehört, ist momentan nicht verbunden. | Öffnen Daten → Datenagenten und starten Sie den Agenten auf seinem Computer. |
MCP_DATABASE_NOT_CAPTURED | Die Datenbank liegt außerhalb des Erfassungsbereichs des Konnektors, daher sind weder ein gespeichertes Schema noch semantische Informationen dafür vorhanden. Abfragen funktionieren weiterhin. | Fügen Sie es der Erfassungsauswahl des Konnektors hinzu und führen Sie anschließend die semantische Intelligenz aus, wenn Sie aussagekräftigere Ergebnisse wünschen. |
MCP_RATE_LIMITED | Zu viele Anrufe pro Minute für Ihren Tarif oder mehr als 10 Abfrageläufe pro Minute mit einer einzigen Taste. | Moment mal. Dank semantischer Intelligenz kann Claude Anrufe in weniger Fällen beantworten. |
MCP_QUERY_TIMEOUT oder MCP_OUTPUT_TOO_LARGE | Die Abfrage hat das Zeitlimit überschritten oder mehr Daten zurückgegeben, als Ihr KI-Client in einer Antwort verarbeiten kann. | Bitten Sie um weniger Zeilen oder Spalten oder um einen Datumsfilter. Bei Tarifen mit Kontextmanagement lassen Sie das Ergebnis zunächst anpassen. |
MCP_DATA_REALM_EXHAUSTED | Das Datenvolumen Ihrer Organisation für den Zeitraum ist aufgebraucht. | Warten Sie, bis sich Ihr Guthaben wieder aufgeladen hat, oder laden Sie es über das Portal wieder auf. |
MCP_FEATURE_NOT_INCLUDED | Ihr Plan beinhaltet kein Kontextmanagement, keine Ergebnisanalyse und keine tiefergehende Analyse, oder dieses Tool ist für diesen Schlüssel oder diese Organisation deaktiviert. | Bitten Sie Ihren KI-Client, ohne das Tool weiterzumachen, wechseln Sie zu einem höheren Tarif oder bitten Sie einen Administrator, das Tool zu aktivieren. |
MCP_RESULT_EXPIRED | Das gespeicherte Ergebnis ist nicht mehr gültig: Es ist abgelaufen, wurde freigegeben (manchmal vorzeitig, um Platz für ein neueres zu schaffen) oder der Agent wurde neu gestartet. | Bitten Sie Ihren KI-Client, die Abfrage mit der Option "hold" erneut auszuführen. |
MCP_WINDOW_BUDGET | Der Agent kann ein Ergebnis dieser Größe momentan nicht speichern, oder eine Folgeoperation benötigt mehr Speicherplatz, als zur Verfügung steht. | Ein gespeichertes Ergebnis freigeben oder die Abfrage mit einem Filter oder weniger Spalten einschränken. |
MCP_AGENT_ANALYSIS_DEAKTIVIERT | Die Speicherung von Ergebnissen und Analysen ist für diesen Agenten oder Konnektor deaktiviert. | Bitten Sie einen Administrator, die Option zu aktivieren. Lokale Analyse auf der Seite „Datenagenten“ oder erlauben Sie die Analyse des Konnektors. |
MCP_WINDOW_SQL_REJECTED | Eine Folgeabfrage war keine schreibgeschützte SELECT-Anweisung über das gespeicherte Ergebnis, und es wurde keine Spalte angegeben, die im Ergebnis nicht vorhanden ist. | Fordern Sie eine SELECT-Anweisung für dieses Ergebnis an, wobei die Spaltennamen verwendet werden. |
MCP_AGENT_VERSION_TOO_OLD | Der Agent benötigt ein Update, bevor er Ergebnisse formen, profilieren, speichern oder analysieren kann. | Aktualisieren Sie den Agenten von Daten → DatenagentenEinfache Abfragen funktionieren derweil weiterhin. |
| Verstoß gegen die Lesepflicht | Die SQL-Anweisung war keine SELECT-Anweisung. | Das ist so beabsichtigt. Über MCP werden keine Daten geschrieben. |
Fragen, die Menschen stellen
Wie verknüpfe ich eine Kopfzeile mit ihren Detailzeilen?
Verbinden Sie die beiden Tabellen auf _Quelldatei und _seq. _seq Zählt die Vorkommen jedes Tags innerhalb einer Datei, beginnend bei 0. Bitten Sie Claude, den Join durchzuführen, und er verwendet diese beiden Spalten.
Was passiert, wenn eine Datei ein Tag enthält, das der Connector noch nicht gesehen hat?
Die gesamte Datei wird beiseitegelegt, sodass keine ihrer Zeilen geladen wird. Dasselbe passiert, wenn eine Zeile die falsche Anzahl an Spalten hat. Dateien_Ereignisse Es wird protokolliert, welche Datei und warum. Die Datei wird repariert und gespeichert, und beim nächsten Scan wird sie erneut versucht.
Warum heißen die Spalten field_1, field_2 usw.?
Jeder Datensatztyp hat sein eigenes Layout, und die Dateien enthalten üblicherweise keine Kopfzeile zur Benennung der Spalten. Stattdessen werden die Spalten vom Konnektor positionsbezogen nummeriert. Führen Sie die semantische Intelligenz aus, damit Claude den Inhalt jedes nummerierten Feldes erkennt.
Liest Claude meine Dateien?
Nein. Der Agent liest die Daten auf seinem eigenen Computer und speichert die Zeilen dort in einem lokalen Cache. Claude sendet SQL-Anweisungen an Query Streams, der Agent führt sie gegen diesen Cache aus, und nur die für die Anfrage benötigten Zeilen werden zurückgesendet. Claude öffnet niemals eine Datei und kann sie weder ändern, verschieben noch löschen.
Muss ich einen Port öffnen oder ein VPN einrichten?
Nein. Der Agent stellt eine ausgehende Verbindung über Port 443 her, über die sowohl Anfragen als auch Datensätze übertragen werden. Wenn ausgehende HTTPS-Verbindungen funktionieren, funktioniert auch dies.
Kann sich der Ordner auf einer Netzwerkfreigabe, in OneDrive oder Dropbox befinden?
Eine Freigabe funktioniert, solange der Computer des Agenten sie öffnen kann; geben Sie sie wie folgt ein: \\server\share\folderDa der Agent als Dienst ausgeführt wird und die beim Anmelden verbundenen Laufwerke nicht sehen kann, fügen Sie unter Windows die Freigabeanmeldung aus dem Ordner hinzu. Berechtigung Spalte, wenn die Freigabe nur namentlich genannten Personen Zugriff gewährt; unter Linux oder Mac muss die Freigabe zuerst eingebunden werden (gespeicherte Anmeldedaten werden dort nicht verwendet). Bei einem synchronisierten Cloud-Ordner legen Sie fest, dass die Dateien auf diesem Gerät gespeichert werden; der Agent überspringt Cloud-Platzhalterdateien.
Ist das im kostenlosen Tarif wirklich enthalten?
Ja. „Free“ ist ein dauerhafter Tarif, keine befristete Testphase. MCP ist in jedem Tarif enthalten; „Free“ beinhaltet eine Taste oder eine verbundene App und 30 Anrufe pro Minute. Ordnerverbinder haben keine eigene Dateibeschränkung. Sehen Sie sich die genauen Leistungen von „Free“ an. Preisseite.
Welche KI-Tools funktionieren außer Claude?
Alles, was MCP über HTTP spricht: ChatGPT, Cursor, VS Code mit Copilot, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev und JetBrains AI – all das bietet eine fertige Anleitung im Leitfaden „KI-Client verbinden“ des Portals.
Verwandte Leitfäden
Jeder Leitfaden für Multi-record
Nicht ganz Ihre Konfiguration?
- Haben alle Zeilen Ihrer Dateien die gleichen Spalten und eine Kopfzeile? CSV Folder führt sie zu einer Tabelle zusammen → CSV Folder
- Sie benötigen lediglich eine Liste der Dateien mit Größen, Datumsangaben und Änderungsdetails? Das Dateisystem erledigt das, ohne die Dateien zu lesen. File System
- Möchten Sie die von den Maschinen selbst protokollierten Daten einsehen, z. B. Alarme und Zyklen? Machine Logs liest die Protokollordner der Controller → Machine Logs
Einrichtungsprobleme?
- Der Agent meldet, dass die Datei oder der Ordner nicht existiert oder der Zugriff verweigert wird? Für zugeordnete Laufwerke, Netzwerkfreigaben, OneDrive und Linux-Home-Verzeichnisse ist jeweils eine Lösung erforderlich. Wo der Agent Dateien lesen kann
- Der Agent wird als offline angezeigt, oder die Optionen „Verbindung testen“ und „Durchsuchen“ sind ausgegraut? Überprüfen Sie, ob der Agent online ist → Ist der Agent online?


