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

CSVフォルダ無料プランクエリストリームクロード

CSV Folder → Claude · Query Streamsを使う

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

無料で始めよう

最終的に手に入るもの

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

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

fileset.sales にはどのファイルがデータを提供し、それぞれ何行追加されますか？

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

3つのCSVファイルフィード ファイルセット.売上9月の輸出量は最大で、1万8000列強となる。

_ソースファイル	行数	first_row_id
exports/sales_2026_09.csv	18422	exports/sales_2026_09.csv:0000000
exports/sales_2026_08.csv	17305	exports/sales_2026_08.csv:0000000
exports/sales_2026_07.csv	16988	exports/sales_2026_07.csv:0000000

3つのファイルすべてについて、月ごとの売上合計を計算しましょうか？

今月、先月と比較して最も成長した地域はどこでしたか？また、減少した地域はありましたか？

qs_run_query qs_run_query

すべてのCSVファイルは既に1つのテーブルになっているので、合計しました。 額 による 地域 毎月直接 ファイルセット.売上読み取り専用クエリが2つあります。

地域	今月	先月	変化
ウエスト	412,300	348,900	+18%
セントラル	388,120	391,000	−1%
イースト	201,450	262,800	−23%

ウエスト 受注件数の増加によるもので、受注額の増加によるものではない。 イースト 23%減少しました。これは1つのアカウントによるものです。ハーバーフーズは先月は毎週注文していましたが、今月は一度も注文していません。中部は横ばいです。東部の顧客別の注文数が必要ですか？

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

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

の CSVフォルダ カードは、フォルダ内のすべてのCSVファイルを1つのSQLテーブルに統合し、クロードがクエリを実行できるようにします。また、各行には元のファイルがタグ付けされます。チャットにファイルをアップロードする必要はありません。エージェントにフォルダを一度指定するだけで、エージェントは行をローカルキャッシュにコピーし、ファイルが到着または変更されるたびにテーブルを最新の状態に保ちます。

必要なもの

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

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

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

   フォルダー

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

   チェック

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

   設定

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

   レルム、レビュー

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

   • タイプA テーブル名、 例えば 売上高このカードでは必須です。
   • パターンを含める 始まりは **/*.csv.
   • 選ぶ テーブルレイアウト. 固定レイアウト1つ（デフォルト） 共通のヘッダーを持つ定期的なエクスポートに適しています。 レイアウトごとにテーブル1つ スーツフォルダーは、最大25レイアウトまで手作業で組み立てられます。
   • の上 チェックエージェントはサンプルを読み込み、ファイル数、行数の見積もり、および構築するテーブルを表示します。フォルダにレイアウトが混在している場合は、青いパネルにその旨が表示されます。 レイアウトごとにテーブルを1つに切り替えます.
   • 琥珀色のバナーには、保留されるファイルの一覧が表示されます。 どのファイルとその理由を表示する それぞれの理由を理解するため。

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

   すべてが ファイルセット スキーマ。データテーブルには、入力した名前が入ります。 テーブル名列はCSVヘッダーから取得され、さらに _ソースファイル そして _row_id すべての行に。

   テーブル	中身
   ファイルセット.売上	と ピン留めレイアウト1つあなたの名前のテーブルが1つあります テーブル名一致したすべてのCSVファイルの行を保持します。
   ファイルセット.注文, fileset.returns	と レイアウトごとにテーブル1つレイアウトごとに1つのテーブルがあり、ファイル名の共通部分に基づいて名前が付けられます。 orders_2026_01.csv ～へ orders_2026_03.csv なる オーダー.
   ファイルセット.ファイル	現在存在するCSVファイルごとに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. 最初の質問をしてください

   まずはフォルダを開いて確認できるものから始めましょう。そうすれば、クロードが正しい表に手を伸ばす様子がわかります。CSVファイルを含むフォルダでうまく機能する3つの例を以下に示します。

   「フォルダ内にはどのCSVファイルがあり、それぞれ最後に変更されたのはいつですか？」

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

   「ファイルセット.salesの金額列を月ごとに合計してください。」

   クロードはまずテーブルスキーマを読み込んで実際の列名を見つけ（Read）、次にDuckDBを実行します。 GROUP BY エージェント（クエリ実行）を通じて操作すると、月ごとの合計値を示す小さな表が表示されます。

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

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

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

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

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

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

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

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

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

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

安全に保つ

良い次の動き

• セマンティックインテリジェンスを実行する コネクタ上で設定することで、Claude はファイルテーブルだけでなく、独自の CSV 列の説明も確認できるようになります。
• 同じフォルダーに2つ目のコネクタを追加する ParquetファイルやExcelファイルも格納できる場合。1つのコネクタは1種類のファイルタイプしか読み取れません。
• CSVフォルダガイドをお読みください で 複数のCSVファイルを1つのテーブルに結合する あらゆる場面に対応。

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

人々が尋ねる質問

関連ガイド

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