mcp-chargebee

@codespar/mcp-chargebee

Chargebee 向け MCP サーバー — グローバルなサブスクリプション課金のオーケストレーション

CodeSpar カタログに Chargebee がある理由

Chargebee は、決済ゲートウェイ（Stripe、Adyen、Braintree、ラテンアメリカ地域のローカルアクワイアラー）上でサブスクリプション課金をオーケストレーションします。プラン、日割り計算、督促、税金、収益認識を処理する、カード処理層ではなく SaaS の収益化レイヤーです。

CodeSpar カタログでは、ブラジルを拠点とする継続課金サービスとして、すでにVindiとIuguを提供しています。Chargebee はこれらを補完するものであり、機能が重複するものではありません。Platzi、Truora、およびラテンアメリカ市場に進出している大半の米国 SaaS 企業が採用する、グローバル SaaS のパターンです。機能の重複はなく、対象市場も異なります。

クイックスタート

Claude Desktop

~/.config/claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "chargebee": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-chargebee"],
      "env": {
        "CHARGEBEE_SITE": "your-site",
        "CHARGEBEE_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

claude mcp add chargebee -- npx @codespar/mcp-chargebee

Cursor / VS Code

.cursor/mcp.json または .vscode/mcp.json に追加します。

{
  "servers": {
    "chargebee": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-chargebee"],
      "env": {
        "CHARGEBEE_SITE": "your-site",
        "CHARGEBEE_API_KEY": "your-api-key"
      }
    }
  }
}

ツール（15）

ツール	目的
create_subscription	Chargebee に新しいサブスクリプションを作成します。
retrieve_subscription	ID でサブスクリプションを取得します
update_subscription	サブスクリプションを更新します。
cancel_subscription	サブスクリプションをキャンセルします。
reactivate_subscription	キャンセルまたは一時停止されたサブスクリプションを再開します
list_subscriptions	サブスクリプションを一覧表示します。
create_customer	Chargebee に顧客を作成します。
retrieve_customer	ID で顧客を取得します
update_customer	顧客を更新します。
list_customers	顧客を一覧表示します。
retrieve_invoice	ID で請求書を取得します
list_invoices	オプションのフィルターを指定して請求書を一覧表示します
create_payment_source_using_token	ゲートウェイトークン（例：）を使用して顧客に決済ソースを追加します
delete_payment_source	決済ソースを削除します
list_events	Webhook イベントを一覧表示します。

認証

Chargebee API v2 は、API キーをユーザー名、空のパスワードとして使用する HTTP Basic 認証を採用しています。このパッケージが自動的に処理するため、CHARGEBEE_API_KEY を設定するだけで利用できます。

リクエスト本文は application/x-www-form-urlencoded（Chargebee v2 の規約）で送信されます。ネストされたオブジェクトと配列は、parent[child]=value / parent[0][child]=value の形式にフラット化されます。

フィルター構文

Chargebee のリストフィルターでは、field[operator]=value の形式を使用します。たとえば、status[is]=active、email[is][email protected]、occurred_at[after]=1700000000 です。

任意の list_* ツールで filters オブジェクトにこれらを渡します。

{
  "filters": {
    "status[is]": "active",
    "plan_id[is]": "pro-monthly"
  }
}

よく使うリストフィルターは、トップレベルの簡易パラメーターとしても利用できます（例：list_invoices では customer_id と status を直接指定できます）。

環境変数

変数	必須	説明
CHARGEBEE_SITE	はい	サイトのサブドメイン。例：acme-test.chargebee.com の場合は acme-test
CHARGEBEE_API_KEY	はい	Settings > API Keys で取得する API キー（フルアクセスまたは制限付き）

サンドボックス / テスト

Chargebee のすべてのアカウントには、無料のテストサイト（<your-site>-test.chargebee.com）が含まれます。開発にはその API キーを使用してください。実際の決済ゲートウェイに課金が送信されることはありません。

認証情報の取得

1. chargebee.com で登録します
2. テストサイト（<name>-test）が自動的に作成されます
3. Settings > API Keys に移動し、Full-Access または Read-Only キーを作成します
4. CHARGEBEE_SITE と CHARGEBEE_API_KEY を設定します

ロードマップ

v0.2（予定）

• create_invoice — サブスクリプション外で顧客に請求します
• record_payment — オフライン決済を記録します
• create_coupon / list_coupons
• create_plan / list_plans / create_addon
• list_transactions

v0.3（予定）

• create_hosted_page_checkout — Chargebee のホスト型チェックアウト URL を生成します
• retrieve_quote / convert_quote
• 収益レポート用ヘルパー

もっと早くツールが必要ですか？Issue を作成するか、PRを送ってください。

リンク

• Chargebee のウェブサイト
• Chargebee API ドキュメント
• MCP Dev LATAM
• ランディングページ

エンタープライズ

エージェントが開始したサブスクリプション変更に対するガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、決済ルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT