Verbinden Sie JSON-Anwendungsprotokolle mit Claude mithilfe von MCP

MCP · Anwendungsprotokolle an Claude

Fragen Claude über Ihre Anwendungsprotokolldatei, in einfachem Englisch

Verbinden Sie Claude, Claude Code, Cursor oder einen beliebigen MCP-Client einmalig mit Query Streams. Claude liest die Struktur Ihrer Anwendungsprotokolldatei, schreibt die SQL-Anweisung, 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

Ein Claude, der Fragen zu Ihren Anwendungsprotokolldateien mit Live-Abfragen (schreibgeschützt) über die vom Agenten aus Ihren Dateien erstellten Tabellen beantworten und Ihnen die jeweilige Datei zuordnen kann – 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, sofern Sie mit der Konfigurationsoberfläche vertraut sind. So geht's:

Claude · verbunden mit Abfrageströmen Schreibgeschützt

Was waren die häufigsten Fehler in der letzten Stunde und welcher Logger hat sie verursacht?

qs_get_table_schema qs_run_query Schema-Intelligenz

Claude überprüft die Spalten von fileset.eventsAnschließend wird eine Abfrage ausgeführt, die Fehler und schwerwiegende Fehler speichert. Ebene Werte aus der letzten Stunde Ereigniszeit und gruppiert sie nach Protokollierer und NachrichtDie Top drei:

Ebene	Protokollierer	Nachricht
Fehler	Payments.StripeClient	Zahlung fehlgeschlagen: Karte für Bestellung 88213 abgelehnt
Fehler	Bestellservice	Zeitüberschreitung nach 30000 ms beim Aufruf von inventory-svc
tödlich	db.pool	Verbindungspool erschöpft (max. 20 Verbindungen)

Der erschöpfte Pool erklärt die Timeouts im OrderService. Bitten Sie Claude um die vollständige Meldung und den Stacktrace des schwerwiegenden Ereignisses. Es wird immer dieselbe Zeile angezeigt, da der Trace dem Ereignis zugeordnet blieb. Die Antwort enthält die Informationen, die der Agent bei seinem letzten Scan erfasst hat.

Analysieren Sie die Zahlungsausfälle dieser Woche nach ihren Ursachen. Liegt es an den Kunden oder an uns?

qs_run_query qs_run_query

Ich habe den Ablehnungsgrund herausgearbeitet Nachricht für Payments.StripeClient Fehler in fileset.events und im Vergleich zur letzten Woche:

Ablehnungsgrund	Zählen	Teilen	im Vergleich zur letzten Woche
Karte abgelehnt	1,204	62%	+2%
unzureichende Mittel	402	21%	-1%
api_timeout	331	17%	+310%

Die ersten beiden sind Kunden und haben eine flache Struktur. api_timeout Das sind wir: Vor zwei Wochen gab es das noch nicht, jeder kommt von dort Host = web-03Auch web-03 weist in seinen eigenen Protokollen zu denselben Zeitpunkten 30-sekündige Lücken auf. Es liegt also ein Fehler auf einem Host vor, nicht beim Zahlungsanbieter.

Nur SELECT, geprüft vom Agenten Im MCP-Aktivitäts-Tab angemeldet 3 Abfragen lieferten 6 Zeilen zurück.

Lieber gar keinen KI-Client einrichten? Zum Geschäftsplan Nova Der in Query Streams integrierte Assistent bietet alle Funktionen von Claude sowie zusätzliche Features: Er erstellt und validiert SQL-Abfragen anhand Ihres Semantic-Intelligence-Modells, wandelt die Ergebnisse in Diagramme um und speichert sie als Abfrage, die Ihr Team in Excel, Google Sheets oder über die 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.

Application Logs liest die von Ihren Anwendungen erstellten JSON- und Textprotokolldateien, von ECS-, Serilog-, Pino- oder Bunyan-JSON-Protokollen bis hin zu Klartext. Jedes Ereignis wird in eine SQL-Zeile mit Ebene, Logger und Meldung umgewandelt, und ein Stacktrace wird dem auslösenden Ereignis zugeordnet. Der Agent überwacht jede Datei während ihres Wachstums, erkennt rotierte Dateien, um doppelte Lesevorgänge zu vermeiden, und liest jede .gz Die Daten werden einmal archiviert und beim ersten Lesen die letzten 30 Tage nachgeladen.

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

   • Fügen Sie den Ordner hinzu, in dem Ihre App-Protokolle abgelegt werden, unter Stammverzeichnisse.
   • Wähle ein ProtokolltypDie Karte liefert JSON-Zeilen (ECS, Serilog, Pino und Bunyan), Klartext mit Level, Logger und Nachricht sowie dpkg- und apt-Verlauf, die verwendet werden Gastgeber als Identitätsspalte.
   • Tabellenname ist optional und hat den Standardwert Veranstaltungen. Ereignisse für N Tage speichern Es behält alles bei, solange Sie es nicht ändern.
   • An ÜberprüfenDer Agent liest eine Beispieldatei und zeigt die Anzahl der Dateien, die Größe, die geschätzte Zeilenanzahl und die zu erstellenden Tabellen an. Es werden noch keine Tabellen erstellt. Falls die Dateien nicht dem ausgewählten Typ entsprechen, wird folgende Meldung angezeigt: Diese Dateien sind nicht gefolgt von dieser Art, mit der Begründung.

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

   Geparste Ereignisse landen in fileset.eventsoder in der Tabellenname Sie haben die Wahl. Der Agent speichert die Zeilen in einem lokalen Cache auf dem Agentenrechner und stellt sie als SQL bereit. Jede Zeile gibt an, aus welcher Datei sie stammt. _QuelldateiDie folgenden Spalten stammen aus dem Standard-JSON-Zeilenprotokolltyp.

   Tisch	Was es enthält
   Veranstaltungen	Eine Zeile pro Ereignis: Ereigniszeit, App, Ebene, Protokollierer und Nachricht, plus Gastgeber, Service, Strom und DatenEin mehrzeiliger Stacktrace bleibt in seinem Ereignis erhalten.
   Ereignisse_Rohlinien	Zeilen, die nicht analysiert wurden, wurden beibehalten Linie mit einem GrundEin Block, der länger als die Grenze ist, landet hier als maximale ZeilenNichts wird fallen gelassen.
   Dateien	Alle Logdateien im Ordner, die sich aktuell befinden, relativer Pfad, Größe_Bytes und modifiziert_utc.
   Dateien_Ereignisse	Die Historie jeder Datei: erschien, modifiziert, gedreht, gekürzt und Drift Zeilen, gemessen von event_at.
   log_cursors	Die Leseposition und der Status jeder Datei. Eine reservierte Datei zeigt den Status an. geparkt mit dem Grund in letzter Fehler.

   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 befindet sich Query Streams im Verzeichnis anthropischer Konnektoren: Konnektoren durchsuchen, klicken VerbindenAn anderer Stelle fügt man eine Adresse in die App ein. 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

   Profiltabellen werden erstellt, Beziehungen erkannt und ein Lauf der semantischen Intelligenz in die Warteschlange gestellt. Dies verbraucht Nova-KI-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 durchsuchenQuery Streams ist aufgeführt in der Verzeichnis anthropischer Konnektoren: finden Abfrageströme und klicken Sie Verbinden(Oder öffnen Sie die Verzeichnisliste direkt und klicken Sie auf Verbinden Dort.)
   2. Wenn Ihre Organisation Verzeichnisverbindungen ausblendet, klicken Sie hier. Benutzerdefinierten Konnektor hinzufügen Benenne es stattdessen. Abfrageströme, Paste https://mcp.querystreams.com/mcpLassen Sie die OAuth-Felder leer und klicken Sie auf HinzufügenKlicken Sie dann in einem beliebigen Chat + → 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.

   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 „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 davon eignen sich gut für Ihre Anwendungsprotokolldateien:

   „Welche Anwendungsprotokolldateien lesen Sie, und wie groß ist jede einzelne?“

   Claude fragt nach fileset.files für relativer Pfad, Größe_Bytes und modifiziert_utc.

   „Wie viele Fehler wurden von jeder App in der letzten Stunde nach Schwierigkeitsgrad protokolliert?“

   Claude-Gruppen fileset.events von App und Ebenegefiltert nach Ereigniszeit.

   „Welche Zeilen konnten nicht analysiert werden und warum?“

   Claude liest fileset.events_raw_lines und gruppiert die Zeilen nach Grund, mit einigen Beispielen für jeden Punkt.

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

Wenn eine Datenbank wichtig ist, führen Sie Semantic Intelligence einmalig darauf aus. Nova → Intelligenz. Der Meine Schlüssel Die Registerkarte zeigt ein Abdeckungsfeld pro Anschluss an. Wie semantische Intelligenz 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 ein 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 auch für Ihre Excel- und Tabellenkalkulationsabfragen verwendet wird. 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. Semantic-Intelligence-Abfragen, die von Claude gestartet werden, verbrauchen Nova-AI-Credits, genau wie Abfragen vom Portal. Siehe die Preisseite für die Zulagen.

Es sicher aufbewahren

Gute nächste Schritte

• Ordnerüberwachung aktivieren (nahezu in Echtzeit) Neue Zeilen werden innerhalb von Sekunden auf der lokalen Festplatte erkannt. Der geplante Scan bleibt die Garantie.
• Ereignisse für N Tage festlegen Sie können steuern, wie viele Verlaufsdaten im Cache gespeichert werden. Anwendungsprotokolle speichern standardmäßig alles, sofern Sie dies nicht anders festlegen.
• Benutzerdefinierten Protokollordner verwenden Wenn Ihr Format nicht im Protokolltyp Liste. Sie können das Format selbst beschreiben oder eine Supportanfrage stellen, und wir fügen es innerhalb weniger Tage hinzu.

Wenn etwas nicht funktioniert

Fragen, die Menschen stellen

Verwandte Leitfäden

• Verbinden Sie einen Ordner mit CSV-Dateien mit Claude mithilfe von MCP.
• 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
• Query Streams über MCP mit Claude verbinden: Einrichtung, Berechtigungen und Fehlerbehebung
• Alle MCP-Leitfäden