JSONLファイルのフォルダをMCPを使ってClaudeに接続する

MCP · JSONLフォルダをクロードへ

聞く クロード JSONLフォルダファイルについて、 平易な英語で

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

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

最終的に手に入るもの

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

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

昨日、チェックアウト失敗イベントが発生した顧客は誰で、そのイベントはどのファイルに記録されていましたか？

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

クロードは構造を読みます ファイルセット.イベント まず、どのフラット化された列が存在するかを把握します。次に、エージェントを通して SELECT を 1 つ実行し、フィルターを適用します。 イベントタイプ そして昨日の日付。

_ソースファイル	イベントタイプ	顧客ID
exports/2026-09-25/web-01.jsonl	チェックアウト失敗	C-104482
exports/2026-09-25/web-02.jsonl	チェックアウト失敗	C-099317
exports/2026-09-25/web-02.jsonl	チェックアウト失敗	C-110206

各行にはソースファイル名が記載されているため、ファイルを開いて該当行を自分で確認できます。クロードは、エージェントが前回のスキャン時にキャッシュした行から応答を返します。

今週、チェックアウトでどのような問題が発生していますか？状況は悪化していますか？また、どのユーザーに影響が出ていますか？

qs_run_query qs_run_query

数えた チェックアウト開始 に対して チェックアウト失敗 1日あたり ファイルセット.イベントそして今日の失敗をグループ分けしました 支払いプロバイダー そして エラーコード:

日	チェックアウト	失敗した	レート
9月25日	41,200	1,236	3.0%
9月26日	39,880	1,596	4.0%
9月27日	22,410	2,017	9.0%

状況は急速に悪化している。今日の9%はほぼ完全に1つのプロバイダーによるもので、2,017件の障害のうち1,840件は カードコ と 3ds_タイムアウト午前6時40分から開始します。他のプロバイダーは通常の3%です。これはプロバイダー側の問題であり、お客様のチェックアウトの問題ではありません。

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

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

JSONLフォルダコネクタを使用すると、JSONLビューアを開かずにClaudeからJSONLファイルを表示およびクエリできます。JSON行ファイルが格納されたフォルダを指定すると、各行が1行になり、ネストされたオブジェクトは列にフラット化されます。データベースサーバーにアクセスする必要はありません。エージェントは自身のコンピュータ上でフォルダを読み込み、行をSQLテーブルとしてキャッシュします。ClaudeはこのSQLテーブルをMCP経由でクエリします。

必要なもの

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

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. エージェントをフォルダーに指定してください

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

   フォルダー

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

   チェック

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

   設定

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

   レルム、レビュー

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

   • タイプA テーブル名、 例えば イベントこのカードでは必須です。
   • 奥行きを平らにする ネストされたオブジェクトのうち、何階層を列として扱うかを設定します。デフォルト値は2で、範囲は1～8です。
   • 離れる テーブルレイアウト の上 固定レイアウト1つ（デフォルト） 定期的なエクスポートの場合。選択 レイアウトごとにテーブル1つ 手書きで記入するフォルダー用。
   • の上 チェックエージェントは最大64個のファイルのサンプルを読み込み、ファイル数、サイズ、行数の推定値、および作成するテーブルを表示します。まだ何も作成されていません。ファイルが異なる形状の場合、パネルにフォルダーに複数の異なるファイルレイアウトが含まれていることが示されます。 レイアウトごとにテーブルを1つに切り替えます それぞれの形状に専用の表を与える。

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

   テーブルは 1 つ取得します。 テーブル名 例えば、 ファイルセット.イベントネストされたオブジェクトは、 奥行きを平らにするさらに深い階層はJSONテキストとして保持されます。各行には _ソースファイルそうすれば、それがどのファイルから来たのかが常にわかります。

   テーブル	中身
   イベント （テーブル名）	一致したファイルごとに JSON 行ごとに 1 行、フラット化深度にフラット化、さらに _ソースファイル そして _row_id.
   レイアウトごとにテーブル1つ	と レイアウトごとにテーブル1つ各形状ごとに、ファイル名の共通部分に基づいて命名された独自のテーブルが割り当てられます。レイアウトは最大25個まで可能です。
   ファイル	フォルダ内に残っている、一致するすべてのファイルとそのパス、サイズ、更新日時。
   ファイルイベント	変更履歴：出現、変更、消失したファイル、およびサイズが合わなかったファイルのドリフトと拒否行。 イベント_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. 最初の質問をしてください

   まずはフォルダを開いて確認できるものから始めましょう。そうすれば、クロードが正しいテーブルに手を伸ばす様子がわかります。JSON行ファイルのフォルダと相性の良い3つの例を以下に示します。

   「過去1日間に変更されたJSONLファイルはどれですか？」

   Claude は、fileset.files に対して、relative_path、size_bytes、modified_utc を新しい順にクエリします。

   「今週、各イベントタイプごとに1日あたり何件のイベントが発生しましたか？」

   クロードはデータテーブルを日とイベントタイプごとにグループ化します。ネストされたフィールドは既に列になっているため、それらを直接フィルタリングできます。

   「JSONLファイルは別途保管されましたか？また、その理由は？」

   クロードはfiles_events内のドリフト行と拒否行を、最新のevent_atから順に読み取り、各ファイルとその理由に名前を付けます。

   配線を確認するには、 「どのようなクエリ ストリーム コネクタが利用できますか？」クロードが電話をかけてくる 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 クレジットを消費します。 価格ページをご覧ください 手当のために。

安全に保つ

良い次の動き

• セマンティックインテリジェンスを実行する コネクタ上で設定することで、クロードはあなたの列の平易な英語の説明を受け取ることができます。ファイルテーブルには既に説明が組み込まれています。
• スキャン間隔を短くする 新しいファイルが頻繁にアップロードされる場合、エージェントはデフォルトで1時間ごとにフォルダをチェックします。
• JSONLフォルダガイド全文を読む で JSONファイルのフォルダをSQLテーブルに変換する あらゆる場面に対応。

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

人々が尋ねる質問

関連ガイド

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