create-revenuecat-project

RevenueCat プロジェクトのセットアップ

RevenueCat プロジェクトをゼロから一通りセットアップするためのガイドです。

手順

重要： 以下のすべての操作には、RevenueCat MCP サーバーまたは rc CLI（ユーザーが利用できる方）を使用してください。どちらも、以下の手順で同じ操作を実行できます。CLI の検出方法と規約については、revenuecat-cli スキルを参照してください。まず必ずプロジェクトを一覧表示し（list-projects または rc projects list）、アクセス可能なプロジェクトをすべて取得してください。複数のプロジェクトが返された場合は、使用するプロジェクト、または新しいプロジェクトを作成するかどうかをユーザーに尋ねてください。

フェーズ 1：要件の確認

開発者のニーズを把握するため、具体的な質問をします。

1. プラットフォーム — 「どのプラットフォーム向けに開発しますか？」（iOS、Android、Web、または複数）
2. ビジネスモデル — 「どのような収益化を予定していますか？」（サブスクリプション、買い切り、消耗型購入、または組み合わせ）
3. サブスクリプションのティア（該当する場合）— 「どのようなサブスクリプションの選択肢を提供しますか？」（一般的な例：月額＋年額、単一ティア、フリーミアム＋プレミアム）
4. アプリの詳細 — Bundle ID（iOS、例：com.company.appname）、パッケージ名（Android）、表示名

フェーズ 2：リソースの作成

依存関係があるため、以下の順に実行します。各手順には MCP ツールを記載しています。同等の rc コマンドは、rc projects create、rc apps create、rc products create、rc entitlements create、rc entitlements attach、rc offerings create、rc packages create、rc packages attach、rc apps keys です。

1. プロジェクトの確認／作成 list-projects - アクセス可能なプロジェクトを一覧表示 複数ある場合：使用するプロジェクトをユーザーに尋ねるか、新しいプロジェクトの作成を提案 新しいプロジェクトを作成するには、create-project MCP ツールを使用 以降のすべての呼び出しで使用するため、project_id を保存

2. アプリの作成（プラットフォームごと）：

   • モバイルアプリの場合、App Store Connect／Google Play Console でアプリをすでに設定済みかどうかをユーザーに尋ねます。設定済みの場合は、create-app ツール（type: app_store | play_store）を使ってアプリを作成します。未設定の場合は、自動生成される test_store アプリを使用し、後から App Store Connect／Google Play Console との連携を設定できることをユーザーに伝えます。
   • Web アプリの場合は、type rc_billing を指定して create-app を実行

3. プロダクトの作成（サブスクリプション／購入ごと）：create-product ツール

4. エンタイトルメントの作成（機能／アクセスレベルごと）：create-entitlement ツール

5. プロダクトをエンタイトルメントに紐付け：attach-products-to-entitlement ツール

6. デフォルトのオファリングを作成：create-offering ツール（lookup_key: "default"）

7. オファリングにパッケージを作成：create-package ツール（サブスクリプションには、$rc_monthly、$rc_annual などを使用）

8. プロダクトをパッケージに紐付け：attach-products-to-package ツール

9. API キーを取得：list-app-public-api-keys ツール

フェーズ 3：概要と次のステップ

セットアップ全体の概要を提示します。

Project Setup Complete!
=======================

Project: {project_name} ({project_id})

Apps Created:
  iOS: {app_name} - API Key: appl_xxxxx
  Android: {app_name} - API Key: goog_xxxxx

Products:
  - monthly_premium (subscription, P1M)
  - annual_premium (subscription, P1Y)

Entitlements:
  - premium → monthly_premium, annual_premium

Offering: default (current)
  └── $rc_monthly → monthly_premium
  └── $rc_annual → annual_premium

Next Steps:
1. Configure store credentials in RevenueCat dashboard
2. Create products in App Store Connect / Play Console
3. Add SDK to your app (see /rc:create-app)
4. Implement paywall UI using the "default" offering

エラー処理

いずれかの手順に失敗した場合：

1. 具体的なエラーを明確に報告する
2. 修正方法を提案する（例：「Bundle ID がすでに使用されている可能性があります」）
3. その手順を再試行するか、スキップするかを提案する
4. 可能であれば、残りの手順を続行する