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

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

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

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

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

最終的に手に入るもの

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自体に組み込まれたアシスタントです。Claudeが利用できるすべてのツールに加え、Claudeにはない機能も備えています。セマンティックインテリジェンスモデルに対して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にインストールしてください, 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では、クエリ ストリームは 人間活動関連コネクタディレクトリコネクタを参照するには、クリックしてください。 接続する他の場所では、アプリにアドレスを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. 最初の質問をしてください

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

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

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

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

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

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

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

安全に保つ

良い次の動き

• セマンティックインテリジェンスを実行する コネクタ上で設定することで、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ガイド