SQLite Folder → Claude · 使用 Query Streams
借助 Query Streams,用通俗的英语向 Claude 询问 SQLite Folder 文件:已在您网络中的 Agent 会以只读方式运行 SQL,数据库密码绝不会传给 AI。大约十分钟即可完成,Free 计划足以满足需求。
免费开始
你最终会得到什么
Claude 是一款能够回答有关 SQLite 数据库文件文件夹的问题的代理程序,它通过对代理程序根据您的文件构建的表执行实时只读查询,并告诉您每个答案来自哪个文件——无需登录或文件路径,也无需更改防火墙设置:代理程序已部署在您的网络中,它会读取文件夹并仅返回行数据。代理程序部署完成后,如果您熟悉设置界面,连接 Claude 大约需要 90 秒。例如:
每个数据库文件为 fileset.data_events 贡献了多少行?
文件集.数据事件 合并来自三个门店数据库的事件表。市中心门店的行数最多。
| 源文件 | 行计数 | first_row_id |
|---|---|---|
| 商店/市中心/pos.db | 58214 | stores/downtown/pos.db:events:0000000 |
| stores/airport/pos.db | 41377 | stores/airport/pos.db:events:0000000 |
| stores/harbor/pos.db | 29806 | stores/harbor/pos.db:events:0000000 |
需要我按日期将每家门店的这些事件细分吗?
本周哪些商店的作废交易最多?是否有异常值?
商店数据库合并成一个 文件集.数据事件 因此,我使用表格,通过一次查询统计了每个门店的交易笔数中的作废笔数,然后按收银机细分了异常值:
| 店铺 | 交易 | 虚空 | 空置率 |
|---|---|---|---|
| 市中心 | 18,204 | 212 | 1.2% |
| 飞机场 | 12,910 | 148 | 1.1% |
| 港口 | 9,412 | 611 | 6.5% |
港口 这家门店的作废次数是其他门店的五倍,611起作废交易中有540起发生在晚上8点之后,均来自3号收银台。要么是收银机出了问题,要么需要向晚班员工询问一下。
完全不想搭建人工智能客户端? 关于商业计划书, 诺瓦 MCP 是 Query Streams 内置的助手。它使用与您的 AI 客户端相同的 Agent 工具集,此外还具备外部客户端所不具备的功能:它会根据您的语义智能模型生成并验证 SQL,将结果转换为图表,并将结果保存为查询,您的团队可以从 Excel、Google Sheets 或 REST API 运行该查询——无需密钥、连接器或安装任何软件。如果您的团队成员已经在使用 Claude、Cursor 或 ChatGPT,请使用 MCP;如果您希望在门户网站内获取答案,请使用 Nova。
这 SQLite文件夹 该卡允许 Claude 将一个包含 SQLite 数据库文件的文件夹作为一个数据库进行查询。每个文件中同名的表会合并成一个表,例如: 数据事件每一行都注明了它来自哪个文件。没有手动执行 ATTACH 或合并脚本。代理以只读方式打开每个文件,将行缓存到其计算机上,然后以 SQL 的形式将其提供给 Claude。
你需要准备什么
计算机上的代理可以打开该文件夹
版本 2.6.0 或更高版本。文件夹可以位于该计算机上,也可以位于它可以访问的文件共享文件夹中。代理程序以服务形式运行,因此请键入“shares as”。 \\服务器\共享\文件夹而不是映射驱动器号。在 Windows 系统中,可以使用您存储的登录信息登录共享文件夹;在 Linux 或 Mac 系统中,需要先挂载共享文件夹(Linux 系统下)。 /mnt 或 /媒体一台Mac电脑 卷刚接触代理? 在 Windows 上安装它, macOS 或 Linux.
MCP 已为您开启
创建者、所有者和管理员从一开始就拥有权限。其他所有人则需要管理员来切换权限。 MCP 他们名字旁边的开关 账户 → 访问控制在此之前,MCP 页面会显示“您的帐户已禁用 MCP”。
人工智能客户
网页版 Claude、桌面版 Claude 或移动应用无需密钥即可连接。Claude Code、Cursor、ChatGPT 以及其他约十种工具也同样适用;门户网站为每种工具都提供了现成的配置方案。
工作在哪里进行? 在运行代理程序的计算机上,它会扫描文件夹,将扫描的行复制到本地缓存中,然后针对该缓存运行 Claude 编写的 SQL 语句。文件本身永远不会离开这台计算机,任何未经 Claude 请求的内容也不会离开。
分四步完成设置
-
将代理指向文件夹
在门户网站中打开 数据 → 数据代理找到可以打开文件夹的代理,然后单击其 添加连接器 按钮下方 文件和文件夹 点击药丸 SQLite文件夹 卡片。然后,巫师会引导你完成整个过程。 文件夹, 查看, 设置, 领域 和 审查:
- 文件夹
- 输入 根文件夹每行一个路径,作为代理计算机上的路径。 扫描子文件夹 已开启, 最大深度 是 8。 包含模式 以适用于此文件类型的正确通配符开头;添加 排除模式 如果文件夹中包含您不需要的文件。映射驱动器盘符会显示琥珀色警告:代理程序无法识别它,因此请使用其他方式。
\\server\share改为走路径。 - 查看
- 代理程序读取最多 64 个文件的样本,并显示它将要构建的内容。目前尚未创建任何内容。 准备创建 这意味着每个采样文件都符合要求。琥珀色横幅“{n} 个文件(共 {m} 个文件)将被排除在外”列出了不符合要求的文件。 找出需要哪些文件以及原因您可以先创建连接器,稍后再进行修复。如果文件夹混合了不同的布局,则会显示一个蓝色面板。 切换到每个布局一张桌子.
- 设置
- 扫描间隔 (默认情况下每小时一次,从每 5 分钟一次到每天一次)是代理查找新文件、已更改文件和已消失文件的频率。 监视文件夹的更改 在本地磁盘上几秒钟内即可做出反应。 文件消失时 是 删除它的行 默认情况下。
- 领域,评论
- 选择要统计行数的“数据领域”,查看摘要并单击 创建连接器第一次扫描立即开始;连接器的 显现 该选项卡显示它构建的内容以及它保存的任何文件。
- 没有 表名 字段。成员表会变成类似这样的表。
数据事件使用 表格 用于选择要读取哪些成员表的字段。 - 包含模式 开始时
**/*.db和**/*.sqlite。 这-wal和-杂志数据库之外的文件永远不会匹配。 - 没有 表格布局 选择。注释解释说,所有匹配的文件必须采用相同的布局,如果文件布局不一致,则会被单独存放并上报。
- 在 查看代理程序最多会采样 64 个文件,并列出它将要构建的表。如果多个文件为同一列声明了不同的类型,则会显示琥珀色横幅,内容为“模式嗅探被拒绝”,并给出原因。
-
看看你能得到哪些表格
一切都位于
文件集模式。表名已为您设定:每个成员表都成为data_<name>声明的列类型必须在各个文件中保持一致。桌子 它包含什么 文件集.数据事件行 活动来自每个匹配数据库文件的表格,每个表格都带有标签源文件和_row_id.fileset.data_users其他成员表名也一样,每个名称合并一个表。 文件集.文件每行记录当前数据库中每个文件的路径、大小和修改时间。 文件集.文件事件变更历史记录,包括 拒绝和漂移列出所有不一致的文件。每个文件夹连接器都会向 Claude 提供相同的记账表,所有表都在……
文件集模式:桌子 它包含什么 文件文件夹中所有文件的路径、名称、扩展名、大小、创建时间和修改时间。问“这个文件夹里有什么?”,克劳德就会读取这些信息。 文件事件变更历史记录:每行记录一个文件的出现、修改、消失或搁置情况( 漂移),随着时间推移事件原因在于细节.目录,卷文件夹大小和数量,以及根目录所在的磁盘或共享文件夹。 源文件,_row_id每行数据包含两列:该行数据来自哪个文件,以及该文件内的一个固定行 ID。按以下方式分组 源文件比较文件。 -
联系克劳德
打开 流媒体 → 直播 → 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 没有钥匙
- 打开 查询流列表 在 Anthropic 的连接器目录中,然后点击 连接在桌面版中,它位于以下位置 + → 连接器.
- 如果您的组织隐藏了目录连接器,则可采取以下备用方案: 设置 → 连接器 → 添加自定义连接器, 姓名 查询流网址
https://mcp.querystreams.com/mcpOAuth字段为空, 添加然后在聊天中 + → 查询流 → 连接. - “查询流”选项卡随即打开。如果系统提示,请登录,选择组织,然后进行审核。 读 和 运行查询(可选) 仅限特定连接器然后点击 批准连接.
- 回到 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(一个授权方式:持有者使用相同键的标头也有效)。 -
问你的第一个问题
首先,你可以打开文件夹进行检查,看看克劳德是否找到了正确的表格。以下三个示例适用于 SQLite 数据库文件文件夹:
- “该文件夹中包含哪些 SQLite 文件?每个文件上次更改的时间是什么时候?”
- 克劳德询问
文件集.文件(运行查询)并列出每个数据库文件大小(字节)和修改后的 UTC. - “统计过去 30 天内每个文件中 fileset.data_events 表的行数。”
- Claude 读取表结构以查找日期列(读取),然后运行一个 DuckDB 操作。
按源文件分组通过您的代理(运行查询)。每个数据库文件对应一行数据。 - “是否有任何数据库文件被搁置或拒绝?为什么?”
- 克劳德询问
文件集.文件事件为了漂移和拒绝按行排序事件(运行查询)。您将从中获取文件和原因。细节.
要确认接线情况,请询问 我有哪些 Query Streams 连接器?克劳德打电话
qs_list_connectors《传送门》指南的 检查连接 步骤说 已连接以及钥匙或应用程序 连接 标签页显示了它的 上次使用 几秒钟之内即可完成。
就是这样。 将新文件放入文件夹,下次扫描后,克劳德就能从该文件中回复。这些文件从未离开过它们所在的计算机,也没有人向人工智能输入过密码。
访问网络共享上的文件
代理程序以后台服务的形式打开文件,而不是以用户身份打开,因此打开另一台计算机上的文件需要额外的步骤。具体步骤取决于代理程序运行所在的计算机。
如果测试无法获取份额,请在测试结果中查找以下词语: 无法连接 这意味着代理的计算机没有收到服务器的响应。在 Linux 或 Mac 系统上, 未安装 这意味着还需要挂载共享文件夹,并且该消息包含了适用于您服务器的确切挂载命令。
共享文件夹? 在 Windows 系统中,一个登录账号即可管理从同一服务器添加的所有文件夹。 监视文件夹的更改 它也适用于共享文件夹,但会尽力而为;计划扫描可以保证检测到每一次更改。
新建、更改和删除的文件如何显示
新增和已更改的文件
在每个 扫描间隔 代理程序会将每个文件的大小和修改时间与其账本进行比较。符合条件的新文件会被添加进去;已更改的文件会被重新读取整个记录,因此一个表中永远不会包含同一个文件的两个版本。开启 监视文件夹的更改 在本地磁盘上几秒钟内做出反应。
已删除的文件
除非您选择删除,否则文件消失时,其所有行都会丢失。 保留行,标记已删除如果共享离线且大多数文件同时消失,代理程序会保留最后有效的清单,而不是删除所有内容。
预留文件
不符合布局、无法打开或被锁定的文件将被搁置:其所有行均不会加载。 文件事件 记录是哪个文件以及原因。下次文件更改时会自动重试。没有“重新扫描”按钮。
克劳德所看到的
数据截至上次扫描。由于没有 MCP 工具触发扫描,因此请询问“上次更新时间是什么时候?”,Claude 会读取最新数据。 事件 在 文件事件 为你。
克劳德连接后能做什么
您的AI客户端会识别查询流工具;它会根据您的问题选择合适的工具。门户网站的 工具 标签 列出所有工具和模式,以及你的套餐包含的内容。Query Streams 会让你的 AI 客户端在查询前读取每个表的列信息,这样它就会使用真实名称,而不是猜测。所有套餐(包括 Free)均可使用:
绘制您的数据
连接器、数据库和代理;语义智能运行后,SQLite 文件夹文件中的表和列及其描述、示例值和连接。
个人资料和探索
在按列筛选之前分析该列;发现无人声明的联接。实时运行需要 Analyze。
运行只读 SQL
使用正确的 SQLite 方言执行 SELECT 查询,默认耗时 60 秒,最长 5 分钟。您的查询计划决定了单个查询返回的最大行数。(运行查询)
已保存的查询、联合查询和警报
使用新值运行团队信任的已保存查询;联合查询返回的已连接状态。阅读告警规则并草拟一个作为演练。
分析工具集。 付费方案中,代理程序会完成 SQLite 文件夹文件所在的底层工作,这样您的 AI 客户端就可以专注于计算。免费方案的功能与以往相同。
默认值存在于 语境 标签:文本单元格限制、架构视图、结果大小、分析默认值和保留结果。
如果您希望在 AI 客户端的回复中识别工具名称,请提供这些名称。
| 允许 | 工具 |
|---|---|
| 读 | qs_list_organizations qs_list_agents qs_list_connectors qs_get_si_status qs_get_connector_schema qs_find_tables qs_get_table_schema qs_get_relationships qs_profile_table qs_discover_relationships qs_list_saved_queries qs_alerts qs_result (op=windows) |
| 分析 | qs_request_si_analysis qs_setup_si qs_get_task_status,仅列出具有 Analyze 权限的密钥;实时运行 qs_profile_table 和 qs_discover_relationships |
| 运行查询 | qs_run_query qs_run_saved_query qs_data_freshness qs_result (所有其他 op) qs_result_release qs_create_alert_rule (仅提出) |
为什么语义智能在这里很重要
Claude 收到的每个答案都会被标记出该结构来自哪里,Claude 会根据标记调整它对所看到内容的信任程度。
| 层级 | 克劳德所看到的 | 结果 |
|---|---|---|
| 语义智能 | 每个表和列的描述、示例值、枚举含义、已声明和已发现的连接。 | Claude 第一次就编写出了正确的 SQLite 文件夹 SQL 语句,并用您的业务术语解释了数据。 |
| 捕获的模式 | 表名和列名、类型、键。 | 克劳德会工作,但他会从名字中推断含义,并可能会提出后续问题。 |
| 实时架构 | 数据库不在连接器的捕获选择范围内,因此每次请求都会实时读取其结构(需要运行查询权限;支持 SQL Server、MySQL 和 PostgreSQL)。 | 查询仍在运行。当需要更多信息时,Claude 会使用较小的 SELECT 语句进行探索。 |
如果数据库很重要,请对其运行一次语义智能分析。 新星 → 智能。 这 连接 该选项卡显示每个连接器的覆盖范围面板。 语义智能的工作原理.
这些计划允许什么?
MCP 包含在所有套餐中,包括免费套餐,无需额外付费。每个套餐的具体规定是您可以持有的密钥或已连接应用的数量,以及您的 AI 客户端每分钟可以发起的呼叫次数:
| 计划 | 每个用户的密钥 | 每个组织的密钥 | 每分钟通话次数 |
|---|---|---|---|
| 免费 | 1 | 1 | 30 |
| 个人核心 | 1 | 1 | 60 |
| 个人加强版 | 1 | 1 | 90 |
| 核心业务 | 2 | 3 | 120 |
| 商务+ | 3 | 5 | 150 |
| 商业最大 | 5 | 10 | 240 |
| 企业核心 | 5 | 25 | 300 |
| 企业增强版 | 8 | 50 | 450 |
| 企业版 Max | 10 | 100 | 600 |
已连接的应用算作一个键。除了每分钟的限制外,任何一个键每分钟最多可以运行 10 次查询。查询运行时间最长为 60 秒,除非您的 AI 客户端请求更长的运行时间(最长 5 分钟)。您的计划还会设置每次查询返回的行数,以及(使用分析工具集)保留结果的时长和大小; 完整的MCP指南 列出每个计划。AI 客户端接收的内容会计入您的 Data Realm 配额,与 Excel 和 Sheets 查询使用同一额度池:AI 代理 (MCP) 用量会统计发送给 AI 客户端的每一个字节,包括结果、架构读取和暂存结果页面,且统计发生在客户端协商的任何传输压缩之前;而电子表格查询统计的是 Network Agent 发送的压缩结果。从 AI 客户端启动的 Semantic Intelligence 运行会消耗 Nova AI 积分,与从 Portal 启动时完全相同。 请查看定价页面 津贴。
确保安全
只读,由代理人检查
仅执行 SELECT 语句。检查在运行代理的计算机上进行,在您的 SQLite 文件夹文件读取 SQL 之前完成,因此您的 AI 客户端写入的任何内容都不会更改数据。
没有人工智能方面的资质
SQLite 文件夹登录信息保留在代理上。Claude 持有查询流密钥或连接,您可以从 MCP 页面撤销该密钥或连接;更改将在大约五分钟内生效。
所有信息均已记录
每次工具调用都会显示在 MCP 上。 活动 选项卡和查询历史记录中的每个查询都会以客户端类型 MCP 的形式记录,并归属于发出该查询的密钥或连接的用户。SQL 文本和密钥本身永远不会写入活动日志。
人工智能提供商收到的内容
表名和列名、语义智能描述(包括示例值)以及您请求的查询行。使用分析工具集时,通常会获得大小估算、配置文件或暂存结果,而完整结果则保留在代理端。根据其条款,获取到的信息将发送给您连接的 AI 提供商。查询流永远不会看到您的聊天记录。
下一步行动不错。
- 运行语义智能 在连接器上,以便 Claude 可以看到您自己的专栏描述。
- 请克劳德比较文件。 每行承载
源文件因此,只需一次查询即可对所有数据库进行排名或比较。 - 请阅读 SQLite 文件夹指南 在 合并多个 SQLite 数据库文件 适用于各种场景。
当某些事情不起作用时
| 你所看到的 | 它的含义 | 使固定 |
|---|---|---|
| 您的 AI 客户端未显示任何查询流工具 | 连接器已添加但从未连接,或者密钥粘贴到了错误的位置。 | 在克劳德身上: + → 查询流 → 连接在开发者工具中:重启它,然后使用 检查连接 在 Portal 指南中。 |
MCP_KEY_REQUIRED 或 401 | 服务器未收到密钥,通常是由于复制粘贴时多出的换行符,或者密钥位于错误的标头中。 | 从“连接”选项卡中再次复制密钥并将其发送。 X-MCP-Key 标题。 |
MCP_USER_DISABLED | 管理员已为您用户关闭了 MCP 功能。 | 请他们转身 MCP 重新打开 账户 → 访问控制. |
MCP_SCOPE_REQUIRED 或 MCP_SCOPE_DENIED | 密钥或连接缺少执行该操作(通常是运行查询)的权限。 | 在“连接”选项卡上编辑密钥并勾选 运行查询或者重新连接应用程序并批准它。 |
MCP_KEY_ORG_LIMIT_EXCEEDED | 您的套餐密钥数量已用完。免费套餐的密钥数量上限为一个密钥或一个已连接的应用。 | 取消不再使用的套餐,或者升级到更高级别的套餐。 |
MCP_AGENT_NOT_CONNECTED 或 MCP_AGENT_NOT_REGISTERED | 拥有您的 SQLite 文件夹文件的代理目前未连接。 | 打开 数据 → 数据代理 并在其计算机上启动代理。 |
MCP_DATABASE_NOT_CAPTURED | 数据库位于连接器捕获选择范围之外,因此没有为其存储任何模式或语义智能。查询仍然有效。 | 将其添加到连接器上的捕获选择中,然后运行语义智能(如果您想要更丰富的答案)。 |
MCP_RATE_LIMITED | 您的套餐每分钟调用次数过多,或者对一个键每分钟执行超过 10 次查询。 | 稍等片刻。语义智能可以让克劳德用更少的电话就能接听电话。 |
MCP_QUERY_TIMEOUT 或 MCP_OUTPUT_TOO_LARGE | 查询超时或返回的内容超过了您的 AI 客户端一次可以接收的数量。 | 要求减少行数或列数,或者添加日期筛选条件。对于支持上下文管理的套餐,请先要求其调整结果大小。 |
MCP_DATA_REALM_EXHAUSTED | 您所在组织在该期间的数据流量已用完。 | 等待余额重置或通过门户网站充值。 |
MCP_FEATURE_NOT_INCLUDED | 您的方案不包含上下文管理、结果分析或深度分析,或者该工具已针对此密钥或组织关闭。 | 请您的 AI 客户继续使用该工具,升级到更高级别的方案,或者请管理员启用该工具。 |
MCP_RESULT_EXPIRED | 已保存的结果不再保存:它已过期、已被释放(有时会提前释放,以便为更新的结果腾出空间)或代理已重新启动。 | 请让您的 AI 客户端再次运行查询,并保持运行状态。 |
MCP_WINDOW_BUDGET | 代理目前无法保存如此大的结果,或者后续操作需要的内存超过了其允许的范围。 | 释放保留的结果,或者使用筛选器或减少列数来缩小查询范围。 |
MCP_AGENT_ANALYSIS_DISABLED | 该代理或连接器已关闭结果保留和分析功能。 | 请管理员开启 局部分析 在数据代理页面上,或者允许对连接器进行分析。 |
MCP_WINDOW_SQL_REJECTED | 后续操作不是对已保存的结果执行只读 SELECT 操作,也不是对结果中不存在的列进行命名。 | 使用列名对该结果执行一次 SELECT 查询。 |
MCP_AGENT_VERSION_TOO_OLD | 代理程序需要更新才能塑造、分析、保存或分析结果。 | 更新代理 数据 → 数据代理;与此同时,普通查询仍然有效。 |
| 只读违规 | 这条 SQL 语句不是 SELECT 语句。 | 这是设计使然。没有任何数据会通过 MCP 写入。 |
人们提出的问题
查询流会更改我的 SQLite 文件吗?
不。每个文件都是以只读方式打开的,而且 -wal 和 -杂志 文件始终无法匹配。Claude 可以读取合并后的表格,但无法更改您的文件或连接器。被其他程序锁定的文件会被暂时搁置,并在文件更改后重试。
如果两个文件对同一列声明了不同的类型怎么办?
如果抽样文件不一致,代理程序会指出该文件,并且不会构建任何表格,直到您修复或排除该文件为止。它会在每次同步时再次检查。之后添加的不符合固定布局的文件会被暂时搁置,而其他文件仍会加载。
新的或更新的数据库文件多久会显示出来?
下一次扫描后,默认情况下每小时扫描一次。 扫描间隔如果文件大小允许,则会添加新文件的行。更改后的文件会被重新读取整个文件,因此会替换旧行而不是重复写入。
克劳德会阅读我的文件吗?
不。代理程序在自己的计算机上读取数据,并将读取到的行保存在本地缓存中。Claude 向查询流发送 SQL 语句,代理程序针对缓存运行该语句,只有查询所需的行才会被返回。Claude 从不打开文件,也无法更改、移动或删除任何文件。
我需要开放端口还是运行 VPN?
不。代理程序会在 443 端口上建立一个出站连接,所有请求和数据行都会通过该连接传输。如果出站 HTTPS 连接正常,那么这种方式也正常。
文件夹可以位于网络共享上,或者位于 OneDrive 或 Dropbox 中吗?
只要代理人的电脑能打开,共享文件就能正常工作;输入方式如下: \\服务器\共享\文件夹因为代理程序以服务形式运行,无法看到您登录时映射的驱动器。在 Windows 系统中,请从文件夹的“设置”中添加共享登录信息。 凭据 如果共享文件夹仅允许指定人员访问,请在此处填写相关信息;在 Linux 或 Mac 系统上,请先挂载共享文件夹(此处不使用已保存的登录信息)。对于同步的云文件夹,请将其设置为将文件保留在此设备上;代理程序会跳过云端占位符文件。
免费套餐真的包含这些吗?
是的。“免费”套餐是永久有效的,不是会过期的试用期。所有套餐都包含 MCP;“免费”套餐允许使用一个密钥或一个已连接的应用,每分钟最多可拨打 30 个电话。文件夹连接器本身没有文件数量限制。请查看“免费”套餐包含的具体内容。 定价页面.
除了 Claude 之外,还有哪些 AI 工具可用?
任何通过 HTTP 使用 MCP 协议的程序:ChatGPT、Cursor、带有 Copilot 的 VS Code、Visual Studio、OpenAI Codex CLI、Gemini CLI、Windsurf、Zed、Cline、Continue.dev 和 JetBrains AI,在 Portal 的“连接 AI 客户端”指南中都有现成的方案。
相关指南
每份指南 SQLite Folder
这不是你想要的配置?
- 只有一个 SQLite 文件?SQLite 连接器会直接打开该文件,并保留其表名不变 → SQLite
- 只需要文件列表,包括文件大小、日期和更改记录?文件系统无需读取文件即可完成此操作 → File System
设置有问题吗?
- 代理提示文件或文件夹不存在,或访问被拒绝?映射驱动器、网络共享、OneDrive 和 Linux 用户主文件夹都需要修复 → 代理程序可以从哪里读取文件
- 代理显示离线,或者“测试连接”和“浏览”按钮呈灰色?请检查代理是否在线 → 经纪人在线吗?


