将查询流连接到 Claude，即可用通俗易懂的语言询问有关数据库的问题。Claude 会读取您的模式、已保存的查询以及您的 语义智能 该模型实时运行，通过您的网络代理执行只读 SQL，并且永远不会接触到数据库密码。您的 AI 客户端发出请求；网络代理（其在网络内部的合作伙伴）负责处理数据存储处的繁重工作。本指南涵盖 claude.ai、Claude Desktop、ChatGPT 和 Claude Code，以及所有其他 MCP 客户端。
简短版本。 安装 网络代理 只需几分钟，即可在数据库旁边添加连接器。然后打开 查询流列表 在 Anthropic 的连接器目录中，点击 连接在“查询流”同意屏幕上批准权限，并询问克劳德。 “我可以访问哪些数据库？” Claude 只能看到 Agent 提供的数据：跳过 Agent，它会告诉你没有连接器。
开始之前
你需要四样东西。如果你在 Claude 中找到了查询流，那么你还需要设置代理和连接器。
包含 MCP 的计划
MCP 包含在所有套餐中，包括免费套餐。您的套餐会决定您可以持有的密钥或已连接应用的数量、AI 客户端每分钟可以发起的调用次数、单个查询返回的行数，以及是否包含分析工具集。 每个计划包含哪些内容？.
在线的网络代理
代理程序是一个小型服务，它位于数据库旁边，并向 Query Streams 发起一个出站连接。新帐户？立即安装！ my.querystreams.com/下载几分钟后 Windows, macOS 或 Linux如果您的团队已经在门户网站、Excel 或 Google Sheets 中运行查询，则该功能已安装。
至少一个连接器
连接器是指在门户网站中注册的数据库或 API 源。根据您授予的权限，Claude 可以看到您帐户可以访问的所有连接器。
用户 MCP 访问权限
组织创建者和所有者自动拥有 MCP 访问权限。其他用户需要管理员勾选才能获得访问权限。 MCP 在他们名字旁边 账户 → 访问控制.
工作原理
Claude 不会直接连接到您的数据库。它与我们云端的 Query Streams MCP 服务器通信，该服务器会通过您的网络代理已建立的唯一出站连接转发每个请求。代理在本地运行查询，并以相同的方式将结果流式传输回本地。请求和结果通过代理发起的单一通道双向传输，因此无需在您的防火墙上进行任何设置。
OAuth、权限范围、审计、速率限制
一个出站 TLS 连接
该设计衍生出三个特性：
- 克劳德没有相关资质。 您的数据库连接字符串存储在代理程序中。Claude 仅持有 OAuth 授权或 MCP 密钥，您可以通过门户网站一键撤销这两项授权。
- 只读，由代理强制执行。 仅有的
选择,和和解释声明已被接受。检查在您这边的连接中进行，而不是在云端或 Claude 中。 - 所有信息都会被记录。 每个工具调用都会显示在 MCP 页面上。 活动 选项卡和查询历史记录中的每个查询，都归因于连接的用户。
连接您的AI客户端
门户网站中的 MCP 页面（流媒体 → 直播 → MCP) 有四个标签页： 连接, 语境, 工具 对于管理员而言， 活动关于连接， 连接人工智能客户端 点击按钮将打开一个四步指南： 您的AI客户端将如何连接？, 选择你的AI客户端, 设置好它 和 检查连接有两种方式可以进入系统。聊天应用通过应用内验证，无需密钥。开发者工具则使用 MCP 密钥。两者都连接到同一服务器并使用相同的工具。
方案A：claude.ai、Claude Desktop和ChatGPT（通过应用程序批准，无需密钥）
已列入人类连接器名录。 Query Streams 是一个经过认证的连接器： claude.ai/directory/query-streams打开列表，点击 连接 并予以批准；无需服务器 URL。对于限制目录连接器的 Claude 组织，通过 URL 添加是备用方案。
- 打开 查询流列表 并点击 连接该连接器会同步到您的 Claude 帐户，因此 Claude Desktop 会将其显示出来。 + → 连接器. 看不到房源信息？ 您的组织可能会限制目录连接器：在 设置 → 连接器 点击 添加自定义连接器给它命名 查询流， 粘贴
https://mcp.querystreams.com/mcp然后在聊天中点击 +， 选择 查询流 并点击 连接. - 一个新的浏览器标签页将打开 Query Streams 的同意页面。如果系统提示，请登录；选择组织；查看权限（见下文）；然后点击。 批准连接.
- 回到克劳德那里你就会明白了。 已连接到查询流克劳德第一次使用某个工具时，它会请求权限。请选择 始终允许 这样它就可以在每次通话时无需提示即可工作。
该连接器与您的 Claude 帐户关联，而非与特定设备关联，因此它会自动出现在 Claude 移动应用和 Claude 桌面版中。您可以随时通过门户网站管理或撤销该连接器。 MCP → 连接 标签。
ChatGPT。 从应用本身添加查询流：目前这意味着在 ChatGPT 的设置中启用开发者模式并在那里创建连接，然后点击 使用 Query Streams 登录 并在同一同意屏幕上进行批准。门户网站指南展示了当前的 ChatGPT 步骤；官方的 ChatGPT 列表即将发布。
与“添加市场”不同。 在 Claude Desktop 中，聊天功能 + → 浏览连接器 → 添加市场 该选项需要插件市场的 Git 仓库地址，而不是 MCP 服务器 URL。请使用列表的 URL。 连接 按钮，或 设置 → 连接器 → 添加 针对 URL 路由。
选项 B：Claude 代码、光标和其他开发者工具（MCP 密钥）
开发者工具使用您在门户中生成并传递的密钥进行身份验证。 X-MCP-Key 标题。
- 登录 my.querystreams.com， 打开 MCP 并点击 连接人工智能客户端。 选择 在配置文件中使用密钥 选择你的工具。
- 点击 生成密钥 你的工具。用工具和机器的名称来命名，例如 克劳德代码笔记本电脑， 保持 读 和 运行查询并选择过期时间。之后您可以从此处再次显示并复制密钥。 连接 制表符。按键看起来像
qsmcp_接下来是 43 个字符。 - 设置好它 显示 Cursor、VS Code、Windsurf、Zed、JetBrains、Gemini CLI、Codex CLI、Continue、Cline 等工具的即用型配置，其中已预先填充了您的密钥。对于 Claude Code，只需一条命令：
claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp --header "X-MCP-Key: qsmcp_PASTE_KEY_HERE" - 检查连接 等待来自该密钥的第一个呼叫并说 已连接.
如需随时核实，请咨询 我有哪些 Query Streams 连接器？ 客户应该打电话 qs_list_connectors以及关键的 上次使用 “连接”选项卡上的时间会在几秒钟内更新。
权限
无论您是通过 OAuth 还是密钥连接，访问权限都由三个权限范围控制。授权屏幕会显示这些权限范围；密钥也是根据这些权限范围创建的。
| 范围 | 克劳德能做什么 | 何时授予 |
|---|---|---|
| 读 | 列出连接器和代理，浏览架构，读取 Semantic Intelligence 说明以及已存储的列配置文件和关系，列出已保存的查询和警报规则。 | 一直如此。其他一切都以此为基础。 |
| 分析 | 在 Network Agent 上实时分析表或发现隐式关系，并将 Semantic Intelligence 运行加入队列。没有它，你的 AI 客户端就看不到用于启动 Semantic Intelligence 运行的工具。 | 推荐。这可以让 Claude 在编写连接语句之前了解数据的结构。 |
| 执行 | 如下所示 运行查询（只读）运行只读 SQL 和已保存的查询，并将行流式传输回来；保留结果并对其运行后续和分析工具。 | 仅供浏览结构的用户查看，以便获取答案。如果仅用于浏览，请将其关闭。 |
您可以批准将已连接的应用限制为仅对特定连接器可用；生成的密钥将发送给组织内的所有连接器。撤销授权或密钥将在大约五分钟内生效。管理员可以在“连接”选项卡上查看组织内所有有效的授权和密钥。
连接后，您的AI客户端可以执行哪些操作？
您的AI客户端会识别查询流工具，并根据您的问题选择合适的工具；您无需亲自调用它们。门户网站的 工具选项卡 列出所有工具和模式、每项的功能，以及你的套餐包含哪些内容。
对于有关数据的问题，Query Streams 会引导你的 AI 客户端完成四个步骤：列出连接器、读取数据库的表、读取将要查询的每个表的列，然后运行只读查询。先读取列信息，才能避免它猜测名称。所有套餐均包含此功能，包括 Free：
绘制您的数据
列出连接器、数据库和代理。读取任何数据库的模式树，包括表和列描述、语义类型、示例值、枚举标签以及已声明和已发现的关系。
个人资料和探索
在编写筛选器之前，先分析表结构以查看实际值分布。发现未声明外键的表之间的连接。
运行只读 SQL
使用连接器对应的方言编写并运行只读 SQL。默认超时时间为 60 秒，最长可达 5 分钟；查询计划决定了单个查询返回的行数。
已保存的查询、联合查询和警报
使用新值运行组织已保存的参数化查询；跨多个数据源的联合查询将自动返回已连接的数据。读取告警规则及其最近的触发记录，并在试运行模式下提出新规则。
分析工具集
付费方案中，网络代理会在您的数据所在位置完成基础工作：它会测量、分析、存储和分析结果，因此您的 AI 客户端在回答每个问题时都已预先准备好上下文，从而可以将注意力集中在思考上。免费方案的功能与以往相同，提供标准结果。完整操作指南请参见[此处]。 使用您的人工智能客户端分析您的数据.
你始终掌控着局面。 这 上下文选项卡 设置默认值：文本单元格限制、大型数据库的架构视图、结果大小和分析默认值，并显示您的 AI 客户端接收到的内容。它还会列出每个代理持有的结果。每个键都可以覆盖默认值，每次调用都会显示在“活动”选项卡上，管理员可以启用此功能。 局部分析 为一名代理人工作 数据 → 数据代理.
您的计划包含哪些内容？
MCP 包含在所有套餐中，包括免费套餐，而且免费套餐永不过期。
| 计划 | 每个用户的密钥 | 每个组织的密钥 | 每分钟通话次数 | 每次查询的行数 | 分析工具集 | 结果维持不变 |
|---|---|---|---|---|---|---|
| 免费 | 1 | 1 | 30 | 1,000 | 标准结果 | 没有任何 |
| 个人核心 | 1 | 1 | 60 | 2,500 | 情境管理，结果分析 | 15分钟，128MB |
| 个人加强版 | 1 | 1 | 90 | 5,000 | 情境管理，结果分析 | 15分钟，128MB |
| 核心业务 | 2 | 3 | 120 | 10,000 | 情境管理、结果分析、深度分析 | 60分钟，512MB |
| 商务+ | 3 | 5 | 150 | 25,000 | 这三个 | 60分钟，512MB |
| 商业最大 | 5 | 10 | 240 | 50,000 | 这三个 | 60分钟，512MB |
| 企业核心 | 5 | 25 | 300 | 100,000 | 这三个 | 8 小时，4,096 MB |
| 企业增强版 | 8 | 50 | 450 | 100,000 | 这三个 | 8 小时，4,096 MB |
| 企业版 Max | 10 | 100 | 600 | 100,000 | 这三个 | 8 小时，4,096 MB |
已连接的应用算作一个密钥。在每个计划中，任何一个密钥每分钟最多运行 10 次查询。每次查询的行数是指单个查询返回给 AI 客户端的最大行数；请求更多行数将返回计划的限制并明确告知，不会报错。保留的结果将用于后续查询，保留时间不超过计划的时间和大小限制，且在代理计算机的可用资源范围内。所有计划并排显示： 定价.
为什么语义智能在这里很重要
Claude 收到的每一个回复都会被标记出它来自三个层级中的哪一个，Claude 会根据标记调整它对所看到内容的信任程度。
| 层级 | 克劳德所看到的 | 结果 |
|---|---|---|
| 语义智能 | 每个表和列的描述、语义类型、枚举标签、示例值、事实和维度分类、已声明和已发现的连接。 | Claude 第一次就能编写出高质量的生产级 SQL 代码，并且能够用您的业务术语解释数据。 |
| 捕获的模式 | 表名和列名、类型、主键、索引、已声明的外键。 | 克劳德可以工作，但他需要从名字中推断含义，可能需要后续提问。 |
| 实时架构 | 数据库不在连接器的捕获选择中，因此结构是在每个请求时从目录中实时读取的。 | 查询仍在运行。当需要更多信息时，Claude 会使用示例查询进行探索。 |
如果某个数据库对你的团队至关重要，那么只需对其运行一次语义智能分析即可。对于大型数据库，请将分析范围限定在查询实际使用的表上。 语义智能的工作原理 →
示例提示
先从你已经知道答案的问题入手，然后再提出后续问题；克劳德会保留上下文。
我可以访问哪些数据库和表格？其中哪些具有语义智能？绘制连接图，并告诉你哪些地方最有可能找到答案。 请向我展示客户与销售数据库中的订单之间的关系，并分析订单状态列。利用关系和列分析。克劳德会向您展示实际的状态代码及其含义。 运行已保存的查询“按地区划分的月度收入”，查询今年第二季度的数据。运行带有参数的已保存的可信查询，而不是自行创建 SQL。 列出过去90天内收入排名前10的产品。然后按渠道细分。使用连接器方言执行临时 SQL，然后在同一线程上进行后续查询。对于启用结果分析的计划，后续查询可以从已保留的结果中获取，无需执行第二次查询。 已配置哪些警报规则？本周是否有任何警报规则触发？读取警报规则及其最新状态。提升答案质量的技巧
- 使用 Claude 项目。 将 Query Streams 连接器附加到项目，并在项目说明中添加业务规则：例如默认使用的数据库、哪些已保存的查询是官方定义以及命名约定。Claude 仍然会实时读取模式，因此说明可以保持简洁。
- 保存您认为规范的查询语句。 Claude 首先会查找已保存的查询，所以“活跃客户”的含义与你们团队的定义一致。
- 授予分析范围。 在对某一列进行筛选之前先对其进行分析，这就像是猜测状态码和使用正确状态码之间的区别。
- 索取一张图表。 claude.ai 根据 Claude 返回的行渲染图表。
成本
MCP本身在任何套餐中均不收取额外费用。只有两项服务会按流量计费：
- 数据量。 返回给 Claude 的查询结果会计入 Excel、Google Sheets、Portal 和 Nova 使用量共用的同一数据域额度。通过 MCP 传输时，按发送给 Claude 的每个字节计量——包括结果、架构读取和暂存结果页，且在任何传输压缩之前计量——因为 AI 客户端接收的是未压缩数据；电子表格、Portal 和 API 结果则按 Network Agent 发送的压缩结果计量。失败的回复不计入额度。尽量简化探索性问题；对于支持 Context management 的套餐，先让 Claude 估算结果大小（mode: shape），可避免拉取它不需要的行。
- 语义智能运行中。 通过 Claude 提交分析请求会像通过 Portal 运行分析请求一样，向您的组织收取 AI 积分。Claude 会在收取积分前征求您的意见。
故障排除
| 你所看到的 | 它的含义 | 使固定 |
|---|---|---|
| 克劳德说没有连接器，或者说没有网络代理。 | 您的帐户尚未运行任何代理，或者代理尚未添加数据源。 | 从此处安装代理 my.querystreams.com/下载在下方添加连接器 数据 → 数据代理 → 添加连接器然后再次询问。 |
| Claude 没有显示任何查询流工具 | 连接器已添加但未通过聊天连接，或者 OAuth 授权从未完成。 | 打开聊天窗口，点击 +选择查询流， 连接并完成同意屏幕。 |
MCP_KEY_REQUIRED 或 401 | 服务器未收到密钥或授权信息。对于密钥客户端而言，这通常是复制粘贴错误，例如末尾多了一个换行符，或者密钥位于错误的标头中。 | 将密钥重新复制到 X-MCP-Key 标题。对于 claude.ai，请从“+”菜单重新连接。 |
MCP_TOKEN_EXPIRED | OAuth令牌在闲置一段时间后已过期。 | Claude通常会自动刷新。如果未刷新，请断开连接器并重新连接。 |
MCP_KEY_REVOKED 或 MCP_USER_DISABLED | 密钥已被撤销，或者您的用户 MCP 访问权限已被关闭。 | 生成新密钥，或请管理员重新启用 MCP。 账户 → 访问控制. |
MCP_SCOPE_REQUIRED | 授权或密钥缺乏采取该行动的权限，这种情况最为常见。 执行 （运行查询）。 | 重新连接并批准缺失的范围，或者生成包含该范围的密钥。 |
MCP_PLAN_LAPSED | 贵组织的订阅已过期。 | 门户网站中的 MCP 页面显示了当前计划状态和未来方向。 |
MCP_AGENT_NOT_CONNECTED | 拥有该连接器的网络代理目前未连接。 | 查看 数据代理 在门户网站上，在其主机上启动代理服务。 |
MCP_CONNECTOR_NOT_ALLOWED | 该联网应用程序获批时仅限于特定连接器，而此连接器不在其中。 | 重新连接应用程序，并在“查询流”同意屏幕上批准更广泛的访问权限。 |
MCP_DATABASE_NOT_CAPTURED | 数据库不在连接器的模式捕获选择范围内，因此没有语义智能或已存储的关系可供读取。查询仍然有效。 | 将数据库添加到门户连接器的捕获选择中，然后（可选）运行语义智能。 |
MCP_RATE_LIMITED | 您的套餐每分钟通话次数过多。 | 稍等片刻。语义智能可以有效应对高强度会话，让 Claude 用更少的呼叫次数就能接听电话。 |
MCP_QUERY_TIMEOUT | 查询超时，默认值为 60 秒。 | 请克劳德添加筛选条件或降低行数限制，或提高 超时秒数 最多 300。 |
MCP_OUTPUT_TOO_LARGE | 结果太大，无法一次性回复给您的人工智能客户端。 | 要求减少列数或行数。对于启用了上下文管理功能的方案，请先请求其确定结果的大小。 |
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 | 代理程序需要更新才能塑造、分析、保存或分析结果。 | 更新代理 数据 → 数据代理与此同时，普通查询仍然有效。 |
| 查询因列名或表名而失败 | 你的 AI 客户端猜测了名称，而没有先读取表。 | 通常不会有什么影响。它收到的错误会列出该表的实际列，或名称相似的表，因此它可以在下次尝试时更正查询。如果它一直猜测，请让它先读取表的列。 |
| 只读违规 | SQL 中包含的内容并非 选择, 和 或 解释. | 这是设计使然。MCP 永远不会接受写入操作。 |
仍然遇到问题？请发送电子邮件。 [email protected].
安全和隐私
- Claude 会接收模式元数据、语义智能描述（包括示例值）以及您请求的查询结果。使用分析工具集时，它通常会收到大小估算、配置文件或暂存结果，而完整结果则保留在代理中。它接收到的信息会根据您选择的 AI 提供商的条款传输给该提供商。
- 查询流不会接收或存储您在 Claude 上的对话。
- OAuth授权和密钥是按用户和组织分配的。管理员可以在MCP页面查看和撤销所有授权和密钥。
- 详情请见我们的 隐私政策 和 服务条款.
常见问题解答
我需要开放端口还是运行 VPN？
不。代理程序会在 443 端口上建立一个出站 TLS 连接。如果出站 HTTPS 连接正常，MCP 连接也正常。
Claude可以修改我的数据吗？
不。该代理只接受读取语句。Claude 可以将语义智能运行加入队列，并在试运行模式下提出警报规则；两者都会写入查询流元数据，绝不会写入您的数据库。
还有哪些人工智能工具可用？
任何支持 MCP 的工具：ChatGPT、Cursor、Claude Code、Windsurf、Zed、VS Code Copilot、JetBrains AI、Gemini CLI、Codex CLI、Continue、Cline 等等。门户网站的 连接人工智能客户端 该指南针对每种情况都提供了现成的配置。
什么是保留结果？
在包含结果分析功能的方案中，您的 AI 客户端可以要求代理暂时保留完整的分析结果。后续问题，例如按地区细分或下一页数据，都将基于该副本进行解答，无需再次查询数据库。保留结果的时间长短和结果大小会根据方案而变化。
哪些套餐包含分析工具集？
情境管理和结果分析功能包含在个人核心版及以上版本中；更深入的分析功能包含在业务核心版及以上版本中。 计划表 包含详细信息。
这会改变免费计划吗？
不。免费方案和以前一样，提供标准的结果。
它是否与多个组织合作？
每项授权或密钥都与一个组织绑定。每个组织只需连接一次即可。
它和Nova有什么区别？
Nova 是 Query Streams Portal 内置的助手，它与 Query Streams Portal 采用相同的语义智能模型。如果您想在 Query Streams 中获取答案，请使用 Nova；如果您想将数据导入 Claude，并与其他操作一起导入，请使用 MCP。
连接器专用指南
每份指南都会用实例来阐述相同的联系。
数据库： 微软 SQL 服务器 · PostgreSQL · MySQL · 玛丽亚数据库 · 甲骨文 · 雪花 · Google BigQuery · SQLite · Microsoft Access · 鸭子数据库 · 苏帕巴
蜜蜂： 条纹 · Shopify · HubSpot · 谷歌广告 · 谷歌分析 4 · 谷歌搜索控制台 · ShipStation · iTick
文件和日志文件夹 （代理程序扫描文件夹并将文件转换为表格）： 文件系统 · CSV文件夹 · 镶木地板文件夹 · Excel文件夹 · SQLite文件夹 · JSONL文件夹 · 多记录 CSV · 机器日志 · Web服务器日志 · 容器日志 · 应用程序日志 · 系统日志 · 自定义日志
托管数据库 （由代理通过 TLS 访问的托管 PostgreSQL、MySQL、MariaDB 和 SQL Server）： 氖 · 亚马逊 RDS · Azure Database for PostgreSQL · Azure Database for MySQL · Azure SQL · Google Cloud SQL · Google AlloyDB · DigitalOcean托管数据库 · 艾文 · 脆桥 · Heroku Postgres · 使成为 · 铁路 · Fly.io Postgres · Vultr托管数据库 · OVHcloud托管数据库 · Scaleway托管数据库 · OCI 数据库与 PostgreSQL · MySQL 热浪 · IBM Cloud Databases for PostgreSQL · MariaDB SkySQL · 萨塔 · 时间尺度云 · PlanetScale Postgres · Prisma Postgres · 科耶布 · 尼罗河
English 
Spanish 
German 
French 
Portuguese 
Japanese 
Korean 
Chinese 
Italian 
Dutch 
Indonesian 
Polish