客户数据管理服务

ChartMogul的MCP服务器提供全面的客户数据管理功能,包括客户管理、销售CRM、订阅计划和数据分析,适用于企业客户关系管理和财务分析。

  • by chartmogul
  • Python
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 chartmogul/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
  2. 添加以下内容:

{
  "mcpServers": {
    "mcp-chartmogul": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/local/chartmogul-mcp-server",
        "run",
        "main.py"
      ],
      "env": {
        "CHARTMOGUL_TOKEN": "<YOUR-CHARTMOGUL-TOKEN>"
      }
    }
  }
}
  1. 跑 which uv 查找以下命令项 uv 并将其替换为指向的绝对路径 uv 可执行。

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

发展

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

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

CHARTMOGUL_TOKEN=<YOUR-CHARTMOGUL-TOKEN>
  1. 安装 uv 按照指示 这里.

  2. 跑 uv sync 安装依赖项。

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

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

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