使用 MCP 将您的文件系统连接到 Claude

文件系统免费计划查询流克劳德

文件系统 → Claude · 使用 Query Streams

借助 Query Streams，用通俗英语向 Claude 询问你的文件系统文件：已在你网络内部署的 Agent 会以只读方式运行 SQL，数据库密码绝不会传给 AI。大约只需十分钟，免费套餐即可满足需求。

免费开始

你最终会得到什么

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

Claude · 已连接到查询流 只读

fileset.files 中哪些文件最近发生了变化？这些文件有多大？

qs_get_table_schema qs_run_query 模式智能

以下是您文件夹下最近修改的三个文件。季度结算工作簿于昨天下午晚些时候进行了更改。

相对路径	大小（字节）	修改后的 UTC
Finance/2026/Q3-close.xlsx	482113	2026-09-25 17:42:10
Contracts/Acme-renewal-2026.pdf	1893402	2026-09-25 14:05:37
报告/周报/运营总结-w39.docx	96120	2026-09-25 09:18:54

想让我展示一下本月增长最多的文件夹吗？ 目录快照?

本月增长最快的文件夹有哪些？是否有任何文件夹异常庞大？

qs_run_query qs_run_query

我读 文件集目录 按文件夹大小计算， 文件集.文件 针对每个文件中最新的文件。这两个查询都是只读的：

小路	文件	尺寸	最新文件
每日出口量	27	10.8 GB	2026-09-27 03:10
财务/2026	412	2.1 GB	2026-09-27 17:42
照片/实地考察	1,930	6.4 GB	2026-09-19 08:55

每日出口量 最值得关注的是：同一个 400 MB 的转储文件，每晚生成一份，一共 27 份，而且旧文件不会被删除。财务数据的增长方式正如你所预料的那样。想要查看“导出”下最大的十个文件及其生成日期吗？

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

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

这 文件系统 该卡会将您计算机或文件共享上的文件夹转换为 SQL 表，用于描述您的文件：包括每个文件的名称、路径、大小和日期，以及更改历史记录和文件夹大小。它仅索引文件元数据，不读取文件内容，因此它不像 Anthropic 的参考文件系统服务器那样读取文件，Claude 也无法通过它打开、更改或删除文件。您只需将代理指向文件夹而不是数据库服务器，它就会自行构建和刷新表。

你需要准备什么

查询流帐户

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

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

版本 2.6.0 或更高版本。文件夹可以位于该计算机上，也可以位于它可以访问的文件共享文件夹中。代理程序以服务形式运行，因此请键入“shares as”。 \\服务器\共享\文件夹而不是映射驱动器号。在 Windows 系统中，可以使用您存储的登录信息登录共享文件夹；在 Linux 或 Mac 系统中，需要先挂载共享文件夹（Linux 系统下）。 /mnt 或 /媒体一台Mac电脑 卷刚接触代理？ 在 Windows 上安装它, macOS 或 Linux.

MCP 已为您开启

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

人工智能客户

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

分四步完成设置

1. 将代理指向文件夹

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

   文件夹

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

   查看

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

   设置

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

   领域，评论

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

   • 没有 表名 字段。文件系统仅构建库存表。
   • 每行放一个文件夹 根文件夹路径位于代理计算机上。请键入网络共享路径。 \\服务器\共享\文件夹而不是像 Z: 这样的映射驱动器号，因为代理程序作为服务运行，无法看到登录时映射的驱动器。
   • 包含模式 开始时 **/*.csv添加要列出的每种文件类型的模式，并使用 排除模式 任何你想省略的内容。
   • 在 查看代理程序读取样本，并显示可访问的文件夹数量、匹配的文件数量及其总大小。此时尚未创建任何内容。

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

   文件系统没有数据表。所有内容都位于一个名为“模式”的系统中。 文件集代理程序会将这些信息缓存到其计算机上，并在每次扫描时刷新。克劳德无需运行语义智能即可看到每个表的内置描述。

   桌子	它包含什么
   文件集.文件	每个文件一行： 相对路径, 名字, 扩大, 大小（字节）, 创建于 UTC, 修改后的 UTC 和 所有者 （仅限 Windows 系统）
   文件集.文件事件	更改历史记录。每一行都有一个 事件类型 例如出现、改变或消失，时间在 事件以及之前的尺寸。
   文件集目录	每行显示一个文件夹的文件数量， 子树字节最旧和最新的文件，以及 跳过原因 文件夹未被读取。
   文件集.目录快照	每天每个文件夹最多只能生成一个大小快照，这样您就可以看到哪些文件夹正在增长。
   文件集.卷	每个硬盘的容量和可用空间，以及 容量字节 和 空闲字节.

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

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

3. 联系克劳德

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

   聊天应用 · 无密钥

   claude.ai、Claude Desktop、ChatGPT

   在 claude.ai 和 Claude Desktop 中，打开 查询流列表 在 Anthropic 的连接器目录中，点击 连接 并批准。通过URL添加。 https://mcp.querystreams.com/mcp这是备用方案。在 ChatGPT 中，您可以从应用（目前需要开发者模式）添加 Query Streams，并使用 Query Streams 登录。无论哪种方式，都会打开 Query Streams 页面：选择组织和权限，然后点击 批准连接无需复制任何内容。连接显示在…… 连接 可以在那里撤销此操作。

   开发者工具 · 关键

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

   在 MCP 页面上点击 连接人工智能客户端导游问道 您的AI客户端将如何连接？： 选择 在配置文件中使用密钥选择你的工具，然后 生成密钥 它：一个 键名, 读 和 运行查询 勾选，一个 到期日 （从不、30 天、90 天或 1 年）。 设置好它 显示已填写密钥的代码片段，并且 检查连接 等待第一个电话。

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

   读

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

   运行查询

   通过您的代理运行只读 SQL 和已保存的查询，并返回相应的行。否则，您的 AI 客户端只能描述您的数据，而无法从中获取答案。

   分析

   分析表、发现关系并排队运行 Semantic Intelligence。分析和发现免费；Semantic Intelligence 运行会消耗 Nova AI 点数和数据额度，因此同意屏幕不会默认勾选该选项。

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

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

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

   1. 打开 查询流列表 在 Anthropic 的连接器目录中，然后点击 连接在桌面版中，它位于以下位置 + → 连接器.
   2. 如果您的组织隐藏了目录连接器，则可采取以下备用方案： 设置 → 连接器 → 添加自定义连接器， 姓名 查询流网址 https://mcp.querystreams.com/mcpOAuth字段为空， 添加然后在聊天中 + → 查询流 → 连接.
   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. 问你的第一个问题

   先从你可以打开文件夹查看的内容开始，比如你会看到克劳德伸手去拿正确的桌子。以下三种方法适用于你电脑或文件共享上的文件和文件夹：

   “这个文件夹里有哪些类型的文件？每种文件类型占用多少空间？”

   克劳德读着 文件集.文件 模式（读取），然后运行一个按以下方式分组的查询 扩大 和总和 大小（字节） （运行查询）。您将获得每种文件类型的数量和总大小。

   “哪些文件夹最大，哪些文件夹被跳过了？”

   克劳德询问 文件集目录 （运行查询），排序方式 子树字节 并列出所有包含以下内容的文件夹： 跳过原因例如过去的一次 最大深度.

   “过去七天内，股票代码中删除了哪些内容？”

   克劳德询问 文件集.文件事件 已消失的行，按以下方式筛选和排序 事件 （运行查询）。您将获得每个缺失文件以及扫描发现该文件的时间。

   要确认接线情况，请询问 我有哪些 Query Streams 连接器？克劳德打电话 qs_list_connectors《传送门》指南的 检查连接 步骤说 已连接以及钥匙或应用程序 连接 标签页显示了它的 上次使用 几秒钟之内即可完成。

访问网络共享上的文件

代理程序以后台服务的形式打开文件，而不是以用户身份打开，因此打开另一台计算机上的文件需要额外的步骤。具体步骤取决于代理程序运行所在的计算机。

如果测试无法获取份额，请在测试结果中查找以下词语： 无法连接 这意味着代理的计算机没有收到服务器的响应。在 Linux 或 Mac 系统上， 未安装 这意味着还需要挂载共享文件夹，并且该消息包含了适用于您服务器的确切挂载命令。

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

克劳德连接后能做什么

您的AI客户端会识别查询流工具；它会根据您的问题选择合适的工具。门户网站的 工具 标签 列出所有工具和模式，以及你的套餐包含的内容。Query Streams 会让你的 AI 客户端在查询前读取每个表的列信息，这样它就会使用真实名称，而不是猜测。所有套餐（包括 Free）均可使用：

分析工具集。 付费方案中，代理程序会负责文件系统文件所在的底层工作，这样您的AI客户端就可以专注于思考。免费方案的功能与以往相同。

默认值存在于 语境 标签：文本单元格限制、架构视图、结果大小、分析默认值和保留结果。

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

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

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

这些计划允许什么？

MCP 包含在所有套餐中，包括免费套餐，无需额外付费。每个套餐的具体规定是您可以持有的密钥或已连接应用的数量，以及您的 AI 客户端每分钟可以发起的呼叫次数：

已连接的应用算作一个键。除了每分钟的限制外，任何一个键每分钟最多可以运行 10 次查询。查询运行时间最长为 60 秒，除非您的 AI 客户端请求更长的运行时间（最长 5 分钟）。您的计划还会设置每次查询返回的行数，以及（使用分析工具集）保留结果的时长和大小； 完整的MCP指南 列出每个计划。AI 客户端接收的内容会计入您的 Data Realm 配额，与 Excel 和 Sheets 查询使用同一额度池：AI 代理 (MCP) 用量会统计发送给 AI 客户端的每一个字节，包括结果、架构读取和暂存结果页面，且统计发生在客户端协商的任何传输压缩之前；而电子表格查询统计的是 Network Agent 发送的压缩结果。从 AI 客户端启动的 Semantic Intelligence 运行会消耗 Nova AI 积分，与从 Portal 启动时完全相同。 请查看定价页面 津贴。

确保安全

下一步行动不错。

• 启用“监视文件夹”功能，以检测更改。 如果您希望新文件在几秒钟内显示在本地磁盘上。
• 询问数据的时效性。 克劳德回答了最新的 last_seen_utc 在 files_current 以及最新的 事件 在 文件事件.
• 阅读完整的文件系统指南 在 对文件系统建立索引并使用 SQL 查询它 适用于各种场景。

当某些事情不起作用时

人们提出的问题

相关指南

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