查看类别

连接铁路到克劳德与MCP

铁路免费计划查询流克劳德

Railway → Claude · 使用 Query Streams

使用 Query Streams,以通俗易懂的语言向 Claude 询问有关 Railway 数据库的问题:已在您的网络内部署的 Agent 会以只读方式执行 SQL,数据库密码绝不会传给 AI。大约需要 10 分钟,免费计划即可满足需求。

免费开始
数据库书架的等距插画:Agent 将推车上的卡片送到柜台的聊天面板
遇到任何问题?尽管问我们。 打开 支持 请在“查询流”(右上角菜单 → 支持)中给我们发送消息。我们会安排专人阅读您的消息,“我不知道这个屏幕需要什么”就是一个很好的问题。

你最终会得到什么

铁路标志Claude 能够通过实时只读查询回答有关您的铁路 Postgres 数据库的问题,解释列的含义,并在您提出更多问题时进行跟进——无需数据库登录,也无需更改防火墙设置:已部署在您网络中的代理程序运行 SQL 并仅返回查询结果行。代理程序部署完毕后,如果您熟悉设置界面,连接 Claude 大约需要 90 秒。例如:

Nova,查询流助手

完全不想搭建人工智能客户端? 关于商业计划书, 诺瓦 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 代理进行连接。

特工奔跑的地方任何始终在线且联网的计算机或服务器你的铁路数据库凭证保留在此处查询流代理运行 Claude 编写的 SQL 语句仅选择,此处强制执行查询流MCP服务器检查密钥、范围、速率限制 · 记录每次调用你在哪里问claude.ai、Claude Desktop、Claude Code、光标、ChatGPT您的AI客户端它包含密钥或连接,但绝非密码。
Claude 不会直接操作您的铁路数据库。它会向 Query Streams MCP 服务器发出请求,该服务器会通过您的代理程序已建立的出站连接转发请求。代理程序运行查询,并仅返回查询结果行。

你需要准备什么

查询流帐户

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

通过代理商连接的铁路

在任何始终开机的计算机上安装代理,并在数据代理中添加铁路连接。

选择 铁路 门户网站中的卡片。它会预先填充数据库。 铁路用户 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 客户端即可。

分四步完成设置

  1. 在门户网站中打开 MCP。

    登录 my.querystreams.com 并开放 流媒体 → 直播 → MCP该页面共有四个标签页: 连接, 语境, 工具 对于管理员而言, 活动请查看语义智能面板。 连接 您在这里可以看到:这里列出了您的铁路连接器以及语义智能是否已在其上运行。完整的覆盖范围使得 Claude 能够一次性编写出正确的铁路 SQL。

    看到“您的帐户已禁用 MCP”提示? 您的组织拥有 MCP,但您的用户已被禁用。管理员使用以下命令将其启用: MCP 你的名字旁边有个开关。 账户 → 访问控制创建者、所有者和管理员从一开始就在线。

  2. 选择您的连接方式

    有两条路可以进去,但它们通向同一个地方:

    聊天应用 · 无密钥

    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 点数和数据额度,因此同意屏幕不会默认勾选该选项。

    钥匙丢了? 它列在…… 连接 标签: 显示完整密钥 再次显示并 复制完整密钥 复制它。如果笔记本电脑丢失,则撤销该权限;所有使用该权限的客户端都会在大约五分钟内导致下次调用失败。

  3. 联系克劳德

    选择你使用的克劳德配方。服务器地址在所有地方都相同: https://mcp.querystreams.com/mcp.

    网页版 Claude、桌面版 Claude 和移动版 Claude 没有钥匙

    1. 打开 查询流列表 在 Anthropic 的连接器目录中,然后点击 连接在桌面版中,它位于以下位置 + → 连接器.
    2. 如果您的组织隐藏了目录连接器,则可采取以下备用方案: 设置 → 连接器 → 添加自定义连接器, 姓名 查询流网址 https://mcp.querystreams.com/mcpOAuth字段为空, 添加然后在聊天中 + → 查询流 → 连接.
    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. 问你的第一个问题

    先从你已经知道答案的问题入手,这样你就能看到克劳德如何选择合适的工具。以下三个工具与你的 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客户端就可以专注于逻辑推理。免费方案的功能与以往相同。

上下文管理

个人核心及以上

在读取结果之前先调整结果大小(形状),逐个区域地遍历大型数据库(级别),并将答案控制在代币预算范围内,仅包含 列 以及所需的细胞长度。

结果分析

个人核心及以上

A 个人资料 显示的是整个结果,而不是行。 结果维持不变 使用标签回答后续问题并按分组统计总数,无需进行第二次查询。 数据新鲜度 和 自 只阅读新增内容。

深入分析

业务核心及以上

数据 质量 报告, 异常, 片段统计学 比较 和 差异 介于两个已公布结果之间。

默认值存在于 语境 标签:文本单元格限制、架构视图、结果大小、分析默认值和保留结果。

如果您希望在 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 客户端每分钟可以发起的呼叫次数:

计划每个用户的密钥每个组织的密钥每分钟通话次数
免费1130
个人核心1160
个人加强版1190
核心业务23120
商务+35150
商业最大510240
企业核心525300
企业增强版850450
企业版 Max10100600

已连接的应用算作一个键。除了每分钟的限制外,任何一个键每分钟最多可以运行 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可以位于您的笔记本电脑、手机或其他任何服务器上;它只与查询流通信。

还是不行? 打开 支持 请在“查询流”中告诉我们您当前处于第几步以及您看到的内容。我们会帮您连接。
同一条铁路连接线也为铁路提供动力。Excel 和 Google Sheets自动化REST API完整的 MCP 设置指南

每份指南 Railway

这不是你想要的配置?

  • 在您自己的服务器或计算机上运行 PostgreSQL?请使用 PostgreSQL 卡片 → PostgreSQL

设置有问题吗?

  • 想让代理使用只有读取权限的登录名登录吗?创建一个只读数据库用户,并为每个数据库复制粘贴 SQL 代码 → 创建一个只读数据库用户
  • 代理显示离线,或者“测试连接”和“浏览”按钮呈灰色?请检查代理是否在线 → 经纪人在线吗?
更新 11 月 9, 2026

Powered by BetterDocs