mcpField
P
Paydirt

Paydirt

本地服务
github.com/Paydirt-AI开发工具02 周前更新

关于 Paydirt

Paydirt MCP 让编码 Agent 在 iOS 应用中安装和管理 Paydirt 反馈表单,包括取消订阅和功能建议流程。它还可将回复发送到 Slack 或 Agent,并提供原始反馈和摘要的只读访问。

主要功能

  1. 01在 iOS 项目中安装 Paydirt SDK
  2. 02创建和管理反馈表单
  3. 03将回复路由到 Slack 或 Agent
  4. 04读取原始回复和反馈摘要
  5. 05支持订阅取消反馈

适用场景

  1. 01为 iOS 应用添加功能建议和取消表单
  2. 02将取消反馈与功能建议分流到不同 Slack 频道
  3. 03在编码 Agent 工作流中查看收到的回复

MCP 相关

提供 Paydirt 设置、应用和表单管理、Slack 路由、回复读取及反馈摘要工具。支持托管 Streamable HTTP 端点和本地 stdio 服务。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"paydirt-ai-paydirt": {
"command": "npx",
"args": [
"-y",
"paydirt-mcp"
]
}
}
}
启动命令npx -y paydirt-mcp

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmpaydirt-mcp2.3.0

工具

23

收录的工具列表 · 更新于 3 周前

参数类型必填说明
app_namestring否设置期间要复用或创建的首选应用名称
bundle_idstring否设置期间要匹配的首选 iOS bundle ID
use_casesarray否要安装的已确认反馈体验。推荐方案为 Suggest a Feature,以及在存在订阅时提供试用和付费取消体验。
session_idstring否首次调用返回的设置会话。存在此值时,此调用的行为与 paydirt_finish_setup 相同。
app_descriptionstring否创建或修复设置时要保存的可选应用描述
uses_revenuecatboolean否已弃用的兼容性输入。请改用 subscription_provider。
feature_placementstring否开发者确认的 Suggest a Feature 放置位置,例如设置页面或 after_successful_export。默认为设置页面。
form_plan_confirmedboolean否仅当开发者确认取消订阅、Suggest a Feature 或自定义表单方案后,才设为 true。未经确认,设置流程会返回简洁的确认提示,不会启动授权。
subscription_providerenum否在宿主应用中发现的订阅事实来源。仅当设置前无法确定时才使用 auto。auto | none | storekit | revenuecat | superwall | custom
subscription_product_idsarray否原生 StoreKit 自动续订产品 ID。完整的 storekit 集成必需此项。

详细介绍

Paydirt MCP

CI npm License: MIT

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 添加到此应用。设置取消反馈和建议新功能。

  1. 连接。 Agent 宿主会打开浏览器标签页:使用 Google 继续,然后点击 Allow。标签页会提示你返回 Agent。无需密钥。
  2. 提出一个方案。 Agent 检查项目并发送一条消息:包含“取消订阅”“取消试用”和“建议新功能”,指出真实取消流程所在的文件,并说明回复将发送到 Slack 和 Agent。回复“yes”,或选择仅发到 Slack、仅发到这里,或删除某个表单。如果没有订阅,Agent 会说明取消反馈目前没有触发条件,并建议仅设置“建议新功能”。确认之前不会创建任何内容。
  3. 实时演示。 Agent 创建应用和表单,保存你的反馈目的地;如果你选择了 Slack,Agent 会在继续工作的同时分享 Slack 链接。Agent 会添加 SDK,将密钥写入项目,添加一个首次启动时打开的 Debug 设置检查,然后构建并启动应用。
  4. Slack 路由。 在 Slack 的 Allow 页面授权后,Agent 会列出你的频道,并在聊天中提出路由方案,例如将取消反馈发送到一个频道,将功能建议发送到另一个频道。你确认后,Agent 会保存路由设置。
  5. 收到首条回复。 通过语音或文本提交一条测试回复。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。

许可证

MIT

托管传输

同一软件包还包含经过身份验证的 Streamable HTTP 服务,地址为 https://mcp.paydirt.ai/mcp。有关部署、 OAuth 配置、会话隔离和发布验证,请参阅 HOSTED.md。发现元数据 位于 https://mcp.paydirt.ai/.well-known/oauth-protected-resource/mcp。 仅能访问健康状态或元数据端点,并不能验证经过身份验证的工具调用。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。