by 运行时依赖
安装命令
点击复制技能文档
Chartmogul 是一个订阅分析平台。它帮助 SaaS 业务跟踪和分析关键指标，如 MRR、流失率和客户生命周期价值。它被财务和产品团队用来理解和优化他们的订阅收入。官方文档：https://dev.chartmogul.com/
Chartmogul 概述 客户 订阅 发票 数据源 计划 指标 标签 用户
使用 Chartmogul 本技能使用 Membrane CLI 与 Chartmogul 交互。Membrane 处理身份验证和凭证刷新，因此您可以专注于集成逻辑而不是身份验证。
安装 CLI 安装 Membrane CLI，以便您可以从终端运行 membrane： npm install -g @membranehq/cli@latest
身份验证 membrane login --tenant --clientName= 这将打开浏览器进行身份验证或在控制台打印授权 URL，具体取决于是否可用交互模式。
无头环境：
命令将打印授权 URL。要求用户在浏览器中打开它。
当他们完成登录后看到代码时，完成以下操作：
membrane login complete
将 --json 添加到任何命令以获取机器可读的 JSON 输出。
代理类型：
claude、openclaw、codex、warp、windsurf 等。这些将用于调整工具以最好地适应您的工具包。
连接到 Chartmogul
使用 membrane connection ensure 通过应用程序 URL 或域名查找或创建连接：
membrane connection ensure "https://chartmogul.com/" --json
用户在浏览器中完成身份验证。
输出包含新的连接 ID。
这是获取连接的最快方式。
URL 被归一化为域名并与已知应用程序匹配。如果找不到应用程序，则创建一个应用程序并自动构建连接器。
如果返回的连接具有状态：“READY”，则跳转到步骤 2。
1b. 等待连接就绪
如果连接处于 BUILDING 状态，请轮询直到它准备就绪：
npx @membranehq/cli connection get --wait --json
--wait 标志长时间轮询（最多 --timeout 秒，默认 30）直到状态更改。
继续轮询直到状态不再是 BUILDING。
结果状态告诉您下一步该做什么：
READY — 连接已完全设置。跳转到步骤 2。
CLIENT_ACTION_REQUIRED — 用户或代理需要执行某个操作。
clientAction 对象描述了所需的操作：
clientAction.type — 所需操作的类型：
“connect” — 用户需要身份验证（OAuth、API 密钥等）。
“provide-input” — 需要更多信息（例如要连接到的应用程序）。
clientAction.description — 人类可读的对所需操作的解释。
clientAction.uiUrl（可选） — 用户可以完成操作的预建 UI 的 URL。
当存在时将其显示给用户。
clientAction.agentInstructions（可选） — AI 代理如何以编程方式继续的说明。
在用户完成操作（例如在浏览器中身份验证）后，再次使用 membrane connection get --json 轮询以检查状态是否已移动到 READY。
CONFIGURATION_ERROR 或 SETUP_FAILED — 出错了。
检查错误字段以获取详细信息。
搜索操作
使用自然语言描述您要执行的操作来搜索：
membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json
您应该始终在特定连接的上下文中搜索操作。
每个结果包括 id、name、description、inputSchema（操作接受的参数）和 outputSchema（操作返回的内容）。
热门操作
名称 密钥 描述
列出客户 list-customers 从您的 ChartMogul 账户中检索客户列表，具有可选筛选。
列出计划 list-plans 检索订阅计划列表。
列出联系人 list-contacts 检索联系人列表，具有可选筛选。
列出任务 list-tasks 检索任务列表，具有可选筛选。
列出机会 list-opportunities 检索销售机会列表，具有可选筛选。
列出发票 list-invoices 检索发票列表，具有可选筛选。
获取客户 get-customer 通过 ChartMogul UUID 检索单个客户。
获取计划 get-plan 通过 UUID 检索单个计划。
获取联系人 get-contact 通过 UUID 检索单个联系人。
获取任务 get-task 通过 UUID 检索单个任务。
获取机会 get-opportunity 通过 UUID 检索单个销售机会。
创建客户 create-customer 在 ChartMogul 中创建新客户。
创建计划 create-plan 创建新订阅计划。
创建联系人 create-contact 为客户创建新联系人。
创建任务 create-task 为客户创建新任务。
创建机会 create-opportunity 创建新销售机会。
更新客户 update-customer 更新 ChartMogul 中的现有客户。
更新计划 update-plan 更新现有计划。
更新联系人 update-contact 更新现有联系人。