Chartsy

面向 AI Agent 的 Chartsy

向你的 AI Agent 询问 SaaS 业务情况：MRR、客户流失率、收入、退款、有流失风险的客户、目标、网站流量和注册量。数据来自 Chartsy 的实时数据；Chartsy 可读取 Stripe、Paddle、Polar、Lemon Squeezy、Creem、Freemius 或自定义数据源。

此仓库打包了每种 Agent 安装所指向的内容：

• 托管的 Chartsy MCP 服务：https://mcp.chartsy.app/mcp。它使用可流式传输的 HTTP 和 OAuth 登录，且为只读。无需在本地安装或运行任何内容。
• chartsy skill（skills/chartsy/SKILL.md）。它会教 Agent 哪个工具能回答哪些问题、如何尽量减少工具调用次数，以及如何正确解读数据。
• chartsy-growth-loop skill （skills/chartsy-growth-loop/SKILL.md）。它会引导你的 Agent 完成每周循环：找出哪些渠道、营销活动和帖子带来了持续付费的客户，建议接下来应重点关注的方向，并撰写下周的帖子，附上带有 UTM 标记的链接。如果你也将发布工具的 MCP（例如 Postiz 或 Publer）连接到同一个 Agent，skill 会指示它将帖子保存为草稿，供你审核。Chartsy 本身为只读，绝不会发布任何内容。

用法： 每次工具调用都会计为一个 ChartsyAI 问题，并从套餐的每月额度中扣除，与在 Chartsy 内提问使用的是同一额度。skill 会尽可能引导 Agent 通过一次调用作答（get_business_snapshot、get_daily_snapshot）。

你需要： 一个 Chartsy 账户（任何套餐均可，包括免费试用），并已连接和同步支付服务商。

---

安装

Claude（claude.ai、桌面端、移动端）

Settings → Connectors → Add custom connector，然后粘贴 https://mcp.chartsy.app/mcp 并登录 Chartsy。

Claude Code

插件（MCP 服务和 skill）：

/plugin marketplace add sprifti/chartsy-agent
/plugin install chartsy@chartsy

或者只添加服务：

claude mcp add --transport http -s user chartsy https://mcp.chartsy.app/mcp

然后运行 /mcp 登录。

Cursor

添加到 Cursor。 或者前往 Settings → MCP → Add server，选择类型 HTTP，并使用 URL https://mcp.chartsy.app/mcp。

ChatGPT

Settings → Connectors（Developer mode）→ 添加 https://mcp.chartsy.app/mcp 并登录 Chartsy。

Gemini CLI

gemini extensions install https://github.com/sprifti/chartsy-agent

Codex、OpenClaw 和其他支持 skill 的 Agent

npx skills add sprifti/chartsy-agent

skill 需要在同一个 Agent 中连接 MCP 服务。在该 Agent 的 MCP 设置中添加 https://mcp.chartsy.app/mcp。

任何其他 MCP 客户端

使用 mcp.json，或将客户端指向 https://mcp.chartsy.app/mcp （可流式传输的 HTTP，OAuth 登录）。

仅能运行本地（stdio）服务的客户端

较旧的客户端无法直接连接托管服务。可通过 mcp-remote桥接，它会在浏览器中处理 OAuth 登录：

{
  "mcpServers": {
    "chartsy": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.chartsy.app/mcp"]
    }
  }
}

不通过浏览器运行的 Agent（服务、定时任务、CI）

OAuth 登录需要有人在浏览器中点击批准。对于无人值守运行的 Agent，例如 VPS 上的 OpenClaw、定时任务或 CI 流水线，请改用个人令牌：

1. 在 Chartsy 中，前往 Settings → Claude & MCP → Generate token。令牌只会显示一次，请立即复制。
2. 将其存储为机密（例如 CHARTSY_MCP_TOKEN）。切勿将其提交到代码库。
3. 在每次请求中发送令牌：

   Authorization: Bearer <your-token>
   

   例如，使用 Claude Code：

   claude mcp add --transport http -s user chartsy https://mcp.chartsy.app/mcp \
     --header "Authorization: Bearer $CHARTSY_MCP_TOKEN"
   

   或通过 mcp-remote：npx -y mcp-remote https://mcp.chartsy.app/mcp --header "Authorization: Bearer ${CHARTSY_MCP_TOKEN}"

令牌有效期为一年，可在同一标签页中撤销。无人值守的 Agent 与其他客户端一样会消耗 ChartsyAI 问题额度，每次工具调用消耗一个，因此请合理安排运行时间。每天调用一次 get_daily_snapshot，每天计为一个问题。

可询问的问题

• “给我一份完整的业务回顾。有哪些风险？”
• “我的业务昨天有什么变化？”
• “过去 6 个月，各套餐的 MRR 有什么变化？”
• “哪些客户有流失风险？”
• “哪个流量来源带来的注册转化率最高？”
• “根据上个月带来付费客户的渠道，规划下周的 X 帖子。”
• “Q1 我们退款了多少？哪个套餐的退款比例最高？”

工具

全部 19 个工具均为只读，且仅限于你登录账号所拥有的账户和网站。

类别	工具
一览	get_business_snapshot、get_daily_snapshot
收入	get_mrr、get_mrr_by_plan、get_mrr_by_country、get_revenue_breakdown、get_refund_summary、get_goal_progress
客户与流失	get_churn_rate、get_new_subscribers、list_at_risk_customers、list_top_customers、get_customer_concentration
网站流量	list_tracked_sites、get_site_traffic、get_traffic_sources、get_monthly_events_usage
营销 → 收入	get_revenue_by_source
账户	list_accounts

隐私

客户仅通过支付处理商 ID 进行识别。姓名和电子邮件永远不会离开 Chartsy。每次调用都会检查访问权限，因此撤销令牌或结束订阅会立即生效。政策：https://chartsy.app/privacy-policy

仓库布局

路径	用途
skills/chartsy/SKILL.md	所有支持技能的 Agent 的唯一真实来源
skills/chartsy-growth-loop/SKILL.md	每周以收入为导向的营销工作流：了解哪些渠道带来了付费客户，然后起草带有 UTM 标签的帖子
.claude-plugin/、.mcp.json	Claude Code 插件和市场
.cursor-plugin/	Cursor 插件和市场
gemini-extension.json	Gemini CLI 扩展
mcp.json	适用于其他客户端的通用 mcpServers 配置

发布时，请确保 .claude-plugin/、.cursor-plugin/ 和 gemini-extension.json 中的 version 保持一致。

支持：[email protected]

许可证

Copyright © 2026 Chartsy。保留所有权利。请参阅 LICENSE。你可以安装这些 文件，将自己的 Agent 连接到 Chartsy；除此之外，不授予任何其他权利。