Connectez les journaux d'application JSON à Claude avec MCP

MCP · Journaux d'application à Claude

Demander Claude à propos de votre fichier de journaux d'application, en anglais simple

Connectez Claude, Claude Code, Cursor ou tout autre client MCP à Query Streams une seule fois. Claude analyse la structure de votre fichier de journaux d'application, écrit la requête SQL, l'exécute en lecture seule via l'agent déjà installé sur votre base de données, puis renvoie les lignes. Aucun mot de passe de base de données n'est transmis à l'IA. L'opération prend environ dix minutes et est incluse dans le forfait gratuit.

Environ 10 minutes Claude, ChatGPT, Cursor + 11 autres clients Le fichier reste où il est. En lecture seule, toujours

Ce que vous obtiendrez

A Claude that can answer questions about your application log 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 · connecté aux flux de requêtes Lecture seule

Quelles ont été les erreurs les plus fréquentes au cours de la dernière heure, et quel enregistreur de données les a générées ?

qs_get_table_schema qs_run_query intelligence de schéma

Claude vérifie les colonnes de ensembles de fichiers.événementsEnsuite, il exécute une requête qui conserve les erreurs et les résultats fatals. niveau valeurs de la dernière heure de heure_événement et les regroupe par bûcheron et messageLes trois premiers :

niveau	bûcheron	message
erreur	Paiements.Client Stripe	Paiement refusé : carte refusée pour la commande 88213
erreur	Service de commande	Délai d'attente dépassé après 30 000 ms lors de l'appel au service d'inventaire
fatal	db.pool	Pool de connexions épuisé (max. 20 connexions)

L'épuisement du pool expliquerait les délais d'attente dans OrderService. Demandez à Claude le message complet et la trace de pile de l'événement fatal. Il affiche la même ligne, car la trace est restée associée à son événement. La réponse décrit ce que l'agent a lu lors de sa dernière analyse.

Break this week’s payment failures down by reason. Is it customers or us?

qs_run_query qs_run_query

I parsed the decline reason out of message pour Paiements.Client Stripe errors in ensembles de fichiers.événements and compared with last week:

Decline reason	Count	Partager	vs last week
card_declined	1,204	62%	+2%
insufficient_funds	402	21%	−1%
api_timeout	331	17%	+310%

The first two are customers and are flat. api_timeout is us: it did not exist a fortnight ago, every one comes from host = web-03, and web-03 shows 30-second gaps in its own logs at the same moments. One unhealthy host, not the payment provider.

Sélection uniquement, vérifiée par l'agent connecté à l'onglet Activité MCP 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.

Application Logs lit les fichiers journaux JSON et texte générés par vos applications, qu'il s'agisse de journaux ECS, Serilog, pino ou Bunyan (JSON) ou de texte brut. Chaque événement est transformé en une ligne SQL avec son niveau, son enregistreur et son message, et une trace de pile est associée à l'événement qui l'a produit. L'agent surveille chaque fichier à mesure qu'il s'agrandit, reconnaît les fichiers archivés pour éviter les doubles lectures, et lit chaque .gz L'archive est utilisée une seule fois, et les données des 30 derniers jours sont complétées lors de la première lecture.

Ce dont vous aurez besoin

Un compte Query Streams

MCP est inclus dans tous les forfaits, même le forfait gratuit. Le forfait gratuit permet une clé ou une application connectée, ce qui est suffisant pour ce guide. Inscrivez-vous sur mon.querystreams.com.

L'agent sur un ordinateur capable d'ouvrir le dossier

Version 2.6.0 ou ultérieure. Le dossier peut se trouver sur cet ordinateur ou sur un partage de fichiers accessible. L'agent s'exécute en tant que service ; saisissez donc les partages comme suit : \\serveur\partage\dossier, pas en tant que lettre de lecteur mappée. Vous découvrez Agent ? Installez-le sur Windows, macOS ou Linux.

MCP activé pour vous

Les créateurs, propriétaires et administrateurs y ont accès dès le départ. Tous les autres ont besoin d'un administrateur pour activer le contrôle parental. MCP interrupteur à côté de leur nom sous Compte → Contrôle d'accèsEn attendant, la page MCP indique « MCP est désactivé pour votre compte ».

Un client IA

Claude sur le web, Claude Desktop ou les applications mobiles Claude se connectent sans clé. Claude Code, Cursor, ChatGPT et une dizaine d'autres outils sont également compatibles ; le portail propose une configuration prédéfinie pour chacun d'eux.

Configurez-le en quatre étapes

1. Indiquez à l'agent le dossier

   Dans le portail ouvert Données → Agents de donnéesTrouvez l'agent qui peut ouvrir le dossier et cliquez dessus. Ajouter un connecteur bouton. Sous le Fichiers et dossiers pilule cliquez sur le Journaux d'application carte. Le magicien vous guide ensuite à travers Dossiers, Vérifier, Paramètres, Royaume et Revoir:

   Dossiers

   Tapez le Dossiers racine, un par ligne, comme chemins d'accès sur l'ordinateur de l'agent. Analyser les sous-dossiers est allumé, Profondeur maximale est 8. Inclure des motifs commence par le bon glob pour ce type de fichier ; ajouter Exclure les motifs si le dossier contient des fichiers indésirables. Une lettre de lecteur mappée affiche un avertissement orange : l’Agent ne peut pas la voir, utilisez donc le \\serveur\partage chemin à la place.

   Vérifier

   L'agent lit un échantillon de 64 fichiers maximum et affiche ce qu'il va créer. Rien n'est encore créé. Prêt à créer Cela signifie que chaque fichier échantillonné correspond. Une bannière orange, « {n} des {m} fichiers seront mis de côté », liste les fichiers qui ne correspondent pas. Afficher les fichiers concernés et pourquoiVous pouvez créer le connecteur et le corriger ultérieurement. Si le dossier contient plusieurs mises en page, un panneau bleu s'affiche. Passez à une table par mise en page.

   Paramètres

   Intervalle de balayage (toutes les heures par défaut, de toutes les 5 minutes à une fois par jour) correspond à la fréquence à laquelle l'agent recherche les fichiers nouveaux, modifiés et disparus. Surveillez le dossier pour les modifications Réagit en quelques secondes sur les disques locaux. Lorsqu'un fichier disparaît est Supprimez ses lignes par défaut.

   Royaume, Critique

   Sélectionnez le domaine de données auquel les lignes sont rattachées, vérifiez le récapitulatif et cliquez Créer un connecteurLe premier scan démarre immédiatement ; celui du connecteur Manifeste L'onglet affiche ce qu'il a construit et les fichiers qu'il a mis de côté.

   • Ajoutez le dossier contenant les journaux de vos applications sous Dossiers racine.
   • Choisissez un Type de journalLa carte transmet des lignes JSON (ECS, Serilog, pino et Bunyan), du texte brut avec le niveau, le logger et le message, ainsi que l'historique dpkg et apt, qui utilisent hôte comme colonne d'identité.
   • Nom de la table est facultatif et par défaut événements. Conserver les événements pendant N jours conserve tout sauf si vous le configurez.
   • Sur VérifierL'agent lit un échantillon et affiche le nombre de fichiers, leur taille, une estimation du nombre de lignes et les tables qu'il va créer. Rien n'est encore créé. Si les fichiers ne correspondent pas au type sélectionné, le message suivant s'affiche : Ces fichiers ne sont pas suivi de ce type, avec la raison.

2. Voyez quelles tables vous obtenez

   Les événements analysés atterrissent dans ensembles de fichiers.événements, ou dans le Nom de la table Vous avez fait votre choix. L'agent conserve les lignes dans un cache local sur son ordinateur et les sert au format SQL. Chaque ligne indique le fichier dont elle provient. _fichier_sourceLes colonnes ci-dessous proviennent du type de journal par défaut des lignes JSON.

   Tableau	Ce qu'il contient
   événements	Une ligne par événement : heure_événement, application, niveau, bûcheron et message, plus hôte, service, flux et donnéesUne trace de pile multiligne reste associée à son événement.
   lignes_brutes_événements	Lignes non analysées, conservées dans doubler avec un raisonUn bloc plus long que la limite atterrit ici comme lignes maximales d'enregistrementRien n'est laissé tomber.
   fichiers	Chaque fichier journal du dossier actuellement, avec chemin relatif, taille_octets et modifié_utc.
   fichiers_événements	Historique de chaque fichier : apparu, modifié, rotation, tronqué et dérive lignes, chronométrées par événement_à.
   curseurs de journalisation	Position et état de lecture de chaque fichier. Un fichier mis de côté affiche l'état stationné avec la raison dans dernière_erreur.

   Chaque connecteur de dossier fournit également à Claude les mêmes tables de comptabilité, le tout dans le ensemble de fichiers schéma:

   Tableau	Ce qu'il contient
   fichiers	Chaque fichier présent dans le dossier : chemin d’accès, nom, extension, taille, dates de création et de modification. Demandez « Que contient ce dossier ? » et Claude vous lira ces informations.
   fichiers_événements	Historique des modifications : une ligne par fichier apparu, modifié, disparu ou mis de côté (dérive), avec le temps en événement_à et la raison dans détail.
   annuaires, volumes	Taille et nombre des dossiers, et disques ou partages sur lesquels résident les fichiers racines.
   _fichier_source, _row_id	Deux colonnes par ligne de données : le fichier d’origine et un identifiant unique au sein de ce fichier. Grouper par _fichier_source comparer les fichiers.

3. Connectez-vous à Claude

   Ouvrir Flux → En direct → MCPIl y a deux entrées, et elles mènent au même endroit :

   Applications de messagerie instantanée · sans clé

   claude.ai, Claude Desktop, ChatGPT

   In Claude, Query Streams is in the Anthropic Connectors Directory: browse connectors, click Connecter. Elsewhere you paste one address into the app, https://mcp.querystreams.com/mcp, et connectez-vous depuis une conversation. Une page Query Streams s'ouvre, vous sélectionnez l'organisation et les autorisations, puis vous cliquez Approuver la connexionRien à copier, rien à garder secret. La connexion apparaît sous Applications connectées et peut y être révoquée.

   Outils de développement · une clé

   Claude Code, Curseur, VS Code et amis

   Sur Mes clés cliquez Générer une cléDonnez-lui un Nom de la clé comme « Claude Code sur mon ordinateur portable », conservez Lire et Exécuter coché, choisissez un Expiration (Jamais, 30 jours, 90 jours ou 1 an) et cliquez Générer une cléCopiez-le, puis Poursuivre l'installation: le Connecter L'onglet affiche l'extrait de code exact de votre outil, avec la clé déjà renseignée.

   Les deux méthodes utilisent les mêmes trois autorisations, que vous choisissez sur l'écran de consentement ou sur la clé :

   Lire

   Consultez les connecteurs, parcourez les tables et les colonnes, lisez vos requêtes enregistrées et vos règles d'alerte. Ne renvoie jamais les données des lignes.

   Exécuter

   Exécutez des requêtes SQL en lecture seule et des requêtes enregistrées via votre agent et récupérez les lignes. Sans cela, Claude peut décrire vos données, mais pas y répondre.

   Analyser

   Créez des profils de tables, découvrez les relations et lancez une analyse Schema Intelligence. Cette opération consomme des crédits Nova AI et du volume de données ; l’écran de consentement n’est donc jamais pré-coché.

   Vous avez perdu la clé ? Ouvrir Mes clés: l'icône en forme d'œil le montre à nouveau et Copier la clé complète Il est copié. Révoquez-le à cet endroit si un ordinateur portable est perdu ; chaque client l’utilisant échoue à son prochain appel, dans un délai d’environ cinq minutes.

   Choisissez ensuite la recette du Claude que vous utilisez. L'adresse du serveur est la même partout : https://mcp.querystreams.com/mcp.

   Claude sur le web, Claude Desktop et mobile pas de clé

   1. Ouvrir Paramètres → Connecteurs et cliquez Parcourir les connecteurs. Query Streams is listed in the Anthropic Connectors Directory: find Flux de requêtes et cliquez Connecter. (Or open the directory listing directly and click Connecter there.)
   2. If your organization hides directory connectors, click Ajouter un connecteur personnalisé instead. Name it Flux de requêtes, coller https://mcp.querystreams.com/mcp, leave the OAuth fields empty, click Ajouter, then in any chat click + → Parcourir les connecteurs → Flux de requêtes → Connecter.
   3. Un onglet Flux de requêtes s'ouvre. Connectez-vous si nécessaire, sélectionnez l'organisation et consultez. Lire et Exécuter, éventuellement Limiter à des connecteurs spécifiques, et cliquez Approuver la connexion.
   4. De retour dans Claude, vous voyez « Connecté aux flux de requêtes ». La première fois que Claude utilise un outil, il vous demande de choisir. Toujours permettre.

   If you do add it by hand in Claude Desktop, use Paramètres → Connecteurs → Ajouter, pas le chat intégré Ajouter une place de marché 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.

   Code Claude clé

   Une seule commande, avec votre clé depuis Mes clés :

   Terminal

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

   Cela décrit le projet actuel .mcp.json. Ajouter --scope utilisateur Pour avoir des flux de requêtes dans chaque projet. Exécuter /mcp À l'intérieur du code Claude, pour voir le lien.

   Curseur clé

   Ouvrir Paramètres du curseur → MCP → Ajouter un nouveau serveur MCP, ou modifier .cursor/mcp.json à la racine de votre espace de travail :

   .cursor/mcp.json

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

   Redémarrez le curseur ou exécutez MCP : Redémarrer les serveurs; un flux de requêtes Le badge apparaît dans la barre d'état du MCP.

   Vous utilisez autre chose ? Le Connecter onglet contient des recettes prêtes à l'emploi pour ChatGPT, VS Code, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev et JetBrains AI, ainsi qu'un Coller et fusionner l'outil qui laisse tomber le flux de requêtes Ajoutez cette entrée à un fichier de configuration existant. Tout client compatible MCP sur HTTP fonctionne : serveur https://mcp.querystreams.com/mcp, en-tête Clé X-MCP (un Autorisation : Porteur L'en-tête avec la même clé fonctionne également).

4. Posez votre première question

   Commencez par un élément que vous pouvez vérifier en ouvrant le dossier, afin de voir Claude prendre la bonne table. Trois exemples qui fonctionnent bien avec les fichiers journaux de votre application :

   « Quels fichiers journaux d'application consultez-vous, et quelle est leur taille ? »

   Claude interroge ensemble de fichiers.fichiers pour chemin relatif, taille_octets et modifié_utc.

   « Combien d’erreurs chaque application a-t-elle enregistrées au cours de la dernière heure, par niveau ? »

   Groupes Claude ensembles de fichiers.événements par application et niveau, filtré sur heure_événement.

   « Quelles lignes n’ont pas pu être analysées, et pourquoi ? »

   Claude lit fileset.events_raw_lines et regroupe les lignes par raison, avec quelques exemples pour chacun.

   Pour confirmer le câblage, demandez « De quels connecteurs Query Streams ai-je accès ? »Claude appelle qs_list_connectorset sur Mes clés la clé Dernière utilisation L'heure se met à jour en quelques secondes.

Affichage des fichiers nouveaux, modifiés et supprimés

Ce que Claude peut faire une fois connecté

Claude repère dix-neuf petits outils. Vous ne les nommez jamais vous-même ; Claude choisit celui qui convient à votre question. En clair :

Pourquoi l'intelligence schématique est importante ici

Chaque réponse que reçoit Claude est étiquetée avec l'origine de la structure, et Claude ajuste son degré de confiance envers ce qu'il voit.

Si une base de données est importante, exécutez Schema Intelligence dessus une seule fois. Nova → Intelligence. Le Mes clés L'onglet affiche un panneau de couverture par connecteur. Comment fonctionne l'intelligence schématique.

Ce que les plans permettent

MCP est inclus dans tous les forfaits, même le forfait gratuit, sans frais supplémentaires. Chaque forfait détermine le nombre de touches ou d'applications connectées que vous pouvez gérer et le nombre d'appels par minute que Claude peut passer.

Une application connectée compte comme une clé. En plus du tarif par minute, chaque clé peut exécuter jusqu'à 10 requêtes par minute. Une requête renvoie jusqu'à 1 000 lignes et s'exécute pendant 60 secondes maximum, sauf si Claude en demande davantage, dans la limite de 50 000 lignes et 5 minutes. Les lignes reçues par Claude sont décomptées de votre quota Data Realm, le même que celui utilisé par vos requêtes Excel et Sheets. Le MCP est mesuré avant compression ; un résultat volumineux coûte donc plus cher ici que les mêmes lignes dans une feuille de calcul. Les exécutions Schema Intelligence lancées depuis Claude consomment des crédits Nova AI, exactement comme celles lancées depuis le portail. Consultez la page des prix pour les indemnités.

Le garder en sécurité

Bonnes prochaines étapes

• Activez la surveillance du dossier pour les modifications (quasi en temps réel). Pour détecter les nouvelles lignes en quelques secondes sur un disque local, la garantie reste l'analyse planifiée.
• Définir les événements Keep pour N jours Pour contrôler la quantité d'historique conservée dans le cache. Les journaux d'application conservent tout, sauf indication contraire de votre part.
• Utiliser un dossier de journal personnalisé si votre format n'est pas dans le Type de journal Liste. Vous pouvez décrire vous-même le format ou ouvrir une demande d'assistance et nous l'ajouterons sous quelques jours.

Quand quelque chose ne fonctionne pas

Questions que se posent les gens

Guides associés

• Connectez un dossier de fichiers CSV à Claude avec MCP
• Connectez un dossier de fichiers Excel à Claude avec MCP
• Connectez un dossier de bases de données SQLite à Claude avec MCP.
• Connectez un dossier de fichiers Parquet à Claude avec MCP.
• Connexion des flux de requêtes à Claude via MCP : configuration, autorisations et dépannage
• Tous les guides MCP