连接 Agent
三步完成连接
1
创建 Developer API Key
登录网页端,打开 设置 → API 与 MCP,为你的助手创建一个专用密钥:
需要增删改查订阅时选择 读写;仅用于查询与支出分析时选择 仅读取。
完整的
subm_… 密钥只展示一次,且不会自动过期(除非手动撤销)。2
复制给 Agent(或复制手动配置片段)
选择 MCP · 推荐 或 仅使用 API,点击 复制给 Agent。
默认提示词不包含密钥;刚创建密钥后,也可以勾选 在本次复制中附带新建密钥 粘贴给你信任的 Agent。
如果你想手动写入客户端配置文件,展开同一卡片下方的 手动配置客户端 即可直接复制 Claude Code、Claude Desktop、Cursor 和 Codex 的配置片段。
3
验证连接
让 Agent 列出你的订阅以验证连通性(只读查询,不会写入测试垃圾数据;空列表同样代表连接成功)。
你也可以在 设置 → API 与 MCP 页脚直接点击 测试 API 连接 校验新密钥或已保存的密钥——测试成功后会立即刷新该密钥的最近使用时间。
- “未来 14 天有哪些订阅或免费试用要到期?”
- “按币种和分类汇总我每月的订阅支出。”
- “帮我添加 ChatGPT Plus,每月 $20,下次续费 2026-07-17。”(使用读写密钥时,Agent 会先总结变更并请你确认。)
- “删除重复的 Netflix 记录。”(使用读写密钥时,Agent 会先核对准确名称与
id。)
三种接入方式怎么选
[!TIP] 设置 → API 与 MCP 上的下载 MCP 仍提供兼容旧版的独立 npm 包(/downloads/subscription-manager-mcp.tgz)。对于绝大多数本地 stdio 客户端,直接下载单文件脚本(curl -fsSL https://steadyrenew.com/downloads/steadyrenew-mcp.mjs -o ~/.steadyrenew/mcp/steadyrenew-mcp.mjs)更轻量,也能避免 npm workspace 安装报错。
套餐限额与权限边界
- 配额与有效期限:Free 与 Premium 账户默认均为最多 5 个有效密钥、每账户每分钟 60 次请求(多密钥共享),且密钥永不自动过期。
- 只读密钥感知:创建时选择仅读取会生成
["read"]密钥,复制给 Agent 也会自动生成只读引导说明,避免 Agent 尝试写操作。 - 高级版分析工具:
get_spend_summary在所有套餐下均可用;find_duplicate_subscriptions与get_optimization_suggestions需终身高级版(Free 账户返回403 premium_required)。 - 仅限网页端管理的操作:删除追踪记录绝不会替你在商户处退订真实扣款;Bark 推送 URL、测试推送、
timeZone、locale和分类目录管理仍在网页端完成(见续费提醒指南)。
常见问题排查
面向 Agent 的机器可读入口
以下路径均挂载在应用主域名下(生产环境为https://steadyrenew.com):
/api/mcp:无状态远程 Streamable HTTP MCP 端点(使用 Bearersubm_…发送POST请求)。/downloads/steadyrenew-mcp.mjs:零依赖单文件本地 stdio MCP 脚本。/downloads/subscription-manager-mcp.tgz:独立 npm.tgzMCP 安装包。/agent/setup.md:完整的 Agent 接入、客户端配置与错误恢复指南。/agent/ai-tools.json:包含风险等级与写确认规则的 11 个工具 JSON 定义。/agent/openapi.yaml:/api/v1/*开放 API 的 OpenAPI 3.1 规范。