ChartMogul MCP Server

ChartMogul的MCP服务器

支持的工具

帐户和数据源

• retrieve_account -获取帐户信息
• list_sources -列出所有具有可选筛选功能的数据源
• retrieve_source -通过UUID获取特定数据源

客户管理

• list_customers -列出具有筛选选项的客户
• search_customers -通过电子邮件搜索客户
• retrieve_customer -通过UUID获取客户
• create_customer -创建新客户
• update_customer -更新客户属性
• list_customer_subscriptions -获取客户的订阅
• list_customer_activities -获取客户活动
• list_customer_attributes -获取客户属性
• add_customer_tags -为客户添加标签
• add_customer_custom_attributes -为客户添加自定义属性

联系人

• list_contacts -列出所有联系人
• retrieve_contact -通过UUID获取联系人
• create_contact -创建新联系人
• update_contact -更新联系信息

客户备注

• list_customer_notes -列出客户备注和电话
• retrieve_customer_note -通过UUID获取特定注释
• create_customer_note -创建新笔记或通话记录
• update_customer_note -更新现有注释

销售与客户关系管理

• list_opportunities -列出销售机会
• retrieve_opportunity -通过UUID获取机会
• create_opportunity -创造新机会
• update_opportunity -更新商机详细信息
• list_tasks -列出客户任务
• retrieve_task -按UUID获取任务
• create_task -创建新任务
• update_task -更新任务信息

计划

• list_plans -列出订阅计划
• retrieve_plan -按UUID获取计划
• create_plan -创建新计划
• update_plan -更新计划详细信息
• list_plan_groups -列出计划组
• retrieve_plan_group -按UUID获取计划组
• create_plan_group -创建新计划组
• update_plan_group -更新计划组
• list_plan_group_plans -在组中列出计划

分析和指标

• all_metrics -获取所有关键指标（MRR、ARR、ARPA、ASP、客户数量、流失率、LTV）
• mrr_metrics -获取每月经常性收入指标
• arr_metrics -获取年度运行率指标
• arpa_metrics -获取每个账户的平均收入指标
• asp_metrics -获取平均销售价格指标
• customer_count_metrics -获取客户数量指标
• customer_churn_rate_metrics -获取客户流失率指标
• mrr_churn_rate_metrics -获取MRR流失率指标
• ltv_metrics -获取客户终身价值指标

数据操作

• list_subscription_events -列出订阅事件
• create_subscription_event -创建新的订阅事件
• update_subscription_event -更新订阅事件详细信息
• list_invoices -列出带有过滤功能的发票
• import_invoices -创建新发票
• retrieve_invoice -按UUID获取发票
• list_activities -列出业务活动（新业务、扩张、流失等）

用法

1. 打开位于以下位置的Claude Desktop配置文件：

- 在macOS上： ~/Library/Application Support/Claude/claude_desktop_config.json - 在Windows上： %APPDATA%/Claude/claude_desktop_config.json

1. 添加以下内容：

{
  "mcpServers": {
    "mcp-chartmogul": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/local/chartmogul-mcp-server",
        "run",
        "main.py"
      ],
      "env": {
        "CHARTMOGUL_TOKEN": ""
      }
    }
  }
}

1. 跑 which uv 查找以下命令项 uv 并将其替换为指向的绝对路径 uv 可执行。

1. 重新启动Claude Desktop以应用更改。

发展

1. 跑 cp example.env .env 在存储库的根目录中创建 .env 文件。

1. 用以下env变量更新它。

CHARTMOGUL_TOKEN=

1. 安装 uv 按照指示 这里.

1. 跑 uv sync 安装依赖项。

1. 跑 source .venv/bin/activate 以激活所创建的虚拟环境。

1. 跑 mcp dev main.py:cm_mcp 启动开发MCP服务器。此命令需要安装Node.js和npm。

1. 检查并连接到MCP服务器http://127.0.0.1:6274