MCPを使用してJSONアプリケーションログをClaudeに接続します

MCP · アプリケーションログをクロードへ

聞く クロード アプリケーションログファイルについて、 平易な英語で

Claude、Claude Code、Cursor、または任意のMCPクライアントをQuery Streamsに一度接続するだけで、Claudeがアプリケーションログファイルの構造を読み取り、SQLを生成し、データが格納されているエージェントを通して読み取り専用で実行し、結果の行を返します。データベースのパスワードがAIに渡ることは一切ありません。所要時間は約10分で、無料プランで利用可能です。

約10分 Claude、ChatGPT、Cursor、その他11社のクライアント ファイルは元の場所に残ります 読み取り専用、常に

最終的に手に入るもの

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:

クロード · クエリ ストリームに接続済み 読み取り専用

過去1時間で最も多く発生したエラーは何でしたか？また、それらのエラーはどのデータロガーによって発生したものですか？

qs_get_table_schema qs_run_query スキーマインテリジェンス

クロードは列をチェックします ファイルセット.イベント.次に、エラーと致命的なエラーを保持するクエリを1つ実行します。 レベル 過去1時間の値 イベント時間 そしてそれらをグループ化します ロガー そして メッセージ上位3位：

レベル	ロガー	メッセージ
エラー	Payments.StripeClient	決済失敗：注文番号88213のカードが拒否されました
エラー	注文サービス	inventory-svcの呼び出しが30000ミリ秒後にタイムアウトしました
致命的	db.pool	接続プールが枯渇しました（最大接続数20）。

プールが枯渇したことが、OrderService のタイムアウトの原因でしょう。致命的なイベントの完全なメッセージとスタックトレースを Claude に問い合わせてください。トレースはイベントに紐づいているため、同じ行が表示されます。回答には、エージェントが最後にスキャンした際に読み取った内容が記載されています。

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 メッセージ のために Payments.StripeClient errors in ファイルセット.イベント and compared with last week:

Decline reason	Count	シェア	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.

選択のみ、エージェントによる確認済み MCPアクティビティタブにログインしました 6 rows returned across 3 queries

Rather not wire up an AI client at all? On the Business plan, ノヴァ 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.

アプリケーションログは、ECS、Serilog、pino、BunyanのJSONログからプレーンテキストまで、アプリケーションが書き込むJSONおよびテキストログファイルを読み取ります。各イベントをレベル、ロガー、メッセージを含むSQL行に変換し、スタックトレースはイベントを生成したイベントに付随します。エージェントは、各ファイルが大きくなるにつれて監視し、ローテーションされたファイルを認識して重複読み込みを防ぎ、各ファイルを読み取ります。 .gz 一度アーカイブすると、初回閲覧時に過去30日間のデータが復元されます。

必要なもの

クエリストリームアカウント

MCPは無料プランを含むすべてのプランで利用可能です。無料プランではキー1つまたは接続アプリ1つが利用できますが、このガイドに必要なのはそれだけです。サインアップはこちらから my.querystreams.com.

フォルダを開くことができるコンピュータ上のエージェント

バージョン2.6.0以降。フォルダは、そのコンピュータ上またはアクセス可能なファイル共有上に配置できます。エージェントはサービスとして実行されるため、共有を次のように入力します。 \\server\share\folderマッピングされたドライブレターとしてではなく。エージェントを初めて使用しますか？ Windowsにインストールしてください, macOS または Linux.

MCPが起動しました

作成者、所有者、管理者は最初からそれを持っています。他のすべての人は、管理者に切り替えてもらう必要があります。 MCP 名前の横にあるスイッチ アカウント → アクセス制御それまでは、MCPページには「お客様のアカウントではMCPが無効になっています」と表示されます。

AIクライアント

ウェブ版Claude、デスクトップ版Claude、モバイルアプリ版Claudeは、いずれもキー不要で接続できます。Claude Code、Cursor、ChatGPTなど、その他約10種類のツールも利用可能です。ポータルには、それぞれのツールに対応した設定が用意されています。

4つのステップで設定できます

1. エージェントをフォルダーに指定してください

   ポータルを開く データ → データエージェントフォルダーを開くことができるエージェントを見つけてクリックします コネクタを追加する ボタン。 ファイルとフォルダ ピルクリック アプリケーションログ カード。その後、魔法使いがあなたを案内します。 フォルダー, チェック, 設定, レルム そして レビュー:

   フォルダー

   入力 ルートフォルダエージェントのコンピュータ上のパスとして、1行に1つずつ記述します。 サブフォルダーをスキャンする オンになっています、 最大深度 8です。 パターンを含める このファイルタイプに適したグロブから開始します。 パターンを除外する フォルダに不要なファイルが含まれている場合。マッピングされたドライブ文字にはオレンジ色の警告が表示されます。エージェントはそれを認識できないため、 \\server\share 代わりにパスを使用してください。

   チェック

   エージェントは最大64個のサンプルファイルを読み込み、構築予定の内容を表示します。現時点では何も作成されていません。 作成準備完了 これは、サンプリングされたすべてのファイルが適合することを意味します。「{m} 個のファイルのうち {n} 個が除外されます」という黄色のバナーは、適合しないファイルを一覧表示します。 どのファイルとその理由を表示するコネクタは作成して後で修正することもできます。フォルダにレイアウトが混在している場合は、青いパネルが表示されます。 レイアウトごとにテーブルを1つに切り替えます.

   設定

   スキャン間隔 （デフォルトでは1時間ごと、5分ごとから毎日まで）は、エージェントが新規ファイル、変更されたファイル、および消失したファイルを検索する頻度です。 変更を監視するフォルダ ローカルディスク上で数秒以内に反応します。 ファイルが消えたとき は 行を削除する デフォルトでは。

   レルム、レビュー

   行数がカウントされるデータレルムを選択し、概要を確認してクリックします。 コネクタを作成する最初のスキャンはすぐに開始されます。コネクタの マニフェスト タブには、作成されたものや保存されたファイルが表示されます。

   • アプリのログを保存するフォルダを以下に追加します。 ルートフォルダ.
   • 選ぶ ログタイプカードには JSON 行 (ECS、Serilog、pino、Bunyan)、レベル、ロガー、メッセージを含むプレーンテキスト、dpkg および apt 履歴が出荷されます。 ホスト ID列として。
   • テーブル名 オプションであり、デフォルトは イベント. イベントをN日間保持する 設定しない限り、すべてを保持します。
   • の上 チェックエージェントはサンプルを読み込み、ファイル数、サイズ、行数の見積もり、および構築するテーブルを表示します。まだ何も作成されていません。ファイルが選択したタイプと異なる場合は、見出しに次のように表示されます。 これらのファイルは 続いて、その理由とともにその種類が続きます。

2. どんなテーブルが手に入るか見てみましょう

   解析されたイベントは ファイルセット.イベントまたは テーブル名 あなたが選択した。エージェントは行をエージェントコンピュータのローカルキャッシュに保持し、SQLとして提供します。各行は、それがどのファイルから来たかを示します。 _ソースファイル以下の列は、デフォルトのJSON行ログタイプから取得されます。

   テーブル	中身
   イベント	イベントごとに1行： イベント時間, アプリ, レベル, ロガー そして メッセージプラス ホスト, サービス, ストリーム そして データ複数行のスタックトレースは、そのイベント内に残ります。
   イベント_生の行	解析されなかった行は、 ライン と共に 理由制限を超えるブロックはここに着地します レコード最大行数何も落とされない。
   ファイル	現時点でフォルダ内のすべてのログファイルには、 相対パス, サイズ（バイト） そして 修正済みUTC.
   ファイルイベント	各ファイルの履歴： 現れた, 修正済み, 回転, 切り捨てられた そして ドリフト 行、時間 イベント_at.
   ログカーソル	各ファイルの読み取り位置と状態。セットアサイドファイルの場合は状態が表示されます。 駐車 理由は 最後のエラー.

   すべてのフォルダー コネクタは、クロードに同じ簿記テーブルも提供します。 ファイルセット スキーマ:

   テーブル	中身
   ファイル	フォルダ内のすべてのファイル：パス、ファイル名、拡張子、サイズ、作成日時、更新日時。「このフォルダには何が入っているの？」と尋ねると、クロードがこれを読み上げます。
   ファイルイベント	変更履歴: 出現、変更、消失、または保留されたファイルごとに 1 行 (ドリフト）時間とともに イベント_at そしてその理由は 詳細.
   ディレクトリ, ボリューム	フォルダのサイズと数、およびルートが存在するディスクまたは共有フォルダ。
   _ソースファイル, _row_id	各データ行には2つの列があります。1つは行の由来となるファイル、もう1つはそのファイル内の安定した行IDです。グループ化基準 _ソースファイル ファイルを比較する。

3. クロードとつながる

   開く ストリーム → ライブ → MCP入り口は2つあり、どちらも同じ場所にたどり着きます。

   チャットアプリ · キー不要

   claude.ai、Claude Desktop、ChatGPT

   In Claude, Query Streams is in the Anthropic Connectors Directory: browse connectors, click 接続する. Elsewhere you paste one address into the app, https://mcp.querystreams.com/mcpチャットから接続します。クエリ ストリーム ページが開くので、組織と権限を選択し、クリックします。 接続を承認するコピーするものも、秘密にしておくものもありません。接続は以下に表示されます。 接続されたアプリ そして、そこで取り消される可能性がある。

   開発者ツール・鍵

   クロード・コード、カーソル、VSコードとその仲間たち

   の上 私の鍵 クリック キーを生成する. 与えて キー名 「私のラップトップ上のクロード・コード」など、 読む そして 実行する チェックを入れ、 有効期限 （なし、30日間、90日間、または1年間）をクリックして キーを生成するコピーしてから インストールを続行します: その 接続する タブには、キーが既に入力された状態で、お使いのツールに対応する正確なコードスニペットが表示されます。

   どちらの方法も同じ3つの権限を使用します。これらの権限は、同意画面またはキー上で選択します。

   読む

   コネクタの一覧表示、テーブルと列の参照、保存済みクエリとアラートルールの読み取りを行います。行データは返しません。

   実行する

   エージェントを通して読み取り専用のSQLクエリと保存済みクエリを実行し、結果の行を返してください。そうしないと、Claudeはデータの説明はできますが、データに基づいて回答することはできません。

   分析

   プロファイルテーブルを作成し、関係性を検出して、スキーマインテリジェンスの実行をキューに追加します。Nova AIのクレジットとデータ使用量を消費するため、同意画面で事前にチェックされることはありません。

   鍵をなくした？ 開く 私の鍵目のアイコンがそれを再び表示し、 完全なキーをコピー それをコピーします。ノートパソコンが紛失した場合は、そこで取り消してください。そうすれば、それを使用しているすべてのクライアントは、約5分以内に次の呼び出しで失敗します。

   次に、使用するクロードのレシピを選択してください。サーバーアドレスはどこでも同じです。 https://mcp.querystreams.com/mcp.

   ウェブ版クロード、デスクトップ版クロード、モバイル版クロード キーなし

   1. 開く 設定 → コネクタ そしてクリック コネクタを参照する. Query Streams is listed in the Anthropic Connectors Directory: find クエリストリーム そしてクリック 接続する. (Or open the directory listing directly and click 接続する there.)
   2. If your organization hides directory connectors, click カスタムコネクタを追加する instead. Name it クエリストリームペースト https://mcp.querystreams.com/mcp, leave the OAuth fields empty, click 追加, then in any chat click + → コネクタを参照する → クエリストリーム → 接続する.
   3. クエリ ストリーム タブが開きます。求められたらサインインし、組織を選択して確認します。 読む そして 実行する任意 特定のコネクタに限定する、そしてクリック 接続を承認する.
   4. Claudeに戻ると、「クエリ ストリームに接続済み」と表示されます。Claudeがツールを初めて使用すると、次の質問が表示されます。 常に許可する.

   If you do add it by hand in Claude Desktop, use 設定 → コネクタ → 追加チャット内ではなく マーケットプレイスを追加 option, which expects a git repository. Connectors sync to your Claude account, so the mobile apps and Desktop pick it up automatically. Menu names are Anthropic’s and can move.

   クロード・コード 鍵

   「マイキー」にあるキーを使って、以下のコマンドを実行してください。

   ターミナル

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

   これは現在のプロジェクトの .mcp.json。 追加 --スコープ ユーザー すべてのプロジェクトにクエリ ストリームを持たせる。 /mcp Claude Codeの内部で接続を確認する。

   カーソル 鍵

   開く カーソル設定 → MCP → 新しい MCP サーバーを追加または編集 .cursor/mcp.json ワークスペースのルートに:

   .cursor/mcp.json

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

   カーソルを再起動するか、実行してください MCP: サーバーの再起動; a クエリストリーム バッジはMCPステータスバーに表示されます。

   他のものを使っていますか？ の 接続する タブ ChatGPT、VS Code、Visual Studio、OpenAI Codex CLI、Gemini CLI、Windsurf、Zed、Cline、Continue.dev、JetBrains AI 用のすぐに貼り付けられるレシピに加え、 貼り付けて結合する ドロップするツール クエリストリーム 既にお持ちの設定ファイルへのエントリ。HTTP 上で MCP と通信するクライアントであればどれでも動作します: サーバー https://mcp.querystreams.com/mcpヘッダー X-MCPキー （アン） 認証：所持者 同じキーを持つヘッダーでも機能します。

4. 最初の質問をしてください

   まずはフォルダを開いて確認できるものから始めましょう。そうすれば、クロードが正しいテーブルに手を伸ばしているのがわかります。アプリケーションのログファイルとうまく連携する3つの例を以下に示します。

   「どのアプリケーションログファイルを読み込んでいますか？また、それぞれのファイルサイズはどれくらいですか？」

   クロードの質問 ファイルセット.ファイル のために 相対パス, サイズ（バイト） そして 修正済みUTC.

   「各アプリは過去1時間に、レベル別にいくつのエラーを記録しましたか？」

   クロードグループ ファイルセット.イベント による アプリ そして レベルフィルター条件 イベント時間.

   「どの行が解析できなかったのか、そしてその理由は？」

   クロードは読書をする fileset.events_raw_lines そして行をグループ化します 理由それぞれについて、いくつか例を挙げて説明します。

   配線を確認するには、 「どのようなクエリ ストリーム コネクタが利用できますか？」クロードが電話をかけてくる qs_list_connectors、そして 私の鍵 鍵は 最終使用日時 時刻は数秒以内に更新されます。

新規ファイル、変更ファイル、削除ファイルがどのように表示されるか

接続されたクロードができること

クロードは19個の小さな道具を見分けます。あなたはそれらを自分で呼ぶ必要はありません。クロードがあなたの質問に最適な道具を選んでくれます。簡単に言うと、次のようになります。

ここでスキーマインテリジェンスが重要な理由

クロードが受け取るすべての回答には、その構造がどこから来たのかという情報がタグ付けされており、クロードはそれに基づいて、目にしたものに対する信頼度を調整する。

データベースが重要な場合は、スキーマ インテリジェンスを一度実行してください。 ノヴァ → インテリジェンス. 私の鍵 タブには、コネクタごとのカバレッジパネルが表示されます。 スキーマインテリジェンスの仕組み.

計画で許可されている内容

MCPは無料プランを含むすべてのプランに含まれており、追加料金はかかりません。各プランで設定できるのは、保持できるキーまたは接続アプリの数と、Claudeが1分間に発信できる通話回数です。

接続されたアプリはキーとしてカウントされます。1 分あたりの数値に加えて、1 つのキーは 1 分間に最大 10 回のクエリを実行できます。クエリは最大 1,000 行を返し、Claude が追加を要求しない限り最大 60 秒実行され、最大 50,000 行、5 分までが上限です。Claude が受け取る行は、Excel および Sheets クエリが使用するのと同じプールである Data Realm の許容量にカウントされ、MCP は圧縮前に測定されるため、幅の広い結果はスプレッドシートの同じ行よりもコストが高くなります。Claude から開始された Schema Intelligence の実行は、ポータルから開始する場合とまったく同じように、Nova AI クレジットを消費します。 価格ページをご覧ください 手当のために。

安全に保つ

良い次の動き

• 変更を監視するフォルダーを有効にする（ほぼリアルタイム） ローカルディスク上の新しい行を数秒以内に検出します。スケジュールされたスキャンは、その保証を継続します。
• N日間イベントを保持する設定 キャッシュに保持される履歴の量を制御する。アプリケーションログは、設定しない限りすべての履歴を保持します。
• カスタムログフォルダを使用する フォーマットが ログタイプ リスト形式については、お客様ご自身でご指定いただくか、サポートリクエストを送信いただければ、数日以内に弊社で追加いたします。

何かがうまくいかないとき

人々が尋ねる質問

関連ガイド

• CSVファイルのフォルダをMCPを使ってClaudeに接続する
• ExcelファイルのフォルダーをMCPを使ってClaudeに接続します。
• SQLiteデータベースのフォルダをMCPを使用してClaudeに接続する
• ParquetファイルのフォルダをMCPを使ってClaudeに接続する
• MCP を介してクエリ ストリームを Claude に接続する: セットアップ、権限、およびトラブルシューティング
• すべてのMCPガイド