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

MCP · Parquet Folder to Claude

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

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

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

最終的に手に入るもの

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

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

各ファイルはfileset.ordersに何行追加しますか？

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

ファイルセット.注文 3つの寄木細工のパーツから列が取られている。9月の最初のパーツが最も大きい。

_ソースファイル	行数	最終行ID
2026/09/orders-part-0001.parquet	250000	2026/09/orders-part-0001.parquet:0249999
2026/09/orders-part-0002.parquet	248731	2026/09/orders-part-0002.parquet:0248730
2026/08/orders-part-0001.parquet	231904	2026/08/orders-part-0001.parquet:0231903

8月と9月の注文総額を比較しましょうか？

今四半期におけるチャネル別の平均注文額はいくらですか？また、どのチャネルで注文額が減少していますか？

qs_run_query qs_run_query

私はグループ分けしました ファイルセット.注文 による チャネル 今四半期と前四半期について、すべてのParquetファイルで同時に：

チャネル	注文	平均注文数	前四半期との比較
ウェブ	184,210	86.40	+4%
携帯	96,004	61.10	−9%
卸売	2,118	1,940.00	+1%

携帯 落ち込んでいるのは です。平均注文額は 9% 減少していますが、注文数は 12% 増加しており、今四半期のモバイル注文の 38% は ようこそ15 前四半期は9%の割引コードを使用しました。販売量は問題ありませんが、割引によって利益率が圧迫されています。

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

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

の 寄木細工のフォルダー カードは、Parquet ファイルのフォルダを、Claude がクエリを実行できる単一の型付き SQL テーブルに変換します。列と型はファイル フッターから取得されます。Parquet ビューアや独自の DuckDB 環境は必要ありません。エージェントはファイルを読み込み、行を自身のコンピュータにキャッシュし、SQL として Claude に提供します。変更されたファイルがあれば、再度読み込みます。

必要なもの

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

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

   レルム、レビュー

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

   • タイプA テーブル名、 例えば オーダーこのカードでは必須です。
   • パターンを含める 始まりは **/*.parquet.
   • ありません テーブルレイアウト 選択肢。注記には、一致するすべてのファイルは同一のレイアウトを共有しなければならず、後で不一致が判明したファイルは隔離され、報告されると説明されている。
   • の上 チェックエージェントは最大 64 個のファイルをサンプリングし、ファイル数、サイズ、行数の推定値、テーブル名を表示します。2 つのファイルで列の型が一致しない場合、オレンジ色のバナーに「スキーマ スニッフィングが拒否されました」と表示され、理由が表示されます。それでもコネクタを作成できます。エージェントはチェックを続け、理由を表示します。 マニフェスト タブ。

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

   すべてが ファイルセット スキーマ。データテーブルはあなたの テーブル名ファイルには列の追加や省略が含まれる場合があります。テーブルには検出されたすべての列が保持され、ファイルに存在しない列はNULLとして読み取られます。

   テーブル	中身
   ファイルセット.注文	あなたの名前のテーブルが 1 つあります テーブル名一致する Parquet ファイルの行をすべて保持し、さらに _ソースファイル そして _row_id.
   ファイルセット.ファイル	現在存在するParquetファイルごとに1行ずつ、パス、サイズ、更新日時が記載されています。
   ファイルセット.ファイルイベント	変更履歴。 拒否した 行はレイアウトを固定できないことを意味し、 ドリフト 行には、別途保管されたファイルの名前が示されます。
   ファイルセット.ディレクトリ	フォルダごとに1行ずつ、ファイル数と合計サイズが表示されます。パーティション化されたフォルダツリーに便利です。

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

   テーブル	中身
   ファイル	フォルダ内のすべてのファイル：パス、ファイル名、拡張子、サイズ、作成日時、更新日時。「このフォルダには何が入っているの？」と尋ねると、クロードがこれを読み上げます。
   ファイルイベント	変更履歴: 出現、変更、消失、または保留されたファイルごとに 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. 最初の質問をしてください

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

   「そのフォルダにはどのようなParquetファイルが入っていて、それぞれのファイルサイズはどれくらいですか？」

   クロードの質問 ファイルセット.ファイル （実行）各ファイルを一覧表示します サイズ（バイト） そして 修正済みUTC.

   「fileset.ordersの列について説明し、その後10行を表示してください。」

   クロードは、Parquet フッターからの型情報を含むテーブルスキーマを読み込み (Read)、次に 1 つの処理を実行します。 セレクト と 制限10 代理人を通じて実行してください。

   「Parquetのファイルで、保留になったり拒否されたりしたものはありますか？その理由は？」

   クロードの質問 ファイルセット.ファイルイベント のために ドリフト そして 拒否した 行、 イベント_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 クレジットを消費します。 価格ページをご覧ください 手当のために。

安全に保つ

良い次の動き

• セマンティックインテリジェンスを実行する コネクタ上で設定することで、クロードはファイルテーブルだけでなく、あなた自身の列の説明も確認できるようになります。
• 変更を監視するフォルダーをオンにする 新しい部品がローカルディスクにダウンロードされ、数秒以内にそれらを使用したい場合。
• パーケットフォルダーガイドをお読みください で SQLを使用してParquetファイルのフォルダをクエリする あらゆる場面に対応。

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

人々が尋ねる質問

関連ガイド

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