使用 MCP 将多记录 CSV 文件连接到 Claude。

MCP · 多记录 CSV 到 Claude

问 克劳德 关于您的多记录 CSV 文件， 用通俗易懂的英语

只需将 Claude、Claude Code、Cursor 或任何 MCP 客户端连接到 Query Streams 一次。Claude 会读取您的多记录 CSV 文件的结构，编写 SQL 语句，并通过已连接到您数据的代理以只读方式运行该语句，并返回相应的行。AI 无需获取任何数据库密码。整个过程大约需要十分钟，免费套餐即可满足需求。

大约10分钟 Claude、ChatGPT、Cursor 以及其他 11 位客户 文件位置不变 始终只读

你最终会得到什么

Claude 能够回答有关混合了多种记录类型的 CSV 文件的问题，它通过对代理程序根据您的文件构建的表格进行实时只读查询，并告诉您每个答案来自哪个文件——无需登录或文件路径，也无需更改防火墙设置：代理程序已部署在您的网络中，它会读取文件夹并仅返回其中的行。代理程序部署完成后，如果您熟悉设置界面，连接 Claude 大约需要 90 秒。例如：

Claude · 已连接到查询流 只读

列出本周文件的批处理标题，从最早的开始。

qs_get_table_schema qs_run_query 模式智能

克劳德解读了结构 文件集.data_hdr 并查看位置列。它通过您的代理运行一个 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

接下来添加细节线条。克劳德加入。 数据头 到详细信息表 源文件 和 _seq在同一聊天记录中。

本周将每批货物的明细汇总，并标记出任何与总和不符的批次。

qs_get_relationships qs_run_query qs_run_query

我加入了 数据头 至 数据_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 实际只有 214 行，而文件头显示有 228 行，所以文件在结尾部分之前就被截断了。建议在开票前重新索取一份。

仅选择，由代理检查。 已登录 MCP 活动选项卡 3 个查询共返回 6 行数据

完全不想搭建人工智能客户端？ 关于商业计划书， 诺瓦 MCP 是 Query Streams 内置的助手。它拥有 Claude 的所有工具，以及 Claude 没有的工具：它可以根据您的语义智能模型生成和验证 SQL，将结果转换为图表，并将结果保存为查询，您的团队可以从 Excel、Google Sheets 或 REST API 运行该查询——无需密钥、连接器或安装任何软件。如果您的团队已经在使用 Claude、Cursor 或 ChatGPT，请使用 MCP；如果您希望在门户网站内获取答案，请使用 Nova。

有些系统会生成混合多种记录类型的 CSV 文件，例如标题行、明细行和尾部，每种记录类型都用一列中的标签进行标记。多记录 CSV 连接器会将这些记录类型拆分，以便 Claude 可以像查询独立表一样查询每种记录类型。无需设置数据库。代理程序会读取其计算机上的文件夹，并将数据行缓存为 SQL 表。

你需要准备什么

查询流帐户

MCP 包含在所有套餐中，包括免费套餐。免费套餐允许使用一个钥匙或一个连接的应用程序，这足以满足本指南的需求。立即注册！ my.querystreams.com.

计算机上的代理可以打开该文件夹

版本 2.6.0 或更高版本。文件夹可以位于该计算机上，也可以位于它可以访问的文件共享文件夹中。代理程序以服务形式运行，因此请键入“shares as”。 \\服务器\共享\文件夹不是映射的驱动器号。刚开始使用 Agent？ 在 Windows 上安装它, macOS 或 Linux.

MCP 已为您开启

创建者、所有者和管理员从一开始就拥有权限。其他所有人则需要管理员来切换权限。 MCP 他们名字旁边的开关 账户 → 访问控制在此之前，MCP 页面会显示“您的帐户已禁用 MCP”。

人工智能客户

网页版 Claude、桌面版 Claude 或移动应用无需密钥即可连接。Claude Code、Cursor、ChatGPT 以及其他约十种工具也同样适用；门户网站为每种工具都提供了现成的配置方案。

分四步完成设置

1. 将代理指向文件夹

   在门户网站中打开 数据 → 数据代理找到可以打开文件夹的代理，然后单击其 添加连接器 按钮下方 文件和文件夹 点击药丸 多记录 CSV 卡片。然后，巫师会引导你完成整个过程。 文件夹, 查看, 设置, 领域 和 审查:

   文件夹

   输入 根文件夹每行一个路径，作为代理计算机上的路径。 扫描子文件夹 已开启， 最大深度 是 8。 包含模式 以适用于此文件类型的正确通配符开头；添加 排除模式 如果文件夹中包含您不需要的文件。映射驱动器盘符会显示琥珀色警告：代理程序无法识别它，因此请使用其他方式。 \\server\share 改为走路径。

   查看

   代理程序读取最多 64 个文件的样本，并显示它将要构建的内容。目前尚未创建任何内容。 准备创建 这意味着每个采样文件都符合要求。琥珀色横幅“{n} 个文件（共 {m} 个文件）将被排除在外”列出了不符合要求的文件。 找出需要哪些文件以及原因您可以先创建连接器，稍后再进行修复。如果文件夹混合了不同的布局，则会显示一个蓝色面板。 切换到每个布局一张桌子.

   设置

   扫描间隔 （默认情况下每小时一次，从每 5 分钟一次到每天一次）是代理查找新文件、已更改文件和已消失文件的频率。 监视文件夹的更改 在本地磁盘上几秒钟内即可做出反应。 文件消失时 是 删除它的行 默认情况下。

   领域，评论

   选择要统计行数的“数据领域”，查看摘要并单击 创建连接器第一次扫描立即开始；连接器的 显现 该选项卡显示它构建的内容以及它保存的任何文件。

   • 没有 表名 字段。表名取自记录标签。
   • 放 文件布局， 这 记录标签列（编号） 上面贴着标签，以及 分隔符.
   • 选择 表格范围默认情况下，每个标签对应一个表格。 每个文件扩展名和标签对应一个表格 将不同类型文件中的相同标签区分开来。
   • 配置向导会提示所有匹配的文件必须共享同一个布局。第一个同步引脚会根据示例布局进行匹配，之后出现不匹配的文件将被忽略并记录。
   • 在 查看代理程序读取样本并列出它将要构建的表。将被保留的文件显示在下方。 找出需要哪些文件以及原因.

2. 看看你能得到哪些表格

   表格已为您命名，每个记录标签对应一个表格，例如： 数据头 HDR标签。列按位置编号， 字段1 至 字段_N不带标签列。连接记录类型 源文件 和 _seq.

   桌子	它包含什么
   data_<tag>， 例如 数据头	每个文件中带有该标签的每一行，都像这样 字段1 至 字段_N加上 _seq, 源文件 和 _row_id.
   data_<扩展名>_<标签>	同样，如果也按文件扩展名拆分的话，情况也是如此。 表格范围 是 每个文件扩展名和标签对应一个表格.
   文件	文件夹中所有匹配的文件，包括路径、大小和修改时间。
   文件事件	变更历史记录，包括因未知标签或列数错误而被保留的文件的漂移行。排序方式 事件.
   目录	根目录下每个文件夹的文件数量和大小。

   每个文件夹连接器都会向 Claude 提供相同的记账表，所有表都在…… 文件集 模式：

   桌子	它包含什么
   文件	文件夹中所有文件的路径、名称、扩展名、大小、创建时间和修改时间。问“这个文件夹里有什么？”，克劳德就会读取这些信息。
   文件事件	变更历史记录：每行记录一个文件的出现、修改、消失或搁置情况（漂移），随着时间推移 事件 原因在于 细节.
   目录, 卷	文件夹大小和数量，以及根目录所在的磁盘或共享文件夹。
   源文件, _row_id	每行数据包含两列：该行数据来自哪个文件，以及该文件内的一个固定行 ID。按以下方式分组 源文件 比较文件。

3. 联系克劳德

   打开 流媒体 → 直播 → MCP有两条路可以进去，但它们通向同一个地方：

   聊天应用 · 无密钥

   claude.ai、Claude Desktop、ChatGPT

   在 Claude 中，查询流位于 人类连接器目录浏览连接器，点击 连接在其他情况下，您只需将一个地址粘贴到应用程序中即可。 https://mcp.querystreams.com/mcp并通过聊天连接。此时会打开“查询流”页面，您可以选择组织和权限，然后点击。 批准连接无需复制，无需保密。该连接显示在下方。 互联应用 并且可以在那里被撤销。

   开发者工具 · 关键

   Claude Code、光标、VS Code 和朋友们

   在 我的钥匙 点击 生成密钥给它一个 键名 例如“我笔记本电脑上的克劳德代码”，保持 读 和 执行 勾选后，请选择一个 到期日 （从不、30 天、90 天或 1 年）并点击 生成密钥然后复制它。 继续安装： 这 连接 此选项卡显示了您的工具的完整代码片段，其中密钥已预先填写。

   两种方式都使用相同的三个权限，您可以在同意屏幕或密钥上选择这些权限：

   读

   列出连接器，浏览表和列，读取已保存的查询和警报规则。从不返回行数据。

   执行

   通过代理运行只读 SQL 和已保存的查询，并返回相应的行。否则，Claude 可以描述您的数据，但无法从中获取答案。

   分析

   它会分析表结构、发现关联关系并安排语义智能运行。此操作会消耗 Nova AI 积分和数据流量，因此不会在同意界面预先勾选。

   钥匙丢了？ 打开 我的钥匙眼睛图标再次显示了它， 复制完整密钥 复制它。如果笔记本电脑丢失，则撤销该权限；所有使用该权限的客户端都会在大约五分钟内导致下次调用失败。

   然后选择你使用的克劳德的配方。服务器地址在所有地方都相同： https://mcp.querystreams.com/mcp.

   网页版 Claude、桌面版 Claude 和移动版 Claude 没有钥匙

   1. 打开 设置 → 连接器 并点击 浏览连接器查询流列在 人类连接器目录： 寻找 查询流 并点击 连接（或者直接打开目录列表并点击） 连接 那里。）
   2. 如果您的组织隐藏了目录连接器，请点击 添加自定义连接器 取个名字吧。 查询流， 粘贴 https://mcp.querystreams.com/mcp将 OAuth 字段留空，然后单击 添加然后在任何聊天中点击 + → 浏览连接器 → 查询流 → 连接.
   3. “查询流”选项卡随即打开。如果系统提示，请登录，选择组织，然后进行审核。 读 和 执行（可选） 仅限特定连接器然后点击 批准连接.
   4. 回到 Claude 界面，你会看到“已连接到查询流”。Claude 首次使用某个工具时会询问：请选择 始终允许.

   如果您在 Claude Desktop 中手动添加，请使用 设置 → 连接器 → 添加不是聊天记录 添加市场 此选项需要一个 Git 仓库。连接器会同步到您的 Claude 帐户，因此移动应用和桌面应用会自动识别。菜单名称为 Anthropologie 的，可能会更改。

   克劳德·科德 钥匙

   使用“我的密钥”中的密钥，只需执行一条命令：

   终端

   claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp \ --header "X-MCP-Key: qsmcp_PASTE_YOUR_KEY_HERE"

   这会写出当前项目的…… .mcp.json。 添加 --scope 用户 在每个项目中都包含查询流。运行 /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" } } } }

   重启 Cursor 或运行 MCP：重启服务器；一个 查询流 徽章会显示在 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-Key （一个 授权方式：持有者 使用相同键的标头也有效）。

4. 问你的第一个问题

   先从你可以打开文件夹查看的内容开始，这样你就能看到克劳德找到了正确的表格。以下三个表格非常适合处理混合了多种记录类型的 CSV 文件：

   “今天文件夹里收到了哪些文件？”

   Claude 查询 fileset.files 中的 relative_path、size_bytes 和 modified_utc，按最新文件优先。

   “将每个文件的头部信息放在其尾部信息旁边，并同时显示两者。”

   Claude 将 data_hdr 与你的 trailer 表按 _source_file 和 _seq 连接起来，并为每个文件返回一行。

   “是否有任何文件因为标签未知或列数错误而被搁置？”

   Claude 读取 files_events 中的漂移行，从最新的 event_at 开始，并为每个文件命名以及原因。

   要确认接线情况，请询问 我有哪些 Query Streams 连接器？克劳德打电话 qs_list_connectors，以及在 我的钥匙 关键在于…… 上次使用 时间更新只需几秒钟。

新建、更改和删除的文件如何显示

克劳德连接后能做什么

克劳德看到了十九个小工具。你从不亲自去叫它们；克劳德会根据你的问题挑选出最合适的工具。简单来说：

为什么语义智能在这里很重要

Claude 收到的每个答案都会被标记出该结构来自哪里，Claude 会根据标记调整它对所看到内容的信任程度。

如果数据库很重要，请对其运行一次语义智能分析。 新星 → 智能。 这 我的钥匙 该选项卡显示每个连接器的覆盖范围面板。 语义智能的工作原理.

这些计划允许什么？

MCP 功能包含在所有套餐中，包括免费套餐，无需额外付费。每个套餐的具体规定是您可以持有的密钥或已连接应用的数量，以及 Claude 每分钟可以拨打的电话数量：

已连接的应用算作一个密钥。除了每分钟的限额之外，每个密钥每分钟最多可以运行 10 次查询。每次查询最多返回 1000 行，运行时间最多 60 秒，除非 Claude 请求更多，上限为 50000 行和 5 分钟。Claude 接收到的行数计入您的数据领域配额，该配额与您的 Excel 和 Sheets 查询使用的配额相同。MCP 是在压缩之前计算的，因此，宽格式结果的成本高于电子表格中相同行数的成本。从 Claude 启动的语义智能运行会消耗 Nova AI 积分，与从 Portal 启动的运行完全相同。 请查看定价页面 津贴。

确保安全

下一步行动不错。

• 运行语义智能 所以克劳德知道了什么 字段1 至 字段_N 每种记录类型都包含含义。文件表已内置描述。
• 检查 files_events 在首次同步任何被标记为未知标签的文件之后。
• 阅读完整的多记录 CSV 指南 在 使用 SQL 查询多记录 CSV 文件 适用于各种场景。

当某些事情不起作用时

人们提出的问题

相关指南

• 使用 MCP 将 CSV 文件文件夹连接到 Claude。
• 使用 MCP 将 Excel 文件文件夹连接到 Claude。
• 使用 MCP 将 SQLite 数据库文件夹连接到 Claude。
• 使用 MCP 将 Parquet 文件文件夹连接到 Claude。
• 多记录连接器指南
• 通过 MCP 将查询流连接到 Claude：设置、权限和故障排除
• 所有 MCP 指南