关于 churnkey
Churnkey 的 MCP 服务,允许 Claude、Cursor 等 AI Agent 通过数据 API 密钥查询取消流程会话、分析数据和 DSR 信息。适合需要分析订阅流失与挽留的团队。
主要功能
- 01查询取消流程会话记录
- 02读取留存与分析指标
- 03访问 DSR 相关数据
- 04基于数据 API 密钥访问
适用场景
- 01让 AI Agent 查询近期的订阅取消会话
- 02分析用户流失与挽留相关指标
MCP 相关
该项目是 MCP 服务,通过 @churnkey/mcp 包向 Claude、Cursor 等 MCP 客户端提供对 Churnkey 数据的查询能力。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
服务地址
https://mcp.churnkey.co/mcp一键复制安装命令
Claude CodeTerminal
claude mcp add --transport http co-churnkey-churnkey https://mcp.churnkey.co/mcpCursor.cursor/mcp.json
{"mcpServers":{"co-churnkey-churnkey":{"type":"http","url":"https://mcp.churnkey.co/mcp"}}}在 Cursor 中打开VS Code.vscode/mcp.json
{"servers":{"co-churnkey-churnkey":{"type":"http","url":"https://mcp.churnkey.co/mcp"}}}在 VS Code 中打开Claude Desktopclaude_desktop_config.json
{"mcpServers":{"co-churnkey-churnkey":{"type":"http","url":"https://mcp.churnkey.co/mcp"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"co-churnkey-churnkey":{"serverUrl":"https://mcp.churnkey.co/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Churnkey SDK
适用于 React 的生产就绪取消流程。开源。可选连接到 Churnkey,用于分析和 AI 驱动的留存。
软件包
| 软件包 | 描述 |
|---|---|
@churnkey/react | 取消流程。可直接使用组件、无头钩子或核心状态机。支持 React 18 和 19。 |
@churnkey/node | 服务端令牌生成。仅当由 Churnkey 为你处理账单操作,或你使用托管嵌入时才需要。 |
@churnkey/mcp | Model Context Protocol 服务。让 Claude、Cursor 和其他 AI Agent 使用 Data API 密钥查询你的 Churnkey 数据(会话、分析、DSR)。 |
快速开始
npm install @churnkey/react
import { CancelFlow } from '@churnkey/react'
import '@churnkey/react/styles.css'
<CancelFlow
steps={[
{
type: 'survey',
title: 'Why are you leaving?',
reasons: [
{
id: 'expensive',
label: 'Too expensive',
offer: { type: 'discount', couponId: 'STRIPE_SAVE20', percentOff: 20, durationInMonths: 3 },
},
{ id: 'not-using', label: 'Not using it enough', offer: { type: 'pause', months: 2 } },
{ id: 'missing', label: 'Missing features' },
],
},
{ type: 'feedback', title: 'Anything else?' },
{ type: 'confirm' },
]}
handleDiscount={async (offer) => myBilling.applyCoupon(offer.couponId)}
handlePause={async (offer) => myBilling.pause({ months: offer.result?.months ?? offer.months })}
handleCancel={async () => myBilling.cancel()}
onClose={() => setOpen(false)}
/>
文档和资源
@churnkey/react— 完整 API 参考、自定义配置、无头用法、自定义步骤类型@churnkey/node—createToken和authHash@churnkey/mcp— 面向 Claude / Cursor / Claude Desktop 的 MCP 服务- 创建免费的 Churnkey 账户 — 获取用于分析的
appId - churnkey.co — 仪表板、托管嵌入、AI 留存功能
仓库布局
sdk/
├── packages/
│ ├── react/ @churnkey/react
│ ├── node/ @churnkey/node
│ └── mcp/ @churnkey/mcp
├── apps/
│ └── playground/ internal dev playground
└── scripts/ release + tooling helpers
本地开发
pnpm install
pnpm --filter @churnkey/react build
pnpm --filter @churnkey/react test
针对 playground 进行开发:
pnpm --filter @churnkey/react dev # rebuilds on change
pnpm --filter @churnkey/playground dev # runs the playground app
许可证
MIT
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。