如何使用 Claude/Cursor 通过 MCP 查询 Stripe 数据（Stripe MCP 服务器设置）

查看本指南之外查询流的所有功能 免费开始

支持

+更多

实时数据

用按需 SQL 取代导出

在 Excel 板材

商业智能和人工智能分析

询问 Nova，获取 SQL + 图表

认识诺瓦

数据库 REST API

每个合作伙伴使用一个密钥。不共享任何凭证。

构建 API

+更多

自动化

预定同步至 6 个以上平台

探索

+更多

将应用程序接口转换为 SQL

使用 SQL 查询 API，无需代码

探索

+更多

AI数据库MCP

Claude、Cursor、ChatGPT 和 Grok 可以与您的数据交互

Connect AI

Query Streams 是一个安全的实时数据集成平台，它通过一个 MCP 密钥将您帐户中的每个数据库和 SaaS API 导入到 Claude、Cursor、ChatGPT 和 Grok 中，而无需更改防火墙。 本指南将带您了解…… 条纹 mcp 具体来说，这样您的 AI 工具就可以回答有关客户、订阅、费用、发票和退款的简单英语问题，而无需您从 Stripe 控制面板导出 CSV 文件或在脚本中串联 REST API 分页调用。网络代理会将 Stripe API 数据提取到本地 DuckDB 缓存中，因此 LLM 可以看到干净的 SQL 数据（客户、订阅、费用、发票、退款、付款），而不是原始的 REST 端点——其中货币列会被标记为 货币单位（美元） 因此，人工智能会自动将金额除以 100，并且永远不会将 1,234.56 美元的费用报告为“123,456 美元”。 了解更多信息，请访问 QueryStreams.com 和 免费注册 开始向您的 AI 工具提出真正的 Stripe 相关问题。

Stripe MCP 服务器查询流功能为您提供什么

Stripe 提供了一个非常出色的第一方 AI 界面—— Stripe Agent Toolkit ——它为 AI 代理提供了对 Stripe REST API 的读写函数调用封装，用于执行诸如创建客户、生成结账会话、退款和取消订阅等操作。当 AI 需要执行以下操作时，这正是合适的工具： 做 Stripe方面的情况。Query Streams Stripe MCP服务器解决的是完全不同的问题： 只读分析界面 Query Streams MCP 连接器支持以 SQL 形式公开的 Stripe 数据，并提供与其他所有 Query Streams MCP 连接器相同的审计跟踪和多连接器支持。我们在 GitHub 上也看到其他一些开源的 Stripe MCP 封装器——它们大多将原始的 Stripe REST 或分页游标推送到 LLM，没有 SQL 接口，没有分值语义，也没有只读强制机制。Query Streams 只需一个密钥即可访问所有连接器，提供完整的审计跟踪，代理会将 Stripe API 响应规范化为 SQL 接口，并且 AI 工具永远不会持有您的 Stripe API 密钥。

如何在不打开防火墙端口的情况下工作

查询流网络代理只需在任何可访问互联网的机器上安装一次（Stripe API 可从任何地方访问），并维护一个出站 TLS 云链接——没有入站流量，也不会暴露任何数据。Stripe 特有的功能是：当收到查询请求时，代理会在后台对 Stripe REST 端点进行分页，并将响应缓存到本地 DuckDB 中，以便 LLM 能够看到干净的 SQL 接口。 客户, 订阅, 订阅项目, 收费, 收据, 退款, 支付款项, 价格, 产品 — 而不是 REST 信封。这款 AI 工具永远不会看到您的 Stripe 受限 API 密钥、Stripe Connect 账户 ID 或任何客户支付数据。 仅出站代理链接的工作原理 →

你给 Cursor 或 Claude 的 MCP 键是限定范围的（读 / 分析 / 执行），可随时撤销，且每个密钥的使用频率有限制。该人工智能工具调用这些 MCP 工具来完成其工作：

为什么模式智能使查询流 MCP 与众不同

开源领域中大多数“Stripe MCP”服务器会向你的AI工具提供与Stripe为开发者发布的相同的REST资源引用——或者更糟的是，直接提供原始资源引用。 信息模式 他们保存的任何缓存信息，包括字段名称、数据类型，可能还有主键。LLM 只能靠猜测来获取这些信息。 数量 需要除以 100，因为 Stripe 是以美分为单位存储资金的。 实时模式 = false 每行数据是测试费用，应该从收入中剔除。 订阅状态 是一个枚举 试验 / 活动 / 逾期 / 取消 / 未付 / 未完成或者说， 创建 需要通过 DuckDB 的时间戳辅助函数进行转换。这就是为什么大多数 LLM 针对裸 Stripe schema 编写的第一个 SQL 语句都是错误的——不是因为 LLM 本身不好，而是因为它没有正确的数据（而报告“1,234,567,890 美元的 MRR，因为没有人除以 100”这种错误，很容易被截图上传到财务团队的 Slack 聊天室）。

查询流 MCP 返回相同的缓存 Stripe 模式，并添加了我们所说的内容。 模式智能（SI） — 通过对您的数据运行分析查询而生成的由人工智能整理的元数据 真实 在 AI 客户端请求之前，Stripe 会先获取数据。当 Stripe 连接器上启用 SI 时，AI 调用的每个模式工具都会执行此操作。qs_get_connector_schema, qs_get_table_schema, qs_profile_table, qs_get_relationships返回原始缓存模式以及六层精选知识。LLM 停止猜测。

为了更具体地说明这一点，以下是人工智能客户端从单个请求中获得的返回结果。 qs_get_table_schema 反对 Stripe 连接器的 收费 表——驱动 90% 收入问题的核心交易表——首先是没有 Schema Intelligence，然后是有了 Schema Intelligence。

模式智能新增的六个层

每一层都针对特定类型的问题，否则LLM（法学硕士）就只能靠猜测了。SI（系统集成）是可选的。 （连接器，数据库） 配对运行，对您的数据进行一次性分析——它不会更改您的架构，不会写入您的数据库，并且会在您的架构更改时增量刷新。

相同的提示符，不同的 SQL

证据就在人工智能工具实际生成的 SQL 语句中。相同的 Cursor 会话，相同的 Claude 模型，相同的提示符—— “在过去 30 天内，哪些客户的消费金额最高？（仅统计成功生产产生的费用）” 如果没有模式智能，LLM 就只能靠猜测。有了模式智能，LLM 就能知道金额单位是美分，状态枚举需要过滤，livemode = true 是生产环境过滤器，客户外键允许它将客户添加到系统中，以便发送易于理解的电子邮件。

查询流 MCP 与 Stripe Agent Toolkit

Stripe 发货 Stripe Agent Toolkit ——一套官方的 Stripe REST API 函数调用封装器，专为 LangChain、OpenAI Agents SDK、Vercel AI SDK 和类似的代理框架而设计。它采用读写设计：拥有 Agent Toolkit 访问权限的 AI 代理可以…… 客户创建, 取消订阅, 退款创建, checkout.sessions.create等等。这正是人工智能应该呈现的形状。 行为 Stripe 平台支持多种应用场景，例如：支持助手处理退款、新用户引导机器人创建结账链接、销售代理更新客户元数据。而 Query Streams MCP 则解决了另一个问题：它提供了一个只读分析界面，用于分析以 SQL 形式公开的 Stripe 数据。这两个工具回答的问题各不相同。以下是它们在 AI 工具访问 Stripe 数据时，在关键维度上的比较。

MCP不适合您？不妨试试Nova AI。

完全跳过 MCP，直接向 Stripe 询问类似这样的问题：“过去 12 个月我们的月度经常性收入 (MRR) 趋势如何？“ 或者 ”未来 30 天内哪些订阅面临风险？直接来自 Query Streams 门户——无需配置文件，底层采用相同的网络代理和架构智能。

认识 Nova AI

先决条件

开始之前，请确保您已准备好：

1. 免费注册 Query Streams 帐户 my.querystreams.com.
2. 安装在可访问互联网的计算机上的 Query Streams 网络代理 — 请参阅 下载查询流代理Stripe API 可以从任何地方访问，因此代理不需要位于特定的网络上。
3. 针对代理配置的 Stripe 连接器——请参阅现有 API 连接器设置 Stripe配对指南。使用 Stripe 受限 API 密钥 （推荐）这样您就可以将代理的读取权限限定于特定资源（例如，读取权限）。 收费 / 订阅 / 客户 / 收据无法访问 平衡 / 支付款项 / 账户 如果您不需要它们）。代理持有 Stripe API 密钥；AI 工具永远不会接触到它。
4. 任何支持 MCP 的 AI 客户端。本指南将以 Cursor、Claude Desktop、ChatGPT 和 Grok 为例；如果您使用 Windsurf、Zed、Continue、Cline、VS Code Copilot、Codex 或 Goose，配置块基本相同。
5. 五分钟。

步骤 1：在查询流中生成 MCP 密钥

登录查询流并打开 MCP页面 （或先登录） my.querystreams.com 并点击 MCP 在左侧导航栏中）。点击 生成密钥给密钥起一个易于识别的名称（例如“密钥”）。 光标-笔记本电脑 或 克劳德桌面），然后选择您希望此密钥具有的作用域：

• 读 —人工智能可以浏览连接器并读取模式。其他所有操作都需要用到它。
• 分析 — AI 可以分析表格并发现关系（样本值、分布、语义类型）。对于财务工作而言，虽然并非必需，但强烈建议使用此功能，因为了解费用/订阅/发票数据的结构和指标语义（精确到分的货币列、状态枚举、实时模式标记）至关重要。
• 执行 — 该人工智能实际上可以运行 SQL。否则，它只能读取模式元数据，而不能进行其他操作。

对于典型的“让 Claude 分析我的 Stripe 数据”工作流程，这三种范围都适用。如果您要将密钥交给团队成员或不太信任的客户，请删除。 执行 只允许他们浏览。您可以随时在同一页面撤销任何密钥；AI 客户端将会看到。 MCP_KEY_REVOKED 在下次调用时立即停止工作，没有传播延迟。

现在复制密钥——查询流会显示密钥一次，然后只存储哈希值。如果密钥丢失，请生成一个新密钥。密钥格式如下： qsmcp_ 接下来是 48 个随机字符，这就是你的 AI 客户端发送的内容。 X-MCP-Key 请求头。

步骤 2：将查询流 MCP 添加到您的 AI 客户端

所有支持 MCP 的客户端的配置形式都相同——一个指向 MCP 服务器的条目 https://mcp.querystreams.com 钥匙在里面 X-MCP-Key 标题。请在下方选择您的客户。

光标 ~/.cursor/mcp.json

// 编辑 ~/.cursor/mcp.json
{
  "mcpServers": {
    “查询流”: {
      网址: "https://mcp.querystreams.com",
      “标题”: {
        “X-MCP-Key”: "qsmcp_PASTE_KEY_HERE"
      }
    }
  }
}

克劳德桌面 claude_desktop_config.json

// 设置 → 开发者 → 编辑配置
{
  "mcpServers": {
    “查询流”: {
      网址: "https://mcp.querystreams.com",
      “标题”: {
        “X-MCP-Key”: "qsmcp_PASTE_KEY_HERE"
      }
    }
  }
}

ChatGPT 应用和连接器

// 设置 → 应用和连接器 → 添加 MCP
服务器 URL  https://mcp.querystreams.com
身份验证标头 X-MCP-Key
标题值 qsmcp_PASTE_KEY_HERE

// 需要付费的 ChatGPT 套餐
//（Plus / Pro / Team / Enterprise）。

格罗克 远程 MCP 工具

// Grok → 设置 → 工具
{
  "mcp_servers": [{
    “姓名”: “查询流”,
    网址: "https://mcp.querystreams.com",
    "auth_header": “X-MCP-Key”,
    "auth_value": "qsmcp_..."
  }]
}

重启您的 AI 客户端。下次启动时，它将发现上面列出的八个查询流 MCP 工具，并将它们显示在工具面板中。您可以在 Cursor 和 Claude Desktop 中通过键入以下命令进行验证。 “列出连接器” 人工智能应该打电话 qs_list_connectors 并退回您的 Stripe 连接器（以及您配置的任何其他内容，如果您配对了多个帐户，还包括其他 Stripe Connect 平台）。

步骤 3：向 AI 提出 Stripe 问题

您无需编写 SQL，AI 会代劳。您只需提出问题，AI 会选择合适的 MCP 工具，然后代理会针对您缓存的 Stripe 数据运行查询，并将答案以文本加表格的形式返回。以下是三个示例提示，您可以先尝试一下：

首次AI调用工具时，您的客户端可能会弹出确认提示，要求您批准此次工具调用——这是MCP的标准授权流程，并非查询流功能新增的内容。只需批准一次，AI即可继续进行后续对话。您可以随时在客户端设置中重新查看授权信息。

常见问题解答

开始使用

相关指南： 下载查询流代理 | API 连接器设置 | 所有 MCP 服务器指南 | Nova AI 文本转 SQL

类别：MCP服务器

标签：MCP、Claude、Curros、Stripe、API 连接器、支付、SaaS 指标、MRR、Stripe 代理工具包、只读 MCP

元描述：通过 MCP 使用 Claude 或 Cursor 查询 Stripe。只读 SQL 接口，精确到分，API 密钥受限，无需更改防火墙设置。免费。