ClaudeとChargebeeを連携する方法 — サブスク課金の顧客・請求データを会話で引く

Claude Chargebee連携とは — 何ができるか

ChargebeeコネクタはChargebee Incが提供するコネクタで、ディレクトリ上では「Anthropic verified」と表示されます。Chargebeeが保持する顧客・サブスクリプション・請求書・支払いのデータを、Claudeとの会話から引けるようになります。

コネクタページの説明では、更新リスク、支払い失敗の傾向、クレジットノートの抜け、請求周期ごとのLTV、トライアルからの転換率といった問いを自然言語で投げる用途が挙がっています。Chargebeeが決済イベント、プラン変更、請求書、解約理由を1つの関連したデータモデルに持っているので、これらを横断した質問が成り立つ、というのが提供元の説明です。

つなぐ先は収益チームの日常業務です。

• 顧客のメールアドレスから、契約中のプランと直近の請求状況を確認する
• ある請求書に紐づく支払い取引の成否を追う
• プランや価格設定の一覧を、更新前に見比べる

Chargebeeのドキュメントは、Claudeのほか、Cursor、ChatGPT、Codexなど、MCP対応のクライアントから同じサーバーに接続できると説明しています。Stripeの決済データをClaudeで扱う場合はClaude Stripe連携の設定方法にあります。ここではChargebeeの課金データに絞ります。

前提 — 必要なものと接続先URL

サインインは必須です。コネクタページには「Sign-in: Required」とあり、ChargebeeのBillingサイトのアカウントが要ります。Chargebeeのドキュメントによると、OAuth認証では、Claudeから届く範囲はサインインしたChargebeeユーザーのアクセスレベルまでに絞られます。

Chargebeeはデータセンターが3つに分かれていて、コネクタの接続先URLもリージョンごとです。

自分のサイトがどのデータセンターにあるかは、Chargebeeの管理画面で確認し、同じリージョンのURLを選びます。

claude.aiでChargebeeを接続する手順

ディレクトリからの追加手順は、他のコネクタと同じです。

1. claude.aiで「Customize」→「Connectors」を開く
2. ディレクトリからChargebeeを探し、追加する
3. Chargebee Billingのアカウントでサインインする
4. 表示された権限を確認して許可する

接続後は、チャット左下の「+」メニューから「Connectors」を開き、Chargebeeをオンにした会話で使えます。

Team・Enterpriseプランでは、先にOwnerまたはPrimary Ownerが組織でコネクタを有効にします。有効化しただけでは誰もアクセスできず、各メンバーがChargebeeで個別に認証します。コネクタ全般の仕組みはClaude Connectorsとはにまとめています。

Chargebee側のページには、ChatGPT向けにはリージョン別の接続リンクが3つ並び、Claude向けにはClaudeの設定からコネクタを追加するリンクが1つ置かれています。リージョン別のリンクが並ぶのはChatGPT向けだけです。Claude向けの1本のリンクがどのURLに接続するかは、ページに書かれていません。

45個のツールを役割で分ける

コネクタページには「Show all 45 tools」と表示されます。展開したツール名を役割で分けると、次の11の系統になります。

顧客の検索には、ID指定の取得のほか、メールアドレスで引くツール、会社名で引くツール、一覧を取るツールがあります。請求書は、請求書ID、顧客ID、サブスクリプションIDのいずれからでも引けます。

data_lookup- の2本は、一覧取得の前に使う補助です。Chargebeeのドキュメントでは、絞り込み条件の構造と、返せる項目の一覧を事前に調べるためのツールと説明しています。大きな一覧を取るときに、必要な項目だけを選ぶ流れの入口になります。

docs_explanation_agent_as_tool と code_generation_agent_as_tool は、データの検索ではなく、Chargebeeの機能説明とAPI連携コードの生成に使うツールです。対応表では、機能や設定の解説と、REST APIおよびChargebee.js向けのコード断片の生成に当たります。

読み取り専用ではない — 書き込み系ツールの注意

ツール名の並びで注意が要るのは、最後の10本です。generate_customers_and_subscriptions_tool や import_subscriptions_tool のように、顧客・サブスクリプション・商品カタログ・見積もりを作る、または取り込む名前が並びます。

Chargebeeのドキュメントには、データ検索用のData Lookup MCPサーバーとは別に、オンボーディング用のMCPサーバーがあります。こちらは商品カタログの作成とデモデータの生成を行い、テスト用サイトとサンドボックスのサイトでのみ使え、本番サイトでは使えないと明記されています。取り込み系のツールとして、サブスクリプション、請求書、クレジットノート、未請求の課金を取り込む機能も同じ節に並びます。

コネクタの10本がこのオンボーディング用サーバーのツールに当たるのか、本番サイトでどう動くのかは、コネクタページからは読み取れません。名前が重なるだけで、対応は明記されていない点に注意が要ります。

そのうえで、Chargebeeのドキュメントは次の注意を置いています。

• 書き込みを含め、MCPサーバー経由でAIクライアントが行う操作の責任は利用者側にある
• 承認の挙動はMCPクライアントごとに違うので、信頼できるクライアントだけを接続し、実行前に内容を確認する

課金データは、誤更新の影響が顧客への請求に直結します。本番サイトを触る前に、次の節の権限設定を先に済ませてください。

読み取りだけに絞る — Claude側の権限設定

Team・EnterpriseプランのOwnerは、「Customize」→「Connectors」でChargebeeを選ぶと、Tool permissionsを設定できます。ツールは読み取り系と書き込み系などの種類に分かれ、それぞれ「Always allow」「Needs approval」「Blocked」から選びます。この設定は組織全体に効き、個人は上書きできません。

考えられる組み合わせは次のとおりです。

Claude側で書き込みを許可しても、Chargebee側でそのユーザーに権限がなければ変更はできません。Claude側の制限は権限を広げず、狭めるだけです。よくある設定のつまずきはClaude Connectorsの権限設定でよくある失敗と対策にあります。

Chargebee側の設定 — MCPサーバーの絞り込み

Chargebee側にも、外部のAIクライアントに見せる範囲を絞る仕組みがあります。設定画面は、Chargebee Billingの「Settings」→「Configure Chargebee」→「Agentic AI」→「MCP Servers」です。

Data Lookup MCPサーバーは、次の単位で調整できます。

• MCPアクセスのオン・オフ(オフなら外部のAIクライアントは使えない)
• ツールのまとまり(ツールセット)ごとのオン・オフ
• 認証方式(APIキーかOAuth)の選択

APIキー方式は、有効なツールすべてへのアクセスを与えます。サーバー間連携や社内の自動化向けで、1つのサーバーにつき最大5本まで作れます。OAuth方式は、サインインしたChargebeeユーザーの権限でさらに絞られ、ユーザー向けのAIクライアントに向くと説明されています。

つまり、会話で使うClaudeにはOAuthが向き、共有のキーを配る運用は避けたほうが権限の線引きが崩れません。なお、複数のビジネスエンティティを有効にしたサイトでは、OAuthが使えず、APIキー認証になります。

ツールの入力値も絞れます。「Configure tool inputs」の機能で、次の3種類の制約を、サーバーとツールごとにかけられます。

• 項目を無効にして、エージェントから見えなくする
• 既定値を入れて、毎回自動で埋める
• 最小・最大や文字列長、配列サイズの制約を置く

用途を限るなら、カスタムMCPサーバーが選択肢になります。ドキュメントの例は、請求書の参照に必要なサブスクリプションと請求書のツールだけを公開するサーバーです。ただしカスタムMCPサーバーは最新の商品カタログが前提で、旧カタログのサイトでは使えません。

Data Lookupサーバーで引ける範囲

コネクタの45個のツールとは別に、Data Lookup MCPサーバーのドキュメントには、さらに広いツールセットの一覧があります。サイト固有のURLで接続するこのサーバーで参照できると書かれているものは、次のとおりです。

コネクタページの一覧に載るツールと、このサーバーのツールセットが完全に一致するかは、説明がありません。特にMRR履歴のように収益分析に効くツールが、ディレクトリのコネクタから使えるかは、接続後にClaudeが返すツール一覧で確かめてください。

大量データの分析には、エクスポートのツールセットがあります。顧客、サブスクリプション、請求書、取引などのエクスポートジョブを作成し、完了後にダウンロード情報を受け取る流れです。

収益チーム向けのプロンプト例

コネクタページが挙げる用途を、作業別に書き換えた例です。実際にどのツールが呼ばれるかは、会話ごとに変わります。

顧客・契約の確認

alice@example.com の顧客を探して、契約中のサブスクリプションと、
直近3件の請求書のステータスを出して

支払い・返金の追跡

この請求書に紐づく支払い取引を、成功と失敗に分けて見せて

分析の入口

今月更新を迎えるサブスクリプションを一覧にして、
過去に支払いが失敗した顧客を先頭に並べて

集計をつけた質問は、Claudeが取得した一覧を読んで計算する形になります。件数が大きいときは、一覧取得の前に絞り込み条件を確認するよう頼むと、取得の範囲が明確になります。

金額の突合や請求の確認のように、結果の正しさが重要な作業では、Claudeの回答をそのまま数字の根拠にしないでください。取得元の請求書ID・顧客IDを添えて回答するよう頼み、Chargebeeの画面で該当のIDを開いて確かめる運用が安全です。

Claude CodeからChargebeeに接続する

ターミナルのClaude Codeからも、リモートのHTTP形式のMCPサーバーとして登録できます。

claude mcp add --transport http chargebee \
  https://mcp.chargebee.com/

例は米国のデータセンター向けです。欧州とオーストラリアは、前の表のURLに置き換えます。登録後、Claude Code内で /mcp を開いてOAuth認証を済ませます。

サイトごとに用意されるMCPサーバーのURLは、https://YOUR-CHARGEBEE-SUBDOMAIN.mcp.chargebee.com/data_lookup_agent の形式です。Chargebeeのドキュメントによると、同じMCPクライアントのユーザーには、同じOAuthクライアントIDを共有できます。Claude Codeのユーザーが100人いても、IDは1つで足ります。各ユーザーはChargebeeのログインページに誘導され、権限はそれぞれのChargebeeユーザーのアクセスレベルで制限されます。

スクリプトや定期タスクにChargebeeの参照を組み込みたいときは、この経路が向きます。営業や経理の担当が日常的に使うなら、claude.aiのディレクトリからの接続で足ります。CRM側の同種の連携はClaude HubSpot連携にあります。

つまずきやすい点

• サインインできない: リージョンとサイトのデータセンターが合っているかを見る。複数のビジネスエンティティを使うサイトのOAuthは、ドキュメントで非対応とされている
• 期待したツールが出ない: Chargebee側でMCPアクセスやツールセットがオフになっていると、AIクライアントには見えない。カスタムMCPサーバーは旧カタログのサイトでは作れない
• 書き込みが通らない: Claude側の「Blocked」と、Chargebee側のユーザー権限の両方が効く。どちらかで止まる
• 参照範囲が想定と違う: OAuthの権限はサインインしたユーザーのアクセスレベルに従う。誰のアカウントで認証したかで、見える範囲が変わる

サードパーティのコネクタについて、Anthropicは提供されるツールを管理せず、動作や変更を検証できないと注意しています。接続する組織が、開発元を信頼できるかを判断します。

まとめ

ChargebeeコネクタはChargebee Incが提供し、顧客・サブスクリプション・請求書・クレジットノート・取引・カタログを会話から引けます。中心は検索系のツールですが、一覧には生成・取り込み系の名前も含まれます。Chargebeeのドキュメントでは、書き込みを含む操作の責任は利用者にあります。

導入は、読み取りだけを「Always allow」にし、書き込み系を「Blocked」か「Needs approval」に置く形から始める構成が扱いやすいです。次に、Chargebee側でMCPアクセスとツールセットの範囲を確認します。OAuthで接続すれば、権限は各ユーザーのChargebee上のアクセスレベルに揃います。