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

寄木細工のフォルダー無料プランクエリストリームクロード

Parquet Folder → Claude · Query Streamsを使用

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

無料で始めよう

最終的に手に入るもの

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自体に組み込まれたアシスタントです。AIクライアントがここで利用できるエージェントツールセットと同じものを使用するだけでなく、外部クライアントでは利用できない機能も備えています。つまり、セマンティックインテリジェンスモデルに対して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では、保存したログイン情報を使用して共有にサインインできます。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分ごとから毎日まで）は、エージェントが新規ファイル、変更されたファイル、および消失したファイルを検索する頻度です。 変更を監視するフォルダ ローカルディスク上で数秒以内に反応します。 ファイルが消えたとき は 行を削除する デフォルトでは。

   レルム、レビュー

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

   • タイプ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.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. 最初の質問をしてください

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

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

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

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

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

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

   クロードの質問 ファイルセット.ファイルイベント のために ドリフト そして 拒否した 行、 イベント_at （クエリを実行します）。ファイルと理由は以下から取得します。 詳細.

   配線を確認するには、 「どのようなクエリ ストリーム コネクタが利用できますか？」クロードが電話をかけてくる qs_list_connectorsポータルガイドの 接続を確認してください ステップにはこう書いてある 接続済み、キーまたはアプリ コネクション タブには、 最終使用日時 数秒以内の時間。

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

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

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

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

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

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

分析ツールセット。 有料プランでは、エージェントがParquetフォルダファイルが存在する場所で基礎的な作業を行うため、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クレジットが消費されます。 価格ページをご覧ください 手当のために。

安全に保つ

良い次の動き

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

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

人々が尋ねる質問

関連ガイド

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