使用 MCP 将 JSON 应用程序日志连接到 Claude

MCP · 应用程序日志发送给 Claude

问 克劳德 关于您的应用程序日志文件， 用通俗易懂的英语

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

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

你最终会得到什么

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

Claude · 已连接到查询流 只读

过去一小时内最常见的错误是什么？是哪个日志记录器抛出了这些错误？

qs_get_table_schema qs_run_query 模式智能

克劳德检查了以下各列： 文件集.事件然后它运行一个查询，该查询会保留错误和致命错误。 等级 过去一小时的数值 事件时间 并按以下方式对它们进行分组 日志记录器 和 信息前三名：

等级	日志记录器	信息
错误	支付.Stripe客户端	付款失败：订单 88213 的信用卡被拒付
错误	订单服务	调用 inventory-svc 超时，超时时间为 30000 毫秒。
致命的	db.pool	连接池已满（最多 20 个连接）

耗尽的池子可以解释 OrderService 中的超时问题。请向 Claude 索取致命事件的完整消息和堆栈跟踪。由于跟踪信息始终与该事件关联，因此读取的是同一行。答案涵盖了 Agent 在上次扫描时读取到的内容。

本周的付款失败原因分析如下：是客户的问题还是我们的问题？

qs_run_query qs_run_query

我从中解析出了拒绝原因。 信息 为了 支付.Stripe客户端 错误 文件集.事件 与上周相比：

拒绝理由	数数	共享	与上周相比
卡片已拒绝	1,204	62%	+2%
资金不足	402	21%	-1%
api_timeout	331	17%	+310%

前两个是顾客，而且是平面的。 api_timeout 就是我们：两周前它还不存在，每个人都来自这里 主机 = web-03同时，web-03 的日志也显示在同一时刻存在 30 秒的延迟。问题出在一家不正常的服务器，而不是支付服务提供商。

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

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

应用程序日志读取应用程序写入的 JSON 和文本日志文件，包括 ECS、Serilog、pino 或 Bunyan 的 JSON 日志以及纯文本日志。它将每个事件转换为包含级别、记录器和消息的 SQL 行，并将堆栈跟踪信息保留在生成该事件的事件中。代理程序会跟踪每个文件的增长情况，识别轮换文件以避免重复读取。 .gz 存档一次，首次读取时回填最近 30 天的数据。

你需要准备什么

查询流帐户

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

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

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

MCP 已为您开启

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

人工智能客户

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

分四步完成设置

1. 将代理指向文件夹

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

   文件夹

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

   查看

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

   设置

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

   领域，评论

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

   • 将应用程序日志文件夹添加到以下位置 根文件夹.
   • 选择一个 日志类型该卡提供 JSON 行（ECS、Serilog、pino 和 Bunyan）、包含级别、日志记录器和消息的纯文本，以及 dpkg 和 apt 历史记录。 主持人 作为标识列。
   • 表名 是可选的，默认为 活动. 事件保留 N 天 除非你另行设置，否则所有设置都将保留。
   • 在 查看代理程序读取样本并显示文件数量、大小、行数预估以及将要构建的表。此时尚未创建任何内容。如果文件类型与您选择的类型不符，则会显示标题： 这些文件并非 然后是那种类型，并说明原因。

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

   解析后的事件落在 文件集.事件或在 表名 您已选择。代理程序会将这些行保存在代理程序计算机的本地缓存中，并以 SQL 的形式提供它们。每一行都说明它来自哪个文件。 源文件以下各列来自默认的 JSON 行日志类型。

   桌子	它包含什么
   活动	每个事件一行： 事件时间, 应用程序, 等级, 日志记录器 和 信息加上 主持人, 服务, 溪流 和 数据多行堆栈跟踪信息保留在其事件中。
   events_raw_lines	未解析的行，保留在 线 与一个 原因长度超过限制的方块会落在这里。 记录最大行数没有东西掉下来。
   文件	目前文件夹中的所有日志文件， 相对路径, 大小（字节） 和 修改后的 UTC.
   文件事件	每个文件的历史记录： 出现, 修改的, 旋转, 截断 和 漂移 行，按时间 事件.
   日志游标	每个文件的读取位置和状态。已搁置的文件显示状态 停放 原因如下 最后一个错误.

   每个文件夹连接器都会向 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. 问你的第一个问题

   先从你可以打开文件夹查看的内容开始，这样你就能看到克劳德伸手去拿正确的桌子。以下三个示例非常适合你的应用程序日志文件：

   “您正在读取哪些应用程序日志文件？每个文件有多大？”

   克劳德询问 文件集.文件 为了 相对路径, 大小（字节） 和 修改后的 UTC.

   “过去一小时内，每个应用程序按级别记录了多少错误？”

   克劳德集团 文件集.事件 经过 应用程序 和 等级，已筛选 事件时间.

   “哪些代码行无法解析，原因是什么？”

   克劳德在读 fileset.events_raw_lines 并按以下方式对行进行分组 原因并举几个例子。

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

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

克劳德连接后能做什么

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

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

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

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

这些计划允许什么？

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

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

确保安全

下一步行动不错。

• 开启“监视文件夹更改”（近乎实时）功能 在本地磁盘上，几秒钟内即可读取新行。定时扫描仍是保证。
• 设置保留事件 N 天 控制缓存中保留多少历史记录。除非您另行设置，否则应用程序日志会保留所有历史记录。
• 使用自定义日志文件夹 如果您的格式不符合要求 日志类型 列表。您可以自行描述格式，或者提交支持请求，我们会在几天内添加。

当某些事情不起作用时

人们提出的问题

相关指南

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