stigg-pricing-modeling

Stigg の料金モデリング — カタログを作成する

このスキルでは、カタログ全体（プロダクト、プラン、アドオン、機能、料金、クーポン、クレジット通貨の定義）を扱います。ランタイムのゲーティング（stigg-entitlements）やサブスクリプションのライフサイクル（stigg-subscriptions）は扱いません。

始める前に

親スキルの stigg に従い、まず検索してください。 カタログモデリングは急速に変化するため、設定を作成する前に Mintlify Stigg docs MCP（search_stigg、query_docs_filesystem_stigg）または Stigg MCP サーバーの search_docs ツールを使って、最新のページを確認してください。

MCP を優先する際の基本方針

カタログのすべての操作を Stigg MCP 経由で行うことを目指してください。MCP が対応している場合、UI は不要です。

その理由：Stigg MCP は、カタログモデリングに必要な Stigg API の全機能を提供します。エージェントは「従量制の機能が2つあり、基本料金が49ドルの Pro プランを作成する」という指示を、適切な MCP ツールの呼び出しに変換します。クリックしたり、UI からコピーして貼り付けたりする必要はありません。

現在、MCP の対応が不完全な場合は、次の順に切り替えてください。

1. Stigg MCP（mcp.stigg.io） — 推奨です。stigg-mcp を参照してください。
2. Stigg CLI（brew install stiggio/tools/stigg — https://github.com/stiggio/stigg-cli） — ユーザーが CLI または決定論的なスクリプト／CI ステップを明示的に求めた場合に限ります。
3. REST API — SDK ではまだ公開されていない操作に使用します。
4. Stigg UI（app.stigg.io） — 最終手段として、上記でまだ対応していない操作に限り使用します。スキルの MCP 対応状況マトリックスに操作名を明記し、UI ページへのリンクを記載してください。

正式な最新の対応状況一覧は references/mcp-coverage-matrix.md にあります。MCP の対応範囲が広がったら、このファイルを更新してください。スキルの内容がいつの間にか「UI を使用する」という指示に変わらないようにしてください。

カタログの概要

概念	内容	参照先
プロダクト	最上位の製品ラインです。プラン、アドオン、カスタマージャーニーをひも付けます。顧客ごとにサブスクリプションを1つにするか複数にするかを制御します。	references/products.md
プラン	プロダクトの料金階層です。種類は Free、Paid、Custom の3つです。	references/plans.md
アドオン	Paid／Custom プランを拡張するモジュールです。エンタイトルメントは追加されます。	references/addons.md
機能	ゲーティングの対象にできる機能です。種類は boolean、configuration（数値／列挙型）、metered です。	references/features.md
エンタイトルメント	プランまたはアドオンに付与される機能と設定です。（「月あたり10,000回の API 呼び出し」のようなものです。）	プラン／アドオンの項目で説明
料金	課金対象となるものです。基本の定額料金、ユニットごとの料金、従量課金、前払いの利用契約、最低利用額、超過料金、クレジット料金があります。	references/charges-and-pricing-models.md
クーポン	顧客または特定のサブスクリプションに適用する割引です。	references/coupons.md
クレジットのモデリング	カタログ側のクレジットです。プラン／アドオンでのクレジット付与や、消費のマッピングを扱います。	references/credits-modeling.md（定義を説明。ランタイム操作は stigg-credits で扱います）
価格のローカライズ	複数通貨／複数地域での課金です。カスタムのクレジット通貨とは異なります。	references/price-localization.md

適切なプラン種別を選ぶ

目的	プラン種別
アップグレードを促す、支払い情報不要のフリーミアム階層	Free
セルフサービス型の有料プラン（固定料金および／または従量課金、任意のトライアル）	Paid
営業主導、顧客ごとの価格設定、可変のエンタイトルメント	Custom

1つのプロダクトに3種類すべてのプランを用意できます。通常、顧客が有効なサブスクリプションを持てるのはプロダクトごとに1つです（設定可能。プロダクトによっては複数の有効なサブスクリプションを並行して利用できます。references/products.md を参照してください）。

適切な課金モデルを選ぶ

目標	使用するモデル
月額料金を固定して予測しやすくする	定額料金（例：月額 $49）
選択したリソースごとに支払う	ユニット単位（例：1席あたり月額 $10）
消費量のみに基づいて課金する	従量課金 — 使った分だけ支払う
顧客が事前に利用枠を確約し、利用後に精算する	事前確約
利用量にかかわらず収益の下限を設ける	最低利用額
利用枠を含め、超過分に課金する	超過課金（ボリューム／段階制／ユニット単位のボリューム）
クレジットベースの収益化	クレジット課金
複数地域での価格設定	価格のローカライズ（別の軸 — モデルに追加して適用）

詳細な仕組み、組み合わせるタイミング、トレードオフについては、references/charges-and-pricing-models.md を参照してください。どのモデルを選ぶかに関する戦略的な指針は stigg-pricing-expert スキルにあります。このスキルは、選択したモデルを実行に移すためのものです。

機能 — 3 種類

種類	使用場面	エンタイトルメントの内容
ブール値	オン／オフの機能（「プレミアムサポート」）	許可または拒否
設定値	数値または列挙値（「シート数」、「利用可能なテンプレート」）	値
従量制	追跡対象の消費量（「月あたりの API 呼び出し数」）	値に加えて、任意の使用量リセット（毎時／毎日／毎週／毎月）と、メーターの集計方法（合計／カウント／ユニーク数／平均／最小／最大）

エンタイトルメントを介して、機能をプラン／アドオンに関連付けます。同じ機能でも、プランによって異なるエンタイトルメントを設定できます（例：「API 呼び出し数」＝ Starter では 1k、Pro では 10k、Enterprise では無制限）。

カスタムクレジット通貨と価格のローカライズ

混同しやすいですが、異なる概念です。

• カスタムクレジット通貨 — 消費量の単位を定義します（例：「AI トークン」、「API クレジット」）。従量制機能の顧客の使用量は、その通貨建てのクレジットプールから差し引かれます。請求通貨とは無関係です。 references/credits-modeling.md と stigg-credits スキルを参照してください。
• 価格のローカライズ — 複数通貨での請求を指します（例：EU の顧客には EUR、JP の顧客には JPY で価格を表示／請求する）。あらゆる価格モデルに追加して適用する独立した軸です。references/price-localization.md を参照してください。

最も一般的な構成では、1 つの製品でクレジットベースの価格設定に1 つのカスタムクレジット通貨を使用しつつ、有料プランでは複数のローカライズ済み請求通貨を提供します。

ドラフト、バージョン、公開

プランとアドオンの編集には、ドラフト → 公開済みバージョンのフローを使用します。

• ドラフトを開いて編集し、公開すると、新しいアクティブバージョンになります。
• 古いバージョンを利用している既存のサブスクリプションは、移行するまで従来の条件が適用されます（stigg-subscriptions/references/plan-version-migration.md で説明しています）。
• 公開時には、プラン公開エンドポイントに従って移行ポリシー（例：NEW_CUSTOMERS のみ、または強制移行）を選択します。
• アドオンにも同様のドラフト／公開フローがあります。

ロールアウトのロジックを作成する前に、必ず最新のドラフト／公開に関するドキュメントページを再取得してください。利用可能な移行タイプや副作用は変更されることがあります。

カタログのモデリング手順

MCP を介した一般的なエンドツーエンドの手順：

1. Define features.            ← reusable building blocks
2. Group features (optional).  ← for shared entitlements across plans
3. Create the product.         ← anchors plans & add-ons
4. Create plans.               ← assign feature entitlements + charges
5. Create add-ons.             ← additive entitlements + their own charges
6. (Optional) Define coupons.
7. (Optional) Configure price localization.
8. Publish.                    ← chooses migration policy for existing subs

各手順では、まずドキュメントを検索してからMCP を呼び出してください。プランとアドオンは機能を参照し、アドオンは互換性のためにプランを参照するため、順序が重要です。

このスキルを使用しないケース

• 実行時のエンタイトルメント確認（getMeteredEntitlement、getBooleanEntitlement、getEntitlement、およびそれらが返す entitlement.hasAccess プロパティ）→ stigg-entitlements を使用してください。
• サブスクリプションのプロビジョニング、更新、キャンセル → stigg-subscriptions を使用してください。
• 顧客の製品にどの収益化モデルが適しているかを選ぶ → stigg-pricing-expert を使用してください。
• 本番環境でのクレジット付与、台帳、自動チャージの運用 → stigg-credits を使用してください。（このスキルでは、カタログ内のクレジット通貨とクレジット課金のモデリングを扱います。）

よくある間違い

間違い	修正方法
下書きを作成せずに公開済みのプランを直接編集する	必ず「下書き → 編集 → 公開」の順に進めます。既存のサブスクリプションに適用する移行タイプは、公開時に選択してください。
アドオンとそのプランの互換性ルールを忘れる	アドオンではプランごとに互換性を指定します。アドオンがプランの互換性のあるアドオン一覧に記載されていることを確認してください。
「カスタムクレジット通貨」を請求通貨として扱う	カスタムクレジット通貨は消費単位（トークン、クレジット）です。請求通貨は USD／EUR などです。価格のローカライズを参照してください。
シートごとの料金を従量制の機能としてモデル化する	単位ごとの料金がある設定機能を使用してください。従量制は、時間の経過とともに追跡される消費量に使用します。
請求期間と一致しない利用量のリセット周期を設定する	周期は顧客が請求を確認するタイミングに合わせます。通常、請求期間が月単位の場合は毎月リセットします。
アドオンのエンタイトルメントにすべき内容をプランレベルのエンタイトルメントとして追加する	オプション、または追加料金の対象である場合は、アドオンとしてモデル化します。これにより、追加分として個別に価格設定できます。
MCP が対応している操作に UI を使用する	原則として MCP を使用してください。対応範囲の不足が見つかった場合は、references/mcp-coverage-matrix.md を更新します。目標は UI へのフォールバックをゼロにすることです。