将查询流连接到 Claude，即可使用自然语言查询数据库相关问题。Claude 会实时读取您的数据库模式、已保存的查询和模式智能模型，并通过网络代理运行只读 SQL，并且无需访问数据库密码。本指南涵盖 claude.ai、Claude Desktop 和 Claude Code，以及所有其他 MCP 客户端。
简短版本。 Query Streams is in the Anthropic Connectors Directory. In claude.ai open Settings → Connectors → Browse connectors， 寻找 查询流， 点击 连接在“查询流”同意屏幕上批准权限，并询问克劳德。 “我可以访问哪些数据库？” That’s it.
开始之前
你需要四样东西。大多数账户已经具备前三样。
包含 MCP 的计划
MCP 功能包含在所有套餐中，包括免费套餐。不同套餐的区别在于您可以持有的密钥或已连接应用的数量，以及 Claude 每分钟可以拨打的电话数量；免费套餐允许持有一个密钥或一个已连接应用，以及每分钟 30 个电话。
在线的网络代理
代理程序是一个小型服务，它位于数据库旁边，并向查询流建立一次出站连接。如果您的团队已经在门户网站、Excel 或 Google Sheets 中运行查询，则该代理程序已安装。 安装指南 →
至少一个连接器
连接器是指在门户网站中注册的数据库或 API 源。根据您授予的权限，Claude 可以看到您帐户可以访问的所有连接器。
用户 MCP 访问权限
组织创建者和所有者自动拥有 MCP 访问权限。其他用户需要管理员勾选才能获得访问权限。 MCP 在他们名字旁边 账户 → 访问控制.
工作原理
Claude 不会直接连接到您的数据库。它与我们云端的 Query Streams MCP 服务器通信，该服务器会通过您的网络代理已建立的唯一出站连接转发每个请求。代理在本地运行查询，并以相同的方式将结果流式传输回本地。请求和结果通过代理发起的单一通道双向传输，因此无需在您的防火墙上进行任何设置。
OAuth、权限范围、审计、速率限制
一个出站 TLS 连接
该设计衍生出三个特性：
- 克劳德没有相关资质。 您的数据库连接字符串存储在代理程序中。Claude 仅持有 OAuth 授权或 MCP 密钥，您可以通过门户网站一键撤销这两项授权。
- 只读，由代理强制执行。 仅有的
选择,和和解释声明已被接受。检查在您这边的连接中进行，而不是在云端或 Claude 中。 - 所有信息都会被记录。 每个工具调用都会显示在 MCP 页面上。 活动 选项卡和查询历史记录中的每个查询，都归因于连接的用户。
联系克劳德
有两种途径可以接入。聊天应用使用 OAuth，无需密钥。开发者工具使用 MCP 密钥。两者都连接到同一服务器并使用相同的工具。
方案A：claude.ai 和 Claude Desktop（OAuth，无需密钥）
Listed in the Anthropic Connectors Directory. Query Streams is an approved connector: claude.ai/directory/query-streams. On claude.ai and in Claude Desktop you can connect it with one click from 浏览连接器; no server URL needed. The custom-connector route below still works and is what to use if your Claude organization restricts directory connectors.
- 在 claude.ai 打开 Settings → Connectors → Browse connectors搜索 查询流 并点击 连接 (or open the directory listing directly). In Claude Desktop the same option is under 设置 → 连接器. Can’t see it? Your organization may restrict directory connectors: click 添加自定义连接器 instead, name it 查询流 and paste
https://mcp.querystreams.com/mcp. - 打开任意聊天窗口，点击 + 点击消息框旁边的按钮，选择 查询流 并点击 连接.
- 一个新的浏览器标签页将打开 Query Streams 的同意页面。如果系统提示，请登录；选择组织；查看权限（见下文）；然后点击。 批准连接.
- 回到克劳德那里你就会明白了。 已连接到查询流克劳德第一次使用某个工具时，它会请求权限。请选择 始终允许 这样它就可以在每次通话时无需提示即可工作。
该连接器与您的 Claude 帐户关联，而非与特定设备关联，因此它会自动出现在 Claude 移动应用和 Claude 桌面版中。您可以随时通过门户网站管理或撤销该连接器。 MCP → 互联应用 标签。
与“添加市场”不同。 在 Claude Desktop 中，聊天功能 + → 浏览连接器 → 添加市场 该选项需要插件市场的 Git 仓库，而不是 MCP 服务器 URL。 设置 → 连接器 → 添加.
选项 B：Claude 代码、光标和其他开发者工具（MCP 密钥）
开发者工具使用您在门户中生成并传递的密钥进行身份验证。 X-MCP-Key 标题。
- 登录 my.querystreams.com， 打开 MCP → 我的密钥 并点击 生成密钥以工具和机器的名称命名，例如： 克劳德代码笔记本电脑并选择其作用范围。
- 现在复制密钥。稍后您可以再次显示并复制它。 我的钥匙钥匙看起来像
qsmcp_接下来是 43 个字符。 - 要运行 Claude Code，请运行：
claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp --header "X-MCP-Key: qsmcp_PASTE_KEY_HERE" - 对于 Cursor、VS Code、Windsurf、Zed、JetBrains、Gemini CLI、Codex CLI、Continue 和 Cline，请打开 MCP → 连接 门户网站的选项卡中，会显示每个客户端的现成配置，其中已预先填写了您的密钥，您可以直接粘贴使用。
为了核实，请询问 我有哪些 Query Streams 连接器？ 客户应该打电话 qs_list_connectors 以及钥匙的 上次使用 “我的钥匙”选项卡上的时间会在几秒钟内更新。
权限
无论您是通过 OAuth 还是密钥连接，访问权限都由三个权限范围控制。授权屏幕会显示这些权限范围；密钥也是根据这些权限范围创建的。
| 范围 | 克劳德能做什么 | 何时授予 |
|---|---|---|
| 读 | 列出连接器和代理，浏览架构，阅读架构智能描述，列出已保存的查询和警报规则。 | 一直如此。其他一切都以此为基础。 |
| 分析 | 分析表（样本值、分布、语义类型），发现隐式关系，并将模式智能运行加入队列。 | 推荐。这可以让 Claude 在编写连接语句之前了解数据的结构。 |
| 执行 | 运行只读 SQL 和已保存的查询，并将行流式传输回来。 | 仅供浏览结构的用户查看，以便获取答案。如果仅用于浏览，请将其关闭。 |
经您批准后，已连接的应用可以限制其仅对特定连接器可用；生成的密钥将发送给组织内的所有连接器。撤销授权或密钥将在大约五分钟内生效。管理员可以在 MCP 页面上查看组织内所有有效的授权和密钥。
克劳德连接后能做什么
克劳德看到的是一套小工具。你从不需要自己调用它们；克劳德会根据你的问题选择合适的工具。简单来说：
了解您的数据
列出连接器、数据库和代理。读取任何数据库的模式树，包括表和列描述、语义类型、示例值、枚举标签以及已声明和已发现的关系。
个人资料和探索
在编写筛选器之前，先分析表结构以查看实际值分布。发现未声明外键的表之间的连接。
使用您保存的查询
列出组织已保存的参数化查询，并使用不同的参数运行它们。跨多个数据源的联合查询在服务器端运行，并返回已连接的行。
运行临时 SQL
使用连接器所需的正确方言编写并运行只读 SQL。结果默认返回 1000 行，超时时间为 60 秒，两者均可调整。
查看提醒
列出警报规则，查看其当前状态和最近触发情况。Claude 可以在试运行模式下提出新规则；用户可以在“警报”页面激活该规则。
改进模型
检查每个数据库的架构智能覆盖范围，并在征得您的同意后，安排一次分析运行，以便将来能够获得更好的结果。
为什么模式智能在这里很重要
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 通过 HTTP 运行且未进行端到端压缩，因此其大小以未压缩字节为单位计量，所以 1 MB 的结果大约占用 1 MB 的空间，而返回给 Excel 的相同结果通常占用 150 到 250 KB 的空间。
预览限制适用于探索性问题。 - 模式智能运行。 通过 Claude 提交分析请求会像通过 Portal 运行分析请求一样，向您的组织收取 AI 积分。Claude 会在收取积分前征求您的意见。
故障排除
| 你所看到的 | 它的含义 | 使固定 |
|---|---|---|
| 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 | 结果太大，无法一次性告诉克劳德。 | 要求减少列数或行数。克劳德通常会主动提出这个建议。 |
| 只读违规 | SQL 中包含的内容并非 选择, 和 或 解释. | 这是设计使然。MCP 永远不会接受写入操作。 |
仍然遇到问题？请提交工单。 my.querystreams.com/support 或电子邮件 [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 等等。门户网站的 MCP 页面为每个工具都提供了现成的配置。
它是否与多个组织合作？
每项授权或密钥都与一个组织绑定。每个组织只需连接一次即可。
它和Nova有什么区别？
Nova 是 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