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

カスタムログ無料プランクエリストリームクロード

カスタムログ → Claude · Query Streams を使用

Query Streams を使えば、Custom Logs ファイルについて平易な英語で Claude に質問できます。ネットワーク内にすでに配置された Agent が SQL を読み取り専用で実行するため、データベースのパスワードが AI に渡ることはありません。所要時間は約10分で、Free プランで利用できます。

無料で始めよう

最終的に手に入るもの

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自体に組み込まれたアシスタントです。AIクライアントがここで利用できるエージェントツールセットと同じものを使用するだけでなく、外部クライアントでは利用できない機能も備えています。つまり、セマンティックインテリジェンスモデルに対して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では、保存したログイン情報を使用して共有にサインインできます。LinuxまたはMacでは、まず共有をマウントします（Linuxでは /月 または /メディアMac 1台 /巻) エージェントを初めてご利用ですか？ 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.ai と Claude Desktop で、 クエリ ストリーム一覧 Anthropicのコネクタディレクトリで、 接続する そして承認します。URL で追加します。 https://mcp.querystreams.com/mcpはフォールバックです。ChatGPTでは、アプリからクエリ ストリームを追加し（現時点では開発者モード）、クエリ ストリームでサインインします。どちらの方法でもクエリ ストリーム ページが開きます。組織と権限を選択してクリックします。 接続を承認するコピーするものは何もありません。接続は コネクション タブで取り消すことができます。

   開発者ツール・鍵

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

   MCPページでクリック AIクライアントを接続するガイドは尋ねる AIクライアントはどのように接続しますか？： 選ぶ 設定ファイル内のキーを使用するツールを選んでから キーを生成する それ： キー名, 読む そして クエリを実行する チェックした、 有効期限 （なし、30日間、90日間、または1年間） 設定する キーが記入されたスニペットが表示され、 接続を確認してください 最初の呼び出しを待つ。

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

   読む

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

   クエリを実行する

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

   分析

   テーブルをプロファイリングし、関係を検出して、Semantic Intelligenceの実行をキューに追加します。プロファイリングと検出は無料です。Semantic Intelligenceの実行ではNova AIクレジットとデータ利用枠を消費するため、同意画面であらかじめ選択されることはありません。

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

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

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

   1. 開く クエリ ストリーム一覧 Anthropicのコネクタディレクトリでクリックして 接続するデスクトップでは、その下に配置されます。 + → コネクター.
   2. 組織がディレクトリコネクタを非表示にしている場合の代替策： 設定 → コネクタ → カスタムコネクタを追加、 名前 クエリストリーム、URL 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ステータスバーに表示されます。

   他のものを使っていますか？ ポータルの AIクライアントを接続する ガイド 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ポータルガイドの 接続を確認してください ステップにはこう書いてある 接続済み、キーまたはアプリ コネクション タブには、 最終使用日時 数秒以内の時間。

ネットワーク共有上のファイルにアクセスする

エージェントは、ユーザーとしてではなく、バックグラウンドサービスとしてファイルを開くため、別のコンピューター上のファイルを開くには追加の手順が必要です。どの手順が必要かは、エージェントが実行されているコンピューターによって異なります。

テストで共有フォルダにアクセスできない場合は、結果の中に以下の単語を探してください。 到達不能 エージェントのコンピュータがサーバーから応答を受け取らなかったことを意味します。Linux または Mac では、 取り付けられていません これは、共有フォルダがまだマウントされていないことを意味し、そのメッセージにはサーバー用の正確なマウントコマンドが含まれています。

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

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

AIクライアントはクエリストリームツールを認識し、質問に最適なツールを選択します。ポータルの ツール タブ プランに含まれるすべてのツールとモードを一覧表示します。Query Streams は、クエリを実行する前にAIクライアントに各テーブルの列を読み取らせるため、推測ではなく実際の名前を使ってクエリを作成できます。Freeを含むすべてのプランで利用できます：

分析ツールセット。 有料プランでは、エージェントがカスタムログファイルの保存場所などの基礎的な作業を行うため、AIクライアントは思考処理に専念できます。無料プランはこれまで通り動作します。

デフォルトは コンテクスト タブテキストセルの制限、スキーマビュー、結果サイズ、分析のデフォルト設定、および保留された結果。

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

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

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

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

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

接続されたアプリはキーとしてカウントされます。1 分あたりの数値に加えて、1 つのキーは 1 分間に最大 10 回のクエリを実行できます。クエリは、AI クライアントが最大 5 分まで延長を要求しない限り、最大 60 秒間実行されます。プランでは、1 つのクエリが返す行数、および分析ツールセットを使用する場合は、保持される結果の長さとサイズも設定します。 MCP完全ガイド すべてのプランを一覧表示します。AIクライアントが受け取るデータは、ExcelやSheetsのクエリと共通のData Realm利用枠にカウントされます。AIエージェント（MCP）の使用量は、結果、スキーマの読み取り、保持された結果のページなど、AIクライアントに配信されるすべてのバイト数を、クライアントがネゴシエートする転送圧縮を行う前にカウントします。一方、スプレッドシートのクエリでは、Network Agentが配信する圧縮済みの結果がカウントされます。AIクライアントから開始されたSemantic Intelligenceの実行では、Portalから開始した場合とまったく同じようにNova AIクレジットが消費されます。 価格ページをご覧ください 手当のために。

安全に保つ

良い次の動き

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

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

人々が尋ねる質問

関連ガイド

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