Connectez les journaux des conteneurs Docker à Claude avec MCP.

MCP · Journaux de conteneurs à Claude

Demander Claude à propos de votre fichier de journaux de conteneur, 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 de conteneur, écrit la requête SQL, l'exécute en lecture seule via l'agent déjà installé sur votre système et 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 Docker container logs 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

Quels conteneurs ont écrit des erreurs dans stderr au cours de la dernière heure ?

qs_get_table_schema qs_run_query intelligence de schéma

Claude lit les colonnes de ensembles de fichiers.événements tout d'abord, il exécute une requête qui conserve les lignes où flux est erreur standard et heure_événement chutes de la dernière heure, du plus récent au plus ancien. Trois conteneurs se distinguent :

application	flux	message
API de paiement	erreur standard	ERREUR de connexion TCP à 172.18.0.4:5432 : connexion refusée
travailleur	erreur standard	redis.exceptions.TimeoutError : Délai d'attente dépassé lors de la lecture depuis le socket
nginx-proxy	erreur standard	[erreur] 29#29 : *1184 Délai d'attente dépassé en amont (110 : Délai de connexion dépassé)

L'API de vérification a perdu sa base de données et le proxy a expiré en attente d'une réponse du serveur en amont. Demandez à Claude de compter les lignes d'erreur standard par conteneur et par minute pour identifier le conteneur défaillant en premier. La réponse correspond aux données lues par l'agent lors de sa dernière analyse.

Is the checkout-api connection error new, and what else was happening at the same time?

qs_run_query qs_run_query

I counted API de paiement stderr errors per hour in ensembles de fichiers.événements, and put the PostgreSQL et scheduler containers alongside for the same hours:

Hour	checkout-api errors	postgres restarts	scheduler warnings
12:00	0	0	0
13:00	412	1	9
14:00	1,880	2	31

New as of 13:07, and it is not checkout-api’s fault: every burst starts the minute PostgreSQL restarts, and postgres’s own last lines before each restart are out of memory. Fix the database container’s memory limit and the checkout errors go with it.

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.

Container Logs lit les fichiers journaux générés par Docker pour chaque conteneur et transforme chaque ligne en une entrée d'une table SQL que Claude peut interroger. Il ne s'agit pas du kit d'outils MCP de Docker. Il n'exécute ni ne gère les conteneurs ; il se contente de lire leurs journaux. L'agent suit l'évolution de chaque fichier, identifie les fichiers archivés pour éviter les doubles lectures et lit chaque entrée. .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 de conteneurs 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 votre conteneur sous Dossiers racine. Inclure des motifs commencer **/*-json.log, **/*.enregistrer et **/*.enregistrer.*.
   • Choisissez un Type de journalLa carte est livrée avec un fichier JSON Docker. docker logs --timestamps exportations et Portainer.
   • Nom de la table est facultatif et par défaut événements.
   • 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 lignes analysées 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 journalisation par défaut des fichiers JSON de Docker.

   Tableau	Ce qu'il contient
   événements	Une ligne par ligne de journalisation : heure_événement, application (le nom du conteneur), flux et message, plus image, composer_service et id_conteneur.
   lignes_brutes_événements	Lignes non analysées, conservées dans doubler avec un raison tel que aucune correspondance grammaticale ou indéchiffrableRien 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 vérifiable en ouvrant le dossier, par exemple en voyant Claude prendre la bonne table. Voici trois méthodes qui fonctionnent bien avec les journaux de votre conteneur Docker :

   « Quels fichiers journaux de conteneurs consultez-vous, et quand chacun a-t-il été modifié pour la dernière fois ? »

   Claude interroge ensemble de fichiers.fichiers pour chemin relatif, taille_octets et modifié_utc, les plus récents en premier.

   « Combien de lignes d'erreur standard chaque conteneur a-t-il écrites au cours de la dernière heure ? »

   Claude compte les rangées dans ensembles de fichiers.événements par application où flux est stderr, filtré sur heure_événement.

   « Des fichiers journaux de conteneurs ont-ils été pivotés ou mis de côté aujourd'hui ? »

   Claude lit fileset.files_events pour rotation et dérive lignes, triées par événement_àet nomme chaque fichier.

   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. Par défaut, les journaux de conteneur sont conservés pendant 30 jours.
• Ouvrir la boîte de dialogue Fichiers sur le connecteur pour voir chaque fichier journal que l'agent lit et pourquoi certains sont mis de côté.

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