Railway → Claude · 使用 Query Streams
使用 Query Streams,以通俗易懂的语言向 Claude 询问有关 Railway 数据库的问题:已在您的网络内部署的 Agent 会以只读方式执行 SQL,数据库密码绝不会传给 AI。大约需要 10 分钟,免费计划即可满足需求。
免费开始
你最终会得到什么
Claude 能够通过实时只读查询回答有关您的铁路 Postgres 数据库的问题,解释列的含义,并在您提出更多问题时进行跟进——无需数据库登录,也无需更改防火墙设置:已部署在您网络中的代理程序运行 SQL 并仅返回查询结果行。代理程序部署完毕后,如果您熟悉设置界面,连接 Claude 大约需要 90 秒。例如:
里面有什么 客户 我的铁路数据库中,请显示几行数据,并告诉我每一列的含义。
我首先查看了表结构,然后通过您的代理运行了只读查询。以下是三个客户的数据行:
| customer_id | 名字 | 城市 |
|---|---|---|
| 1042 | 北风贸易公司 | 西雅图 |
| 1057 | 阿尔卑斯户外用品店 | 丹佛 |
| 1063 | 港湾食品 | 哈利法克斯 |
customer_id 标识行。 名字 和 城市 这些内容在您的语义智能模型中有描述,因此我可以按名称进行筛选。
哪三个 城市 本季度价值类产品带来的收入最多,与上季度相比如何?我应该重点关注哪些方面?
我加入了 客户 至 命令 基于语义智能发现的关系,分别对每个季度运行一次聚合查询。这两个查询均为只读查询,且均返回 3 行数据:
| 城市 | 本季度 | 上个季度 | 改变 |
|---|---|---|---|
| 丹佛 | 184,200 | 133,900 | +38% |
| 西雅图 | 171,650 | 168,400 | +2% |
| 哈利法克斯 | 96,300 | 129,700 | -26% |
丹佛 故事是这样的:在客户数量几乎不变的情况下,收入增长了 38%,因此平均订单价值也提高了。 哈利法克斯 下降了26%,其中有两位客户上季度每月都下单,而本季度却完全没有下单——月底前值得联系一下。西雅图的业绩持平。想知道哈利法克斯那两位客户的具体姓名吗?
完全不想搭建人工智能客户端? 关于商业计划书, 诺瓦 MCP 是 Query Streams 内置的助手。它使用与您的 AI 客户端相同的 Agent 工具集,此外还具备外部客户端所不具备的功能:它会根据您的语义智能模型生成并验证 SQL,将结果转换为图表,并将结果保存为查询,您的团队可以从 Excel、Google Sheets 或 REST API 运行该查询——无需密钥、连接器或安装任何软件。如果您的团队成员已经在使用 Claude、Cursor 或 ChatGPT,请使用 MCP;如果您希望在门户网站内获取答案,请使用 Nova。
Railway 将您的数据存储在云端,由其服务提供商运营。而 Claude 则运行在浏览器或终端中,对数据一无所知。通常的做法是将模式粘贴到聊天窗口中,然后祈祷成功,或者将您的 Railway 密码提供给开源的 MCP 服务器。Query Streams 的实现方式有所不同:已与您的 Railway Postgres 数据库关联的代理程序以只读方式运行 Claude 编写的 SQL 语句,而 MCP 服务器则负责检查请求者的身份、请求内容和请求频率。Claude 只获取请求结果,而不会获取任何凭据。
铁路数据库默认是私有的。一旦开放公共访问,代理程序就会通过铁路公司的 TCP 代理进行连接。
你需要准备什么
通过代理商连接的铁路
在任何始终开机的计算机上安装代理,并在数据代理中添加铁路连接。
选择 铁路 门户网站中的卡片。它会预先填充数据库。 铁路用户 PostgreSQL 启用 SSL。在 Railway 系统中,在“设置”>“网络”下启用 Postgres 服务的公共访问权限。然后复制 数据库公共 URL 它的 变量 按 Tab 键粘贴,然后填写 TCP 代理主机和端口。 .railway.internal host 仅可在 Railway 内部使用,表单会拒绝它。
MCP 已为您开启
创建者、所有者和管理员从一开始就拥有权限。其他所有人则需要管理员来切换权限。 MCP 他们名字旁边的开关 账户 → 访问控制在此之前,MCP 页面会显示“您的帐户已禁用 MCP”。
人工智能客户
像 claude.ai、Claude Desktop 和 ChatGPT 这样的聊天应用无需密钥即可连接。Claude Code、Cursor、VS Code 以及其他大约十种工具则需要密钥;门户网站的 连接人工智能客户端 向导会逐一进行设置。
工作在哪里进行? 在运行代理的计算机上,它会接收您的 AI 客户端编写的 SQL 语句,检查它是否为 SELECT 语句,执行该语句并返回结果行。因此,当您发出请求时,该计算机必须处于开机状态;您自己的笔记本电脑只需要 AI 客户端即可。
分四步完成设置
-
在门户网站中打开 MCP。
登录 my.querystreams.com 并开放 流媒体 → 直播 → MCP该页面共有四个标签页: 连接, 语境, 工具 对于管理员而言, 活动请查看语义智能面板。 连接 您在这里可以看到:这里列出了您的铁路连接器以及语义智能是否已在其上运行。完整的覆盖范围使得 Claude 能够一次性编写出正确的铁路 SQL。
看到“您的帐户已禁用 MCP”提示? 您的组织拥有 MCP,但您的用户已被禁用。管理员使用以下命令将其启用: 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(一个授权方式:持有者使用相同键的标头也有效)。 -
问你的第一个问题
先从你已经知道答案的问题入手,这样你就能看到克劳德如何选择合适的工具。以下三个工具与你的 Railway Postgres 数据库配合使用效果很好:
- “我的铁路Postgres数据库中有哪些数据?”
- Claude 会列出它可以看到的表格,告诉你哪些表格具有语义智能,并询问你想查看什么。
- “请给我展示十行客户数据,并解释每一列的内容。”
- Claude 首先读取表结构(读取),然后通过您的代理运行一个 SELECT 查询(运行查询),并描述名称和城市的含义。
- “每个城市有多少客户?哪个城市的客户数量最多?”
- 克劳德用铁路方言编写了 GROUP BY 语句,运行后用一句话和一个小型表格回复。在同一个聊天窗口中继续讨论,这样可以保留上下文。
要确认接线情况,请询问 我有哪些 Query Streams 连接器?克劳德打电话
qs_list_connectors《传送门》指南的 检查连接 步骤说 已连接以及钥匙或应用程序 连接 标签页显示了它的 上次使用 几秒钟之内即可完成。
就是这样。 现在,无论您在哪个 Claude 客户端中打开,只要您提出问题,Claude 都会直接从您的 Railway Postgres 数据库中提供答案。除了问题所需的数据行之外,没有任何数据离开您的网络,也没有人需要向 AI 输入密码。
克劳德连接后能做什么
您的AI客户端会识别查询流工具;它会根据您的问题选择合适的工具。门户网站的 工具 标签 列出所有工具和模式,以及你的套餐包含的内容。Query Streams 会让你的 AI 客户端在查询前读取每个表的列信息,这样它就会使用真实名称,而不是猜测。所有套餐(包括 Free)均可使用:
绘制您的数据
连接器、数据库和代理;语义智能运行后,您的铁路数据库的表和列及其描述、示例值和连接。
个人资料和探索
在按列筛选之前分析该列;发现无人声明的联接。实时运行需要 Analyze。
运行只读 SQL
使用正确的 Railway 方言执行 SELECT 查询,默认耗时 60 秒,最长 5 分钟。您的执行计划决定了单个查询返回的最大行数。(运行查询)
已保存的查询、联合查询和警报
使用新值运行团队信任的已保存查询;联合查询返回的已连接状态。阅读告警规则并草拟一个作为演练。
分析工具集。 付费方案中,代理程序会负责铁路数据库的基础工作,这样您的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 第一次就编写出了正确的铁路 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 语句。检查在运行代理的计算机上进行,在您的铁路数据库接收到 SQL 语句之前,因此您的 AI 客户端写入的任何内容都不会更改数据。
没有人工智能方面的资质
铁路登录信息保留在代理上。Claude 持有查询流密钥或连接,您可以从 MCP 页面撤销该密钥或连接;更改将在大约五分钟内生效。
所有信息均已记录
每次工具调用都会显示在 MCP 上。 活动 选项卡和查询历史记录中的每个查询都会以客户端类型 MCP 的形式记录,并归属于发出该查询的密钥或连接的用户。SQL 文本和密钥本身永远不会写入活动日志。
人工智能提供商收到的内容
表名和列名、语义智能描述(包括示例值)以及您请求的查询行。使用分析工具集时,通常会获得大小估算、配置文件或暂存结果,而完整结果则保留在代理端。根据其条款,获取到的信息将发送给您连接的 AI 提供商。查询流永远不会看到您的聊天记录。
下一步行动不错。
- 保存您认为规范的查询 在查询构建器中,Claude 会优先选择已保存的查询,因此“活跃客户”的含义取决于你们团队的定义。
- 使用 Claude 项目 附加查询流,并在其说明中放入您的规则:默认使用哪个铁路数据库,哪些已保存的查询是官方定义。
- 当您需要更深入的答案时,请使用 Grant Analyze。 在筛选之前先对该列进行分析,这相当于从猜测状态码到使用正确状态码之间的区别。此操作会消耗 Nova AI 积分,因此默认情况下处于关闭状态,直到您手动启用为止。
- 索取一张图表。 claude.ai 根据 Claude 返回的行绘制图表。
当某些事情不起作用时
| 你所看到的 | 它的含义 | 使固定 |
|---|---|---|
| 您的 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 | 拥有您铁路数据库的代理目前未连接。 | 打开 数据 → 数据代理 并在其计算机上启动代理。 |
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 写入。 |
人们提出的问题
Claude可以修改我的铁路数据吗?
不。代理程序只接受 SELECT 语句,并在 SQL 运行前进行检查。Claude 可以将语义智能运行或警报规则草拟作为预演加入队列;这两项操作都会写入查询流元数据,绝不会写入您的 Railway 数据库。
我需要开放端口还是运行 VPN?
不。代理程序在 443 端口上建立一个出站连接,所有请求和数据行都通过该连接传输。如果出站 HTTPS 连接正常,则 MCP 功能也正常。
免费套餐真的包含这些吗?
是的。“免费”套餐是永久有效的,不是会过期的试用期。所有套餐都包含 MCP;“免费”套餐允许使用一个密钥或一个已连接的应用程序,通话时长为每分钟 30 次。请查看“免费”套餐的具体包含内容。 定价页面.
哪些套餐包含分析工具集?
个人核心版及以上版本包含上下文管理和结果分析功能;企业核心版及以上版本提供更深入的分析功能。免费版的功能与以往相同,提供标准结果。结果保存时长随套餐升级而增加,企业版最高可达 8 小时和 4,096 MB。
除了 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 客户端”指南中都有现成的方案。
克劳德是否了解整个组织的情况?
一个密钥即可连接到您组织的所有连接器。您可以批准将已连接的应用限制为仅连接到特定连接器。每个密钥或连接都属于一个组织;每个组织只需连接一次即可。
它和Nova有什么区别?
Nova 是 Query Streams Portal 中的助手,它与 Query Streams Portal 采用相同的语义智能模型。如果您想在 Query Streams 中获取答案,请使用 Nova;如果您想将数据导入 Claude,并与其他操作一起显示在 Claude 中,请使用 MCP。
Claude 是否了解 Railway 的 SQL 方言?
是的。每个模式响应都会告诉 Claude 它正在查看哪种连接器类型,然后 Claude 会为该引擎编写 SQL。借助语义智能,它还能看到列描述和示例值,因此无需再猜测状态码或缩写的含义。
我的铁路Postgres数据库必须和Claude的数据库在同一台电脑上吗?
不。只有代理程序需要与您的铁路Postgres数据库位于同一位置,或者位于任何始终在线且可访问互联网的计算机上。Claude可以位于您的笔记本电脑、手机或其他任何服务器上;它只与查询流通信。
相关指南
每份指南 Railway
这不是你想要的配置?
- 在您自己的服务器或计算机上运行 PostgreSQL?请使用 PostgreSQL 卡片 → PostgreSQL
设置有问题吗?
- 想让代理使用只有读取权限的登录名登录吗?创建一个只读数据库用户,并为每个数据库复制粘贴 SQL 代码 → 创建一个只读数据库用户
- 代理显示离线,或者“测试连接”和“浏览”按钮呈灰色?请检查代理是否在线 → 经纪人在线吗?



