关于 Paydirt
Paydirt MCP 让编码 Agent 在 iOS 应用中安装和管理 Paydirt 反馈表单,包括取消订阅和功能建议流程。它还可将回复发送到 Slack 或 Agent,并提供原始反馈和摘要的只读访问。
主要功能
- 01在 iOS 项目中安装 Paydirt SDK
- 02创建和管理反馈表单
- 03将回复路由到 Slack 或 Agent
- 04读取原始回复和反馈摘要
- 05支持订阅取消反馈
适用场景
- 01为 iOS 应用添加功能建议和取消表单
- 02将取消反馈与功能建议分流到不同 Slack 频道
- 03在编码 Agent 工作流中查看收到的回复
MCP 相关
提供 Paydirt 设置、应用和表单管理、Slack 路由、回复读取及反馈摘要工具。支持托管 Streamable HTTP 端点和本地 stdio 服务。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
23收录的工具列表 · 更新于 3 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| app_name | string | 否 | 设置期间要复用或创建的首选应用名称 |
| bundle_id | string | 否 | 设置期间要匹配的首选 iOS bundle ID |
| use_cases | array | 否 | 要安装的已确认反馈体验。推荐方案为 Suggest a Feature,以及在存在订阅时提供试用和付费取消体验。 |
| session_id | string | 否 | 首次调用返回的设置会话。存在此值时,此调用的行为与 paydirt_finish_setup 相同。 |
| app_description | string | 否 | 创建或修复设置时要保存的可选应用描述 |
| uses_revenuecat | boolean | 否 | 已弃用的兼容性输入。请改用 subscription_provider。 |
| feature_placement | string | 否 | 开发者确认的 Suggest a Feature 放置位置,例如设置页面或 after_successful_export。默认为设置页面。 |
| form_plan_confirmed | boolean | 否 | 仅当开发者确认取消订阅、Suggest a Feature 或自定义表单方案后,才设为 true。未经确认,设置流程会返回简洁的确认提示,不会启动授权。 |
| subscription_provider | enum | 否 | 在宿主应用中发现的订阅事实来源。仅当设置前无法确定时才使用 auto。auto | none | storekit | revenuecat | superwall | custom |
| subscription_product_ids | array | 否 | 原生 StoreKit 自动续订产品 ID。完整的 storekit 集成必需此项。 |
详细介绍
Paydirt MCP
MCP Registry 名称:io.github.Paydirt-AI/paydirt-mcp
Paydirt 的 Agent 原生安装器和控制平面。Paydirt 是一款 iOS SDK,用于建议新功能、取消试用和取消订阅。
Paydirt MCP 可让编码 Agent 在聊天中将 Paydirt 添加到 iOS 应用:提议并创建表单,将 SDK 密钥写入项目,构建并启动应用,同时打开 Debug 设置检查,将回复路由到 Slack 和 Agent,并读取原始反馈。Paydirt 支持原生 StoreKit、RevenueCat、Superwall、应用自有的账单系统,以及没有订阅的应用。
安装
任选一种。托管服务是首选方式:使用 Google 登录一次,无需再粘贴密钥。
Claude Code 插件(包含安装技能):
/plugin marketplace add Paydirt-AI/paydirt-mcp
/plugin install paydirt@paydirt-plugins
Claude Code,托管服务:
claude mcp add --transport http paydirt https://mcp.paydirt.ai/mcp
Codex,托管服务:
codex mcp add paydirt --url https://mcp.paydirt.ai/mcp
备用方式,本地 stdio(任意 MCP 宿主;Node.js 18 或更高版本):
npx -y paydirt-mcp
{
"mcpServers": {
"paydirt": {
"command": "npx",
"args": ["-y", "paydirt-mcp"]
}
}
}
当前的 Codex 桌面版本可能需要重启,新添加的 MCP 服务才会出现。这只是一次性的工具发现刷新,并非 Paydirt 的要求。
首次运行
请这样说:
将 Paydirt 添加到此应用。设置取消反馈和建议新功能。
- 连接。 Agent 宿主会打开浏览器标签页:使用 Google 继续,然后点击 Allow。标签页会提示你返回 Agent。无需密钥。
- 提出一个方案。 Agent 检查项目并发送一条消息:包含“取消订阅”“取消试用”和“建议新功能”,指出真实取消流程所在的文件,并说明回复将发送到 Slack 和 Agent。回复“yes”,或选择仅发到 Slack、仅发到这里,或删除某个表单。如果没有订阅,Agent 会说明取消反馈目前没有触发条件,并建议仅设置“建议新功能”。确认之前不会创建任何内容。
- 实时演示。 Agent 创建应用和表单,保存你的反馈目的地;如果你选择了 Slack,Agent 会在继续工作的同时分享 Slack 链接。Agent 会添加 SDK,将密钥写入项目,添加一个首次启动时打开的 Debug 设置检查,然后构建并启动应用。
- Slack 路由。 在 Slack 的 Allow 页面授权后,Agent 会列出你的频道,并在聊天中提出路由方案,例如将取消反馈发送到一个频道,将功能建议发送到另一个频道。你确认后,Agent 会保存路由设置。
- 收到首条回复。 通过语音或文本提交一条测试回复。Agent 已通过
paydirt_wait_for_response等待,并会在回复到达时通知你。
现有反馈页面和购买流程都会保留。如果回复发送到编码 Agent,系统会提供每日只读简报。
使用本地 stdio 服务时,paydirt_begin_setup 会返回一个仅用于登录的 authorization_url,而 paydirt_finish_setup 会返回相同的安装约定。MCP 进程不会打开浏览器、休眠或轮询;唯一有时限的等待是 paydirt_wait_for_response(最长 90 秒)。paydirt_setup 仍作为兼容性别名保留。
本地凭据以仅所有者可访问的权限保存在 ~/.paydirt/credentials.json。它们不会写入应用仓库,也不会发送到 api.paydirt.ai 以外的任何位置。对于临时环境,请改为设置 PAYDIRT_AUTH_TOKEN。
每日反馈简报
paydirt_get_feedback_digest 会返回一份只读周期摘要,适用于计划任务:已完成回复总数、“建议新功能”、“取消试用”、“取消订阅”、其他反馈、与前一个等长周期相比的变化,以及简明要点。没有新反馈的日期会明确报告零。简报不会创建编码任务,也不会自动修改应用。
自然语言 Agent 工作流
在应用内的操作位置添加表单
请执行:
在导出成功后添加一个标题为“Export Feedback”的反馈表单,并发送到 #product-feedback。
Agent 应使用 paydirt_add_feedback_form。它会复用标题规范化后相同的现有自定义表单,保留请求的放置位置,在可能时解析 Slack,并返回准确的 Swift 展示调用。只有在 Agent 编辑并构建宿主应用后,远程表单才会被视为已安装。
支持的触发条件包括用户点击、应用内操作成功、屏幕显示,以及应用自有的自定义条件。
安装取消反馈
Agent 会在设置前检查应用,并选择现有的订阅事实来源:
- 原生 StoreKit 使用 Paydirt 内置的 StoreKit 集成。
- RevenueCat 使用安装程序管理的兼容性源和常见的
Paydirt.enableRevenueCatIntegration(...)调用,避免重复添加软件包依赖。 - 原生 StoreKit 支持常规 App Store 订阅,包括仅使用 Superwall 作为付费墙的应用。
- 应用自有的计费系统会发出与提供商无关的取消事件。
- 没有订阅功能的应用可以仅安装手动反馈。
Agent 必须保留宿主应用中所有现有的反馈表单、按钮、屏幕、处理程序、目标位置和副作用。只有在用户明确请求特定位置时,才可以添加或更改常规反馈。如果请求的取消桥接无法实现,Agent 会说明具体的提供商限制,保留应用现有行为,并完成所有不受影响的已请求表单。
RevenueCat 版本较旧并不构成障碍。Agent 会保留已安装的版本,并调整由安装程序管理的集成源,以适配应用中已能编译的 customer-info 或 purchaser-info API。可以省略较新的可选元数据,也可以从应用现有的 RevenueCat 取消确认路径调用 Paydirt。
将反馈发送至 Slack 和编码 Agent
对话结束后,Slack 会收到一条消息,其中包含准确的原始问题和答案。原始对话之后可以附加可选的 AI 摘要。编码 Agent 工具以只读方式提供回复;Paydirt 不会自动根据反馈采取行动。
工具
| 工具 | 用途 |
|---|---|
paydirt_begin_setup | 开始非阻塞式浏览器授权 |
paydirt_finish_setup | 检查一次授权并返回安装契约 |
paydirt_setup | 向后兼容的开始/完成别名 |
paydirt_add_feedback_form | 创建或复用命名表单,并返回其在宿主应用中的放置契约 |
paydirt_list_apps、paydirt_create_app、paydirt_get_app、paydirt_update_app | 管理应用 |
paydirt_list_forms、paydirt_create_form、paydirt_get_form、paydirt_update_form、paydirt_toggle_form、paydirt_delete_form | 管理表单 |
paydirt_get_responses | 使用稳定游标读取原始对话 |
paydirt_get_summary、paydirt_ask | 读取可选的 AI 分析 |
paydirt_set_delivery | 保存回复的接收位置:Slack、编码 Agent,或两者 |
paydirt_connect_slack、paydirt_slack_status、paydirt_list_slack_channels、paydirt_set_slack_channels | 连接 Slack 并为取消反馈和功能建议设置路由 |
paydirt_set_form_channel | 将一个自定义表单路由到专属频道 |
paydirt_wait_for_response | 等待首条测试回复,最长 90 秒 |
paydirt_health_check | 验证 API 连通性和凭据 |
开发
npm ci
npm test
npm pack --dry-run
此代码仓库有意仅包含公开的 MCP 客户端。Paydirt 的 API、仪表板、基础设施和运维配置仍为私有。
官方 MCP Registry 元数据位于 .mcp/server.json。其中列出了 npm stdio 包和托管的 Streamable HTTP 端点 https://mcp.paydirt.ai/mcp。
如需支持,请参阅 SUPPORT.md;报告漏洞前,请参阅 SECURITY.md;提交拉取请求前,请参阅 CONTRIBUTING.md。
许可证
托管传输
同一软件包还包含经过身份验证的 Streamable HTTP 服务,地址为
https://mcp.paydirt.ai/mcp。有关部署、
OAuth 配置、会话隔离和发布验证,请参阅 HOSTED.md。发现元数据
位于 https://mcp.paydirt.ai/.well-known/oauth-protected-resource/mcp。
仅能访问健康状态或元数据端点,并不能验证经过身份验证的工具调用。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。