ChartMogul's 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 - 更新现有备注

销售和 CRM

• 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

2. 添加以下内容：

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

3. 运行 which uv 找到 uv 命令入口，并将其替换为 uv 可执行文件的绝对路径。

4. 重启 Claude Desktop 以应用更改。

开发

1. 在仓库根目录运行 cp example.env .env，创建 .env 文件。

2. 使用以下环境变量更新该文件。

CHARTMOGUL_TOKEN=<YOUR-CHARTMOGUL-TOKEN>

3. 按照此处的说明安装 uv。

4. 运行 uv sync 安装依赖项。

5. 运行 source .venv/bin/activate 激活创建的虚拟环境。

6. 运行 mcp dev main.py:cm_mcp 启动开发用 MCP 服务。此命令需要安装 Node.js 和 npm。

7. 检查并连接 MCP 服务：http://127.0.0.1:6274