MCPを使用して任意のログファイルをClaudeに接続します

MCP · クロードへのカスタムログ

聞く クロード カスタムログファイルについて、 平易な英語で

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

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

最終的に手に入るもの

Claudeは、ユーザーが記述したテキストログに関する質問に、エージェントがファイルから構築するテーブルに対するリアルタイムの読み取り専用クエリで回答し、各回答がどのファイルから得られたかを通知します。ログイン情報やファイルパスを見る必要はなく、ファイアウォールを変更する必要もありません。ネットワーク内に既に存在するエージェントがフォルダを読み取り、行のみを返します。エージェントが配置されたら、設定画面の操作に慣れていれば、Claudeへの接続は約90秒で完了します。例：

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

バックアップジョブは昨夜、どのようなエラーをログに記録しましたか？

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

このコネクタは、 タイムスタンプ 定義されています。クロードは、 ファイルセット.イベント、次に、午前0時から午前6時までのERRORおよびWARNメッセージに対して1つのクエリを実行し、 イベント時間:

イベント時間	ファイル名	メッセージ
2026-09-26 02:14:07	バックアップログ	エラー：コピーに失敗しました：/mnt/nas01/archiveへのアクセスが拒否されました
2026-09-26 02:15:09	バックアップログ	警告：60秒後に再試行します（3回中2回目の試行）
2026-09-26 02:17:11	バックアップログ	エラー 3回試行後、諦めます

ジョブは午前2時14分にアーカイブ共有へのアクセスを失い、3分後に処理を中止しました。クロードに、今月同じ結果で終わった夜が何晩あったか尋ねてください。答えは、エージェントが前回のスキャンで読み取った内容を網羅しています。

バックアップジョブはどのくらいの頻度で失敗しますか？また、毎回同じ問題が発生しますか？

qs_run_query qs_run_query

私は毎晩ランニングを ファイルセット.イベント開始行と終了行を照合し、エラー行から失敗したパスを抽出しました。

夜	結果	失敗したパス	間隔
9月25日	わかりました	-	1時間42分
9月26日	失敗した	/mnt/nas01/archive	0時間09分
9月27日	失敗した	/mnt/nas01/archive	0時間08分

2晩連続で同じルートを辿り、9分後に中止。 アクセスが拒否されました 容量不足になるのではなく、26日にNASアーカイブ共有のアクセス権限が変更されました。修正されるまで、25日以降のバックアップは存在しません。

選択のみ、エージェントによる確認済み MCPアクティビティタブにログインしました 3つのクエリで合計6行が返されました

AIクライアントを一切接続したくないですか？ 事業計画書では、 ノヴァ MCPはQuery Streams自体に組み込まれたアシスタントです。Claudeが利用できるすべてのツールに加え、Claudeにはない機能も備えています。セマンティックインテリジェンスモデルに対してSQLを生成および検証し、結果をグラフに変換し、結果をExcel、Google Sheets、またはREST APIから実行できるクエリとして保存します。キーもコネクタもインストールも不要です。Claude、Cursor、またはChatGPTを既に利用している場合はMCPを、ポータル内で回答を取得したい場合はNovaを使用してください。

カスタムログフォルダは、内蔵カードが認識しないテキストログ用です。フォーマットを一度指定するか、Novaに提案させれば、すべての行がClaudeがクエリできるSQL行になります。つまり、アップロード不要で、独自のファイルに対してAIログ分析が行われます。エージェントは各ファイルの増大を監視し、ローテーションされたファイルを認識して重複読み込みを防ぎ、各行を読み取ります。 .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分ごとから毎日まで）は、エージェントが新規ファイル、変更されたファイル、および消失したファイルを検索する頻度です。 変更を監視するフォルダ ローカルディスク上で数秒以内に反応します。 ファイルが消えたとき は 行を削除する デフォルトでは。

   レルム、レビュー

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

   • ログフォルダを以下に追加してください ルートフォルダ そして設定する パターンを含める お客様のファイルと照合します。
   • 選択してください エンコーディング必須項目であり、デフォルト値はありません。
   • フォーマットについて説明してください。 レコード境界, 文法 （区切り文字、キー=値、grok、JSON行、#Fieldsヘッダーまたは固定幅） タイムスタンプ, 型付き列 そして 識別列またはクリック Novaにフォーマットを提案させましょう1日あたりの上限が設けられています。
   • の上 チェックエージェントはサンプルを読み込み、ファイル数、サイズ、行数の見積もり、および作成されるテーブルを表示します。この時点では何も作成されていません。 接続テスト また、適合する場合は、最も近い内蔵ログタイプも提供します。

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

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

   テーブル	中身
   イベント	レコードごとに1行： イベント時間フォーマットで定義される列、 メッセージフォーマットはまだありませんが、 イベント時間 これはファイルの最終更新日時です。
   イベント_生の行	フォーマットが一致しなかった行は、 ライン と共に 理由 のような 文法に一致しない何も落とされない。
   ファイル	現時点でフォルダ内のすべてのログファイルには、 相対パス, サイズ（バイト） そして 修正済みUTC.
   ファイルイベント	各ファイルの履歴： 現れた, 修正済み, 回転, 切り捨てられた そして ドリフト 行、時間 イベント_at.
   ログカーソル	各ファイルの読み取り位置と状態。セットアサイドファイルの場合は状態が表示されます。 駐車 理由は 最後のエラー.

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

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

3. クロードとつながる

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

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

   claude.ai、Claude Desktop、ChatGPT

   Claudeでは、クエリ ストリームは 人間活動関連コネクタディレクトリコネクタを参照するには、クリックしてください。 接続する他の場所では、アプリにアドレスを1つ貼り付けます。 https://mcp.querystreams.com/mcpチャットから接続します。クエリ ストリーム ページが開くので、組織と権限を選択し、クリックします。 接続を承認するコピーするものも、秘密にしておくものもありません。接続は以下に表示されます。 接続されたアプリ そして、そこで取り消される可能性がある。

   開発者ツール・鍵

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

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

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

   読む

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

   実行する

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

   分析

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

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

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

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

   1. 開く 設定 → コネクタ そしてクリック コネクタを参照するクエリ ストリームは、 人間活動関連コネクタディレクトリ： 探す クエリストリーム そしてクリック 接続する（またはディレクトリ一覧を直接開いてクリック） 接続する そこには。）
   2. 組織がディレクトリコネクタを非表示にしている場合は、クリックしてください。 カスタムコネクタを追加する 代わりに名前を付けてください。 クエリストリームペースト https://mcp.querystreams.com/mcpOAuth フィールドを空のままにしてクリックします 追加チャットでクリック + → コネクタを参照する → クエリストリーム → 接続する.
   3. クエリ ストリーム タブが開きます。求められたらサインインし、組織を選択して確認します。 読む そして 実行する任意 特定のコネクタに限定する、そしてクリック 接続を承認する.
   4. Claudeに戻ると、「クエリ ストリームに接続済み」と表示されます。Claudeがツールを初めて使用すると、次の質問が表示されます。 常に許可する.

   Claude Desktopで手動で追加する場合は、 設定 → コネクタ → 追加チャット内ではなく マーケットプレイスを追加 このオプションは、Gitリポジトリを必要とします。コネクタはClaudeアカウントと同期されるため、モバイルアプリとデスクトップ版は自動的にそれを取得します。メニュー名はAnthropicのものであり、変更可能です。

   クロード・コード 鍵

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

   ターミナル

   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時間のすべてのエラーを表示してください。」

   クロードフィルター ファイルセット.イベント の上 メッセージ そして最後の1時間 イベント時間新しい順に表示されます。

   「私のフォーマットではどの行が解析できなかったのか、そしてその理由は何か？」

   クロードは読書をする fileset.events_raw_lines、グループ別 理由 また、例も示されているので、フォーマットを調整できます。

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

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

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

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

セマンティックインテリジェンスがここで重要な理由

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

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

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

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

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

安全に保つ

良い次の動き

• フォーマットを調整する クロードにどのセリフが採用されたかを尋ねることで イベント_生の行次にコネクタを編集します。変更を保存すると、エージェントが再サンプリングを実行します。
• 変更を監視するフォルダーを有効にする（ほぼリアルタイム） ローカルディスク上の新しい行を数秒以内に検出します。スケジュールされたスキャンは、その保証を継続します。
• 組み込み型をリクエストする フォーマットが一般的なものであれば、ポータルには「リストにないログタイプが必要ですか？サポートリクエストを送信していただければ、数日以内に追加いたします。」と表示されます。

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

人々が尋ねる質問

関連ガイド

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