使用 MCP 将 MySQL 连接到 Claude

MCP · MySQL 到 Claude

问 克劳德 关于您的MySQL数据库， 用通俗易懂的英语

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

大约10分钟 Claude、ChatGPT、Cursor 以及其他 11 位客户 数据保留在您的网络上 始终只读

你最终会得到什么

Claude 是一款能够实时执行只读查询并回答有关 MySQL 数据库问题的代理程序，它能解释各列的含义，并在您提出更多问题时提供后续支持——无需数据库登录，也无需更改防火墙设置：网络内部的代理程序会运行 SQL 语句，并仅返回查询结果。代理程序部署到位后，如果您熟悉设置界面，连接 Claude 大约需要 90 秒。例如：

克劳德 ChatGPT 光标 克劳德·科德 VS Code 风帆冲浪 Gemini CLI JetBrains 法典+5只读

里面有什么 客户 我的MySQL数据库中有哪些数据？请显示几行数据，并告诉我每一列的含义。

qs_get_table_schema qs_run_query 模式智能

我首先查看了表结构，然后通过您的代理运行了只读查询。以下是三个客户的数据行：

customer_id	名字	城市
1042	北风贸易公司	西雅图
1057	阿尔卑斯户外用品店	丹佛
1063	港湾食品	哈利法克斯

customer_id 标识行。 名字 和 城市 这些内容在您的语义智能模型中有描述，因此我可以按名称进行筛选。

哪三个 城市 本季度价值类产品带来的收入最多，与上季度相比如何？我应该重点关注哪些方面？

qs_get_relationships qs_run_query qs_run_query

我加入了 客户 至 命令 基于语义智能发现的关系，分别对每个季度运行一次聚合查询。这两个查询均为只读查询，且均返回 3 行数据：

城市	本季度	上个季度	改变
丹佛	184,200	133,900	+38%
西雅图	171,650	168,400	+2%
哈利法克斯	96,300	129,700	-26%

丹佛 故事是这样的：在客户数量几乎不变的情况下，收入增长了 38%，因此平均订单价值也提高了。 哈利法克斯 下降了26%，其中有两位客户上季度每月都下单，而本季度却完全没有下单——月底前值得联系一下。西雅图的业绩持平。想知道哈利法克斯那两位客户的具体姓名吗？

仅选择，由代理检查。 已登录 MCP 活动选项卡 3 个查询共返回 9 行数据 14 个 MCP 客户端中的相同连接

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

MySQL 将您的数据存储在您或您的团队运行的服务器上。而 Claude 则运行在浏览器或终端中，对这些数据一无所知。通常的桥梁是将数据库模式粘贴到聊天窗口中并祈祷，或者将您的 MySQL 密码交给开源的 MCP 服务器。Query Streams 的实现方式有所不同：已经与您的 MySQL 数据库关联的 Agent 以只读方式运行 Claude 编写的 SQL 语句，而 MCP 服务器则负责检查是谁在请求查询、他们可能执行的操作以及查询频率。Claude 只获取查询结果，而不会获取任何凭据。

你需要准备什么

查询流帐户

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

MySQL 通过代理连接

代理程序已安装在 MySQL 数据库所在的目录下，并且已在数据代理中添加了连接。还没完成吗？ 首先连接 MySQL。大约需要十分钟。

MCP 已为您开启

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

人工智能客户

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

分四步完成设置

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

   登录 my.querystreams.com 并开放 流媒体 → 直播 → MCP该页面共有四个标签页： 连接, 互联应用, 我的钥匙 对于管理员而言， 活动检查 我的钥匙 您在此处还可以查看侧边栏：它会列出您的 MySQL 连接器以及语义智能是否已在其上运行。完整的覆盖范围使 Claude 能够一次性编写出正确的 MySQL SQL 语句。

   开放 MCP

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

2. 选择您的连接方式

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

   聊天应用 · 无密钥

   claude.ai、Claude Desktop、ChatGPT

   在 Claude 中，查询流位于 人类连接器目录浏览连接器，点击 连接在其他情况下，您只需将一个地址粘贴到应用程序中即可。 https://mcp.querystreams.com/mcp并通过聊天连接。此时会打开“查询流”页面，您可以选择组织和权限，然后点击。 批准连接无需复制，无需保密。该连接显示在下方。 互联应用 并且可以在那里被撤销。

   开发者工具 · 关键

   Claude Code、光标、VS Code 和朋友们

   在 我的钥匙 点击 生成密钥给它一个 键名 例如“我笔记本电脑上的克劳德代码”，保持 读 和 执行 勾选后，请选择一个 到期日 （从不、30 天、90 天或 1 年）并点击 生成密钥然后复制它。 继续安装： 这 连接 此选项卡显示了您的工具的完整代码片段，其中密钥已预先填写。

   两种方式都使用相同的三个权限，您可以在同意屏幕或密钥上选择这些权限：

   读

   列出连接器，浏览表和列，读取已保存的查询和警报规则。从不返回行数据。

   执行

   通过代理运行只读 SQL 和已保存的查询，并返回相应的行。否则，Claude 可以描述您的数据，但无法从中获取答案。

   分析

   它会分析表结构、发现关联关系并安排语义智能运行。此操作会消耗 Nova AI 积分和数据流量，因此不会在同意界面预先勾选。

   钥匙丢了？ 打开 我的钥匙眼睛图标再次显示了它， 复制完整密钥 复制它。如果笔记本电脑丢失，则撤销该权限；所有使用该权限的客户端都会在大约五分钟内导致下次调用失败。

3. 联系克劳德

   选择你使用的克劳德配方。服务器地址在所有地方都相同： 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. 问你的第一个问题

   先从你已经知道答案的问题入手，这样你就能看到克劳德如何选择合适的工具。以下三个工具与你的 MySQL 数据库配合使用效果很好：

   我的 MySQL 数据库中有哪些数据？

   Claude 会列出它可以看到的表格，告诉你哪些表格具有语义智能，并询问你想查看什么。

   “请给我展示十行客户数据，并解释每一列的内容。”

   Claude 首先读取表结构（读取），然后通过你的代理运行一个 SELECT 语句（执行），并描述名称和城市的含义。

   “每个城市有多少客户？哪个城市的客户数量最多？”

   Claude 用 MySQL 的方言编写了 GROUP BY 语句，运行后用一句话和一个小表格回复了我。在同一个聊天记录中继续讨论，这样可以保留上下文。

   要确认接线情况，请询问 我有哪些 Query Streams 连接器？克劳德打电话 qs_list_connectors，以及在 我的钥匙 关键在于…… 上次使用 时间会在几秒钟内更新。已连接的应用程序会显示在下方。 互联应用 以及连接时间和上次使用时间。

克劳德连接后能做什么

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

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

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

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

这些计划允许什么？

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

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

确保安全

下一步行动不错。

• 保存您认为规范的查询 在查询构建器中，Claude 会优先选择已保存的查询，因此“活跃客户”的含义取决于你们团队的定义。
• 使用 Claude 项目 附加查询流，并在其说明中设置您的规则：默认使用哪个 MySQL 数据库，哪些已保存的查询是官方定义。
• 当您需要更深入的答案时，请使用 Grant Analyze。 在筛选之前先对该列进行分析，这相当于从猜测状态码到使用正确状态码之间的区别。此操作会消耗 Nova AI 积分，因此默认情况下处于关闭状态，直到您手动启用为止。
• 索取一张图表。 claude.ai 根据 Claude 返回的行绘制图表。

当某些事情不起作用时

人们提出的问题

相关指南

• 使用 MCP 将 Microsoft SQL Server 连接到 Claude
• 使用 MCP 将 PostgreSQL 连接到 Claude
• 使用 MCP 将 Microsoft Access 连接到 Claude
• 使用 MCP 将 SQLite 连接到 Claude
• 通过 MCP 将查询流连接到 Claude：设置、权限和故障排除
• 如何将 MySQL 连接到 Google Sheets
• 所有 MCP 指南