MCPを使用して複数レコードのCSVファイルをClaudeに接続する

複数レコードのCSV無料プランクエリストリームクロード

複数レコード CSV → Claude · Query Streams を使用

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

無料で始めよう

最終的に手に入るもの

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

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

今週のファイルからバッチヘッダーを古い順に一覧表示します。

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

クロードは構造を読みます ファイルセット.data_hdr そして位置指定列を認識します。エージェントを通して 1 つの SELECT を実行し、読み取っていることを通知します。 フィールド1 バッチ番号として、 フィールド2 バッチ日付として。

_ソースファイル	フィールド1	フィールド2
inbound/2026-09-21/batch_0917.csv	B-000917	2026-09-21
inbound/2026-09-23/batch_0918.csv	B-000918	2026-09-23
inbound/2026-09-25/batch_0919.csv	B-000919	2026-09-25

詳細行をフォローアップします。クロードが参加します データ_hdr 詳細表へ _ソースファイル そして _seq同じチャット内で。

今週は各バッチの詳細行から合計金額を計算し、ヘッダーの合計金額と一致しないものにはフラグを付けてください。

qs_get_relationships qs_run_query qs_run_query

私は参加しました データ_hdr ～へ データ_dtl の上 _ソースファイル そして _seq要約すると フィールド4 詳細を確認し、ヘッダーと比較しました。 フィールド3:

バッチ	ヘッダー合計	詳細合計	マッチ
B-000917	48,210.00	48,210.00	✓
B-000918	51,904.50	51,904.50	✓
B-000919	46,300.00	39,115.25	✗ −7,184.75

B-000919 7,184.75不足している。最後の詳細 _seq ヘッダーには228行と記載されているのに、実際の行数は214行なので、ファイルはトレーラー部分より前に切り取られています。請求書が発行される前に再請求する価値があります。

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

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

システムによっては、ヘッダー行、詳細行、トレーラーなど、複数のレコードタイプを1つのファイルに混在させたCSVファイルを作成する場合があります。各レコードタイプは、1つの列にタグでマークされます。マルチレコードCSVコネクタは、これらのレコードを分割し、Claudeが各レコードタイプを個別のテーブルとしてクエリできるようにします。データベースの設定は不要です。エージェントは、自身のコンピュータ上のフォルダを読み込み、そこに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分ごとから毎日まで）は、エージェントが新規ファイル、変更されたファイル、および消失したファイルを検索する頻度です。 変更を監視するフォルダ ローカルディスク上で数秒以内に反応します。 ファイルが消えたとき は 行を削除する デフォルトでは。

   レルム、レビュー

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

   • ありません テーブル名 フィールド。テーブル名はレコードタグから付けられます。
   • セット ファイルレイアウト、 レコードタグ列（番号） タグを保持するもの、そして デリミタ.
   • 選ぶ テーブルスコープデフォルトでは、タグごとに1つのテーブルが作成されます。 ファイル拡張子とタグごとに1つのテーブル 異なるファイル形式から同じタグを分離して保持します。
   • 設定を行う前に、ウィザードは、一致するすべてのファイルが同一のレイアウトを共有する必要があることを通知します。最初の同期処理では、サンプルからそのレイアウトが固定され、後でレイアウトが一致しないファイルは隔離され、報告されます。
   • の上 チェックエージェントはサンプルを読み込み、構築するテーブルを一覧表示します。保留されるファイルは以下に表示されます。 どのファイルとその理由を表示する.

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

   テーブルにはレコードタグごとに名前が付けられています。 データ_hdr タグ HDR の場合。列は位置によって番号が付けられています。 フィールド1 ～へ フィールドNタグ列なしで。レコードタイプを結合します _ソースファイル そして _seq.

   テーブル	中身
   データ_<タグ>、 例えば データ_hdr	すべてのファイルからそのタグが付いたすべての行が、 フィールド1 ～へ フィールドNプラス _seq, _ソースファイル そして _row_id.
   データ_<拡張子>_<タグ>	ファイル拡張子で分割した場合も同様です。 テーブルスコープ は ファイル拡張子とタグごとに1つのテーブル.
   ファイル	フォルダ内に残っている、一致するすべてのファイルとそのパス、サイズ、更新日時。
   ファイルイベント	変更履歴。不明なタグまたは列数の間違いのために保留されたファイルのドリフト行も含まれます。 イベント_at.
   ディレクトリ	ルートディレクトリ以下の各フォルダ内のファイル数とファイルサイズ。

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

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

   「今日、どのファイルがフォルダに届きましたか？」

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

   「各ファイルのヘッダーを予告編の横に配置し、両方を表示してください。」

   Claudeは、_source_fileと_seqに基づいてdata_hdrをトレーラーテーブルに結合し、ファイルごとに1行を返します。

   「不明なタグや列数の間違いが原因で、ファイルが保留されたケースはありましたか？」

   クロードはfiles_events内のドリフト行を、最新のevent_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クレジットが消費されます。 価格ページをご覧ください 手当のために。

安全に保つ

良い次の動き

• セマンティックインテリジェンスを実行する クロードは、 フィールド1 ～へ フィールドN 各レコードタイプにおける平均値。ファイルテーブルには既に組み込みの説明が含まれています。
• files_events を確認してください 未知のタグ用に確保されたファイルの最初の同期後。
• 複数レコードCSVに関する完全なガイドをお読みください。 で SQLを使用して複数レコードのCSVファイルをクエリする あらゆる場面に対応。

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

人々が尋ねる質問

関連ガイド

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