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 - ビジネスアクティビティ（new_biz、expansion、churn など）を一覧表示します

使用方法

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. http://127.0.0.1:6274 で MCP サーバーを確認し、接続します