defrr

defrr MCP サーバー

defrr のエンジンで算出する、契約の収益認識（RevRec）スケジュール、ウォーターフォール、更新、クレジット、解約、従量課金の料金です。 Claude Code に接続して平易な英語で質問するか、ご自身のコードから呼び出せます。

計算ツールは何も保存せず、送信した内容がログに記録されることもありません。必要であれば、defrr の組織への保存を有効にすることもできます（以下を参照）。契約と更新は担当者が承認するドラフトとして保存され、従量課金商品を設定できます。これはデフォルトでは無効で、キーごとに設定します。

接続

1. https://defrr.com/developers/account で API キーを作成します（無料クレジット 40 件）。

2. サーバーを追加します。

   claude mcp add --transport http defrr https://defrr.com/v1/mcp \
     --header "Authorization: Bearer dfr_live_YOUR_KEY"
   

3. Claude Code で /mcp と入力します。計算のみを行うキーでは defrr に 9 個のツールが表示され、契約も保存できるキーでは 18 個または 23 個のツールが表示されます（以下を参照）。

ツール

これらのツールは計算のみを行い、何も保存しません。すべてのキーで利用できます。

ツール	内容	クレジット
defrr_create_contract	新規契約：条件を入力すると、月ごとのスケジュールを出力します。何も保存しません	1
defrr_create_waterfall	最大 50 件の契約を一度に処理します：各契約の月ごとの請求額、収益、繰延残高、および合計を出力します	契約ごとに 1
defrr_process_renewal	更新：価格変更、請求明細、改訂後のスケジュール、月ごとの計上内容を出力します。開始後に処理された更新の差額は、最初の未締め月に計上されます	更新ごとに 1
defrr_usage_billing	月ごとの従量課金額を、定額、ボリューム、プリペイドクレジット、または基本料金＋超過料金の価格設定で算出します。プリペイドの超過分にはフラグが付けられ、基本料金の超過分は価格が算出され、収益とは別に返されます。基本料金の明細に startDate と日付付きの使用量を指定すると、サイクルは契約の記念日に従います。料金は各サイクルの開始月に計上され、超過分は終了月に計上されます。ステートレスです。使用量は計算されて返されますが、保存されることはありません	明細ごとに 1
defrr_reprice_renewal	高すぎる価格で更新された契約に対するクレジット	2
defrr_reprice_contract	当初の契約期間の価格が高すぎた場合のクレジット	2
defrr_cancel_renewal	最新の更新を解約します	2
defrr_cancel_contract	契約全体を解約します	2
defrr_get_credit_balance	クレジットを確認します	無料

失敗した呼び出しのクレジットは返還されます。

defrr への保存（任意）

デフォルトでは、上記のツールは計算のみを行います。スケジュールは返されますが、何も保存されません。契約と更新を defrr の組織に記録する場合は、開発者アカウントで Save contracts in Defrr にチェックを入れてキーを作成します。まだ defrr のワークスペースがない場合は、このページで会社名、基本通貨、収益認識方法、および希望する場合は帳簿を締める月を設定し、小規模なワークスペースを作成します。このオプションがないキーでは計算のみ可能です。

ツール	内容	必要なもの	クレジット
defrr_save_contract	契約を下書きとして保存し、スケジュールを算出します	保存オプション	1（再実行は無料）
defrr_list_drafts	承認待ち、またはすでに決定済みの下書きを一覧表示します	保存オプション	無料
defrr_get_workspace	組織、基本通貨と収益認識モデル、ロックされた期間、承認待ちの下書き数、およびキーの最終接続時刻を表示します	保存オプション	無料
defrr_approve_draft	下書きを有効な契約にします	承認オプション	無料
defrr_reject_draft	下書きを破棄します（却下済みとして保持されます）	承認オプション	無料
defrr_save_renewal	ワークスペース内の既存契約の更新を下書きとして保存します。更新が承認されるまで契約は変更されません。契約条件をスケジュールとして読み取れる場合に利用でき、締め済み期間に開始する更新は受け付けません	保存キーまたは承認キー	1（再実行は無料）
defrr_list_renewal_drafts	承認待ち、またはすでに決定済みの更新下書きを一覧表示します	保存キーまたは承認キー	無料
defrr_approve_renewal_draft	下書きの更新を契約の最後の新しい契約期間として追加し、スケジュールを再計算します	承認オプション	無料
defrr_reject_renewal_draft	下書きの更新を破棄します（却下済みとして保持されます）	承認オプション	無料
defrr_find_contracts	顧客名でワークスペース内の顧客の契約を検索します	保存キーまたは承認キー	無料
defrr_get_contract	1件の契約を読み取り、計算ツールが使用するスケジュール形式で契約条件を返します。計算ツールでモデル化できない機能が契約に含まれる場合は、その理由を示します	保存キーまたは承認キー	無料
defrr_list_usage_products	ワークスペースにすでに設定されている従量課金プロダクトを一覧表示します	保存キーまたは承認キー	無料
defrr_preview_usage_product	従量課金プロダクトが作成される前に、サンプル顧客の料金（従量課金、プリペイドクレジット、または固定料金＋超過料金）を表示します。何も保存されません	保存キーまたは承認キー	無料
defrr_create_usage_product	その従量課金プロダクトをワークスペースに作成します（新規プロダクトのみ。既存プロダクトはdefrrで編集します）	承認オプション	無料

保存された契約は下書きです。 承認されるまで有効にはならず、どのレポートにも反映されません。承認はdefrrのContracts、Draft contractsから行うか、キーに承認オプションも付与されたエージェントが行えます。人による確認が必要なエージェントでは、承認オプションを無効にしてください。下書きに、締め済みの月（Organization detailsで確認できるロック期間）またはすでに終了した月の収益が含まれる場合、defrrは承認前にその旨を知らせます。

同じ内容を再送しても安全です。 同じ契約を再送すると、下書きが承認待ちまたは承認済みである間は、保存済みの下書きが返され、料金はかかりません。却下済みの場合、またはその契約が削除されている場合は、同じ条件で新しい下書きとして保存されます。同じ条件で別の取引を保存するには、idempotencyKeyを送信してください。

保存された更新も下書きです。 顧客が契約を更新する際、エージェントは契約を検索し（defrr_find_contracts、続いてdefrr_get_contract）、契約ID、更新の終了日、更新期間の合計価格を指定してdefrr_save_renewalで更新を保存します。キーに承認権限がある場合、更新はdefrrのContracts、Draft renewalsから、またはdefrr_approve_renewal_draftで承認されるまで、契約に反映されません。承認すると、更新が契約期間の最後に追加され、契約のスケジュールが再計算されます。利用できるのは、契約条件をスケジュールとして読み取れる契約に限られます（読み取れない場合は、defrr_get_contractが理由を示します。たとえば月次請求、割引、外貨など）。また、契約の最終終了日を過ぎた後に限られ、締め済み期間に開始する更新は受け付けません。その場合はアプリのEdit renewalsから処理してください。 エージェントに伝えられる内容。 セッションが開始すると、接続先の組織、最後にロックされた期間、キーが最後に接続された日時がわかります。ロック期間を変更できるのは人だけです。defrr の Organization details から変更してください。

手順を確認しながら進める

Claude Code で新しいセッションを開始し、次のように入力します。

/mcp__defrr__new-contract

不足している情報（顧客、製品、各期間の日付と価格、収益認識方法）を尋ね、確認のために契約条件を読み上げてから、下書きを保存します。コマンドの後に、すでにわかっている情報を入力できます。他の MCP クライアントでは、defrr サーバー上の同じプロンプトが、各クライアントのメニューに new-contract として表示されます。または、平易な英語で「Acme Pty Ltd の Pro Plan の契約を作成してください。期間は 2027 年 1 月 1 日から 2027 年 12 月 31 日まで、金額は 12,000 ドルです」と依頼することもできます。

開発者ワークスペース

開発者アカウントページから設定したワークスペースでは、defrr アプリのいくつかのページを開けます。ダッシュボード、すべての契約を表示、契約の下書き、更新の下書き、従量課金製品、顧客プロフィール、Organization details（基本情報、認識モデル、基本通貨、ロック期間）です。その他の機能はサブスクリプション機能で、グレー表示されます。

また、各ページの右下にあるボタンから利用できる Ask defrr アシスタントもあります。このアシスタントは同じツールとクレジットを使用し、契約またはその最新の更新の解約準備もできます。カードに金額が表示され、Confirm を押すまでは何も変更されません。下書きの承認はできません。

試してみる

新しい契約（計算のみ）：

defrr を使って契約を作成してください。元の契約期間は 2026 年 1 月 1 日から 2026 年 12 月 31 日まで、金額は 12,000 ドルです。 続いて、2027 年 1 月 1 日から 2027 年 12 月 31 日まで、金額 18,000 ドルで更新します。終了日は期間に含めます。 収益は均等に認識します。契約条件と月ごとのスケジュールを表示してください。

更新：

defrr を使って更新を処理してください。終了日は期間に含め、収益は均等に認識します。契約期間は 2026 年 1 月 1 日から 2026 年 12 月 31 日まで、金額は 12,000 ドルで、2027 年 12 月 31 日まで 18,000 ドルで更新します。当社の帳簿は 2027 年 3 月まで締めています。価格変更、請求仕訳、キャッチアップ仕訳、月ごとに計上する内容を表示してください。

従量課金：

defrr を使って 2 社の顧客の従量課金を計算してください。Acme は段階別料金で、月間最初の 100,000 単位は 1 単位あたり 0.002 ドル、それを超える分は 1 単位あたり 0.001 ドルです。2026 年 1 月に 250,000 単位、2026 年 2 月に 80,000 単位を使用しました。Globex はプリペイドクレジットで、1 単位あたり 0.002 ドルの 100,000 単位分です。2026 年 1 月に 70,000 単位、2026 年 2 月に 60,000 単位を使用しました。各月の収益、月ごとの合計、超過分があればその金額を表示してください。

更新の保存（保存オプション付きのキーが必要です）：

Acme Pty Ltd は Pro Plan を 2028 年 12 月 31 日まで、14,000 ドルで更新しました。契約を検索し、更新を下書きとして保存してください。使用した契約を教えてください。

契約の保存（保存オプション付きのキーが必要です）：

defrr で Acme Pty Ltd の Pro Plan の契約を作成してください。期間は 2027 年 1 月 1 日から 2027 年 12 月 31 日まで、金額は 12,000 ドル、認識方法は正確、終了日は期間に含めます。どの組織に保存されたか教えてください。

その他のクライアント

Streamable HTTP とカスタムヘッダーに対応する MCP クライアントなら、どれでも接続できます。キーは Authorization: Bearer dfr_live_YOUR_KEY または X-API-Key: dfr_live_YOUR_KEY として送信してください（Authorization を設定できないツールの場合）。キーをウェブアドレスに入力しないでください。

Cursor

このリポジトリはCursor プラグインとして構成されています。defrr への接続（mcp.jsonと、同じ名前を探すディレクトリ向けの同一ファイルである.mcp.json）、defrr を使うタイミングをエージェントに伝えるルール（rules/defrr-revops.mdc）、そして契約の保存手順を案内するnew-contractコマンド（commands/new-contract.md）が含まれています。

接続ではDEFRR_API_KEYという環境変数からキーを読み取るため、キーがファイルに書き込まれることはありません。https://defrr.com/developers/account でキーを作成し、次のように一度だけ変数を設定します。

• macOS（テスト済み）：ターミナルで次を実行します。

  launchctl setenv DEFRR_API_KEY dfr_live_YOUR_KEY
  

  その後、Cursor を完全に終了（Cmd+Q）して、ターミナルにコマンドを入力して起動するのではなく、Dock または Applications フォルダから再度開きます。Cursor は起動時に変数を読み取るため、ウィンドウを再読み込みするだけでは不十分です。この設定は Mac を再起動するまで有効です。再起動後にコマンドをもう一度実行するか、下記のファイルを使った設定を行ってください。

• Windows および Linux（未テスト）：DEFRR_API_KEYという名前のユーザー環境変数を設定し、Cursor を終了して再度開きます。

次に Cursor の MCP 設定を確認します。defrrが使用可能になり、ツールが一覧表示されます（計算のみを行うキーでは9個、契約を保存できるキーでは18個または23個）。

Cursor のマーケットプレイスに掲載される前にこのプラグインを使うには、このフォルダを~/.cursor/plugins/local/defrr/にコピーして、Cursor を再読み込みします。

キーをファイルに保存したい場合や、Cursor から環境変数を参照できず、defrrが失敗として表示される場合は、MCP ログにUnexpected token '<', "<!DOCTYPE"... is not valid JSONと表示されることがあります。このメッセージは、有効なキーがない状態でリクエストが defrr に届いたことを意味します。~/.cursor/mcp.json（または Cursor の Settings、MCP）にサーバーを手動で追加します。

{
  "mcpServers": {
    "defrr": {
      "type": "http",
      "url": "https://defrr.com/v1/mcp",
      "headers": { "X-API-Key": "dfr_live_YOUR_KEY" }
    }
  }
}

このファイルをバージョン管理の対象にしないでください。また、プラグインも使用する場合は、サーバー設定が競合しないよう、プラグイン側にあるサーバー設定を無効にしてください。

LangChain

LangChain はlangchain-mcp-adaptersパッケージを介して MCP サーバーに接続します。

from langchain_mcp_adapters.client import MultiServerMCPClient

client = MultiServerMCPClient({
    "defrr": {
        "transport": "streamable_http",
        "url": "https://defrr.com/v1/mcp",
        "headers": {"X-API-Key": "dfr_live_YOUR_KEY"},
    }
})
tools = await client.get_tools()

キーはコード内ではなく、環境変数に保存してください。エージェントでツールを使う方法については、LangChain のMCP ドキュメントをご覧ください。

より大きなデータセット

収益ウォーターフォールでは、1回の呼び出しにつき最大50件の契約を処理できます。それ以上の場合は、複数回に分けて送信し、各レスポンスのcarryを次の呼び出しに渡します。最後のバッチで全契約の総計が返されます。数百件または数千件の契約を扱う大規模なデータセットでは、モデル経由ではなくスクリプトから API を呼び出すことで、数値を直接ファイルに出力できます。ガイドには、CSV ファイルを2つ出力するすぐに使える Python スクリプトが掲載されています。

プライバシー

計算ツールは各リクエストで送信されたデータを使い、その内容を保持しません。例外は保存機能です。これはキーごとに有効にします。Save contracts in Defrrが有効なキーでは、送信した契約と更新情報（顧客、製品、日付、価格）が、ドラフトとしてご自身の defrr 組織に保存され、そこで作成した使用状況製品も保存されます。

ドキュメントと制限

詳細なリファレンス、料金、対象外の内容：https://defrr.com/developers/guide

レジストリの掲載名：com.defrr/defrr