使用 MCP 将 Azure SQL 连接到 Claude

MCP · Azure SQL 致 Claude

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

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

大约10分钟 Claude、ChatGPT、Cursor 以及其他 11 位客户 凭证将一直随您保留 始终只读

你最终会得到什么

A Claude that can answer questions about your Azure SQL database with live, read-only queries, explain what the columns mean, and follow up when you ask for more — without ever seeing a database login, and without a firewall change: the Agent already inside your network runs the SQL and sends back only the rows. Once the Agent is in place, connecting Claude takes about 90 seconds if you are comfortable with a settings screen. Like this:

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

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

qs_get_table_schema qs_run_query 模式智能

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

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

客户ID 标识行。 公司名称 和 城市 are described in your Schema Intelligence model, so I can filter on them by name.

Which three 城市 values brought in the most revenue this quarter, and how does that compare with last quarter? Anything I should look into?

qs_get_relationships qs_run_query qs_run_query

I joined 客户 至 命令 on the relationship Schema Intelligence found, then ran one aggregate for each quarter. Both queries were read-only and returned 3 rows each:

城市	This quarter	Last quarter	Change
丹佛	184,200	133,900	+38%
西雅图	171,650	168,400	+2%
哈利法克斯	96,300	129,700	−26%

丹佛 is the story: revenue up 38% on almost the same number of customers, so average order value rose. 哈利法克斯 fell 26%, and the drop is two customers who ordered every month last quarter and not at all this quarter — worth a call before month end. Seattle is flat. Want the two Halifax accounts by name?

仅选择，由代理检查。 已登录 MCP 活动选项卡 9 rows returned across 3 queries 14 个 MCP 客户端中的相同连接

Rather not wire up an AI client at all? On the Business plan, 诺瓦 is the assistant built into Query Streams itself. It has every tool Claude gets here, plus the ones Claude does not: it drafts and validates the SQL against your Schema Intelligence model, turns the answer into a chart, and saves the result as a query your team can run from Excel, Google Sheets or the REST API — no key, no connector, nothing to install. Use MCP when your people already live in Claude, Cursor or ChatGPT; use Nova when you want the answers inside the Portal.

Azure SQL 将您的数据存储在云端，由其提供商运行。而 Claude 则运行在浏览器或终端中，对数据一无所知。通常的桥梁是将架构粘贴到聊天窗口并祈祷，或者将您的 Azure SQL 密码交给开源的 MCP 服务器。Query Streams 的实现方式有所不同：已与您的 Azure SQL 数据库关联的代理以只读方式运行 Claude 写入的 SQL 语句，而 MCP 服务器则负责检查是谁在请求、请求内容以及请求频率。Claude 会收到答案，但永远不会获取凭据。

Azure SQL 数据库是微软在 Azure 中托管的 SQL Server 引擎。本指南通过您的代理使用 Query Streams MCP 服务器，而不是微软的 Azure MCP 服务器或其 SQL MCP 服务器。

你需要准备什么

查询流帐户

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

Azure SQL 通过代理连接

代理程序安装在任何始终在线的计算机上，并在数据代理中添加 Azure SQL 连接。

选择 Azure SQL 在“关系型数据库”下找到卡片。它预先填充了端口 1433、“加密连接”和“信任服务器证书”选项，因为 Azure 的证书是公开信任的。在 Azure 门户中，打开数据库，然后选择 设置 然后 连接字符串然后粘贴 ADO.NET 字符串。门户网站会隐藏密码，所以请自行输入。请命名您的实际数据库，不要使用“master”。

MCP 已为您开启

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

人工智能客户

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

分四步完成设置

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

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

   开放 MCP

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

2. 选择您的连接方式

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

   聊天应用 · 无密钥

   claude.ai、Claude Desktop、ChatGPT

   In Claude, Query Streams is in the Anthropic Connectors Directory: browse connectors, click 连接. Elsewhere you paste one address into the app, 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. 打开 设置 → 连接器 并点击 浏览连接器. Query Streams is listed in the Anthropic Connectors Directory: find 查询流 并点击 连接. (Or open the directory listing directly and click 连接 there.)
   2. If your organization hides directory connectors, click 添加自定义连接器 instead. Name it 查询流， 粘贴 https://mcp.querystreams.com/mcp, leave the OAuth fields empty, click 添加, then in any chat click + → 浏览连接器 → 查询流 → 连接.
   3. “查询流”选项卡随即打开。如果系统提示，请登录，选择组织，然后进行审核。 读 和 执行（可选） 仅限特定连接器然后点击 批准连接.
   4. 回到 Claude 界面，你会看到“已连接到查询流”。Claude 首次使用某个工具时会询问：请选择 始终允许.

   If you do add it by hand in Claude Desktop, use 设置 → 连接器 → 添加不是聊天记录 添加市场 option, which expects a git repository. Connectors sync to your Claude account, so the mobile apps and Desktop pick it up automatically. Menu names are Anthropic’s and can move.

   克劳德·科德 钥匙

   使用“我的密钥”中的密钥，只需执行一条命令：

   终端

   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. 问你的第一个问题

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

   我的 Azure SQL 数据库中有哪些数据？

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

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

   Claude 首先读取表结构（读取），然后通过您的代理运行一个 SELECT 查询（执行），并描述 CompanyName 和 City 的含义。

   “每个城市有多少行客户信息？哪个城市的客户信息最多？”

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

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

克劳德连接后能做什么

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

为什么模式智能在这里很重要

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

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

这些计划允许什么？

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

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

确保安全

下一步行动不错。

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

当某些事情不起作用时

人们提出的问题

相关指南

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