概要

0:02:00

RevenueCat AI Toolkit のコードラボへようこそ!

RevenueCat AI Toolkit を使うと、AI コーディングアシスタントから直接 RevenueCat のプロジェクト、プロダクト、エンタイトルメント、オファリングを設定できます。収益やコンバージョンファネル、実験のデータにアクセスでき、エージェントから離れることなくアプリ内課金のマネタイズを管理できます。Claude Code、Cursor、OpenAI Codex、Visual Studio Code、Gemini CLI で利用できます。

RevenueCat のダッシュボードとドキュメント、エディターを行き来する代わりに、Toolkit を一度導入すれば、あとはやりたいことを説明するだけで済みます。たとえば 「フィットネスアプリ用に RevenueCat をセットアップして」「設定画面にペイウォールを追加して」「今月のトライアルのコンバージョン率は?」 のように伝えます。Toolkit はエージェントに、作業を正しくこなすための ツール(RevenueCat アカウントに接続されたホスト型 MCP サーバー)と 知識(RevenueCat のベストプラクティスを盛り込んだ厳選済みのスキル)の両方を与えます。

このコードラボでは、次のことを行います。

  • AI Toolkit に付属するものを学びます。MCP サーバー、RevenueCat プラグイン、revenuecat-play-billing プラグインです。
  • 好みの AI コーディングエージェントに Toolkit を導入します。
  • OAuth で RevenueCat アカウントに認証します。
  • 1 つのプロンプトから、完全な RevenueCat プロジェクト(アプリ、プロダクト、エンタイトルメント、オファリング)をセットアップします。
  • スキルを使い、ペイウォール、購入フロー、エンタイトルメントゲート、Customer Center を実装します。
  • 収益データを照会し、連携の問題を対話的にトラブルシューティングします。

最後には、AI エージェントが RevenueCat の頼れる相棒になっています。ダッシュボードを設定し、ベストプラクティスに沿った連携コードを書き、サブスクリプションビジネスに関する質問に答えてくれます。

Toolkit の中身

0:03:00

AI Toolkit は、1 つの GitHub リポジトリ RevenueCat/ai-toolkit からプラグインマーケットプレイスとして配布されています。ここには 2 つのプラグインが付属します。

RevenueCat プラグイン

ほとんどのユーザーが求めるのはこちらです。次の 2 つを組み合わせています。

RevenueCat MCP サーバーは、mcp.revenuecat.ai にあるホスト型の Model Context Protocol サーバーで、RevenueCat アカウントへの認証済みアクセスをエージェントに与えます。これを通じて、エージェントはプロジェクト、アプリ、プロダクト、エンタイトルメント、オファリング、パッケージの作成と参照を行い、分析データを照会できます。

クロスプラットフォームの連携スキルは、iOS、Android、Kotlin Multiplatform、Flutter、React Native で、RevenueCat のよくあるタスクを正しくこなす方法をエージェントに教える、厳選済みでバージョン管理された手順です。

  • integrate-revenuecat: MCP を介してダッシュボード側をセットアップし、アプリに Purchases SDK を導入・設定する、エンドツーエンドの連携。
  • create-revenuecat-project: アプリ、プロダクト、エンタイトルメント、オファリング、パッケージを正しい順序でゼロから作成し、完全なプロジェクトをセットアップします。
  • revenuecat-paywall: RevenueCatUI SDK を使ってペイウォールを表示します。
  • revenuecat-purchase-flow: 購入、エラー処理、復元を実装します。
  • revenuecat-entitlements-gate: プレミアム機能をエンタイトルメントで制限します。
  • revenuecat-identify-user: RevenueCat の ID をアプリの認証システムに結び付けます。
  • revenuecat-customer-center: セルフサービスのサブスクリプション管理 UI を追加します。
  • revenuecat-testing-setup: サンドボックスやテスト環境をセットアップし、実際のお金を使わずにテストできるようにします。
  • revenuecat-troubleshoot: ダッシュボードの設定と SDK のデバッグログを使って連携の問題を診断します。
  • revenuecat-migrate: 素の StoreKit や Play Billing から、あるいは SDK のメジャーバージョンをまたいで移行します。
  • revenuecat-status: プロジェクト構成をすばやく概観します。
  • revenuecat-charts: データ、分析、KPI に関する質問に答えます。

revenuecat-play-billing プラグイン

RevenueCat Android SDK 向けの Google Play の深掘りスキル 20 個を備えた、任意で追加できる 2 つ目のプラグインです。Google Play のサブスクリプションライフサイクルをハンドブック並みの深さでカバーします。購入、プランと価格の変更、支払いの回復、一時停止と解約、ウィンバック、Webhook、セキュリティなどです。信頼できる唯一の情報源である RevenueCat/play-billing-skills から同期されています。

ヒント: まずは RevenueCat プラグインから始めてください。Android をリリースしていて、Google Play の課金挙動をハンドブック並みの深さで押さえたい場合は、revenuecat-play-billing を上乗せしましょう。

Claude Code に導入する

0:03:00

Claude Code はプラグインマーケットプレイスをネイティブにサポートしているため、導入は 1 分もかかりません。方法は 2 つあります。

Claude Code 内から

プロジェクトで Claude Code を起動し、次を実行します。

text
/plugin

次に Marketplace+ Add Marketplace を選び、RevenueCat/ai-toolkit を入力します。マーケットプレイスを追加したら、RevenueCat プラグインを選んで導入します。Android をリリースしていて、Google Play をハンドブック並みの深さで押さえたい場合は、revenuecat-play-billing も選んでください。

コマンドラインから

ターミナルのほうがよいですか? 同じことを 3 つのコマンドで行えます。

bash
claude plugins marketplace add RevenueCat/ai-toolkit
claude plugins install RevenueCat
claude plugins install revenuecat-play-billing

これで完了です。プラグインが RevenueCat MCP サーバーを登録し、すべてのスキルを Claude から使えるようにします。導入を確認するには、Claude Code で / と入力してください。コマンド一覧に RevenueCat のスキル(/revenuecat-status など)が表示されるはずです。

ほかの AI エージェントに導入する

0:03:00

Toolkit は主要な AI コーディング環境で動作します。以下から自分の環境を選んでください。

OpenAI Codex CLI

bash
codex plugin marketplace add RevenueCat/ai-toolkit

次に Codex を起動して /plugins を実行し、RevenueCat を検索して導入します。Codex デスクトップアプリの場合は、まず同じターミナルコマンドを実行し、アプリで Plugins をクリックして、ドロップダウンから RevenueCat を選び、プラグインの横の + ボタンをクリックします。

Gemini CLI

bash
gemini extensions install https://github.com/RevenueCat/ai-toolkit

Gemini にはマーケットプレイスがなく、リポジトリごとに 1 つの拡張機能のみをサポートするため、導入されるのは RevenueCat プラグインだけです。revenuecat-play-billing プラグインは、Claude Code、Cursor、Codex、VS Code で利用できます。

Visual Studio Code

VS Code のプラグインマーケットプレイス対応は、現在ベータ版です。公式の手順に従って RevenueCat/ai-toolkit をプラグインマーケットプレイスとして追加し、マーケットプレイスからプラグインを導入してください。

Cursor

マーケットプレイス対応は近日中に提供されます。それまでは、ダッシュボードのツールを使うために RevenueCat MCP サーバーを直接追加できます。

そのほかのエージェント

プラグイン非対応のエージェント型コーディング環境では、npx でスキルだけを導入できます。

bash
npx skills add RevenueCat/ai-toolkit

メモ: これで導入されるのはスキルだけで、MCP サーバーは含まれません。MCP セットアップ手順に従って、環境で MCP を手動で設定してください。

RevenueCat で認証する

0:02:00

MCP サーバーはあなたの RevenueCat アカウントで動作する必要があるため、ブラウザーでの OAuth で認証します。API キーをあちこちにコピーする必要はありません。アクセス権は RevenueCat アカウントの権限に基づいて付与され、すべてのプロジェクトが対象になります。

認証のプロンプトが表示されるタイミングは、環境によって異なります。

  • すぐに:プラグインを導入した直後に認証を求める環境もあります。
  • 初回利用時に:エージェントが最初に RevenueCat のツールを呼び出すまで待つ環境もあります。
  • 手動で:Gemini CLI では、/mcp auth revenuecat を実行して自分でフローを開始します。

いずれの場合もフローは同じです。ブラウザーが開き、RevenueCat にサインインし(まだの場合)、アクセス要求を承認します。これが済めば、エージェントの接続は完了です。

すべてがエンドツーエンドで動くことをすばやく確認するには、プロジェクトのステータスを尋ねてみましょう。

text
You: What is the status of my RevenueCat project?

Agent: RevenueCat Project Status
       ============================
       Project: Fitness App (proj123)

       Apps: 2 (iOS, Android)
       Products: 4
       Entitlements: 2
       Offerings: 1

       ✅ Configuration looks healthy!

このようなサマリーが表示されれば、認証は成功し、MCP 接続も有効になっています。まだプロジェクトがなくても心配いりません。次のステップで作成します。

メモ: Toolkit は実際の RevenueCat 構成を読み書きできます。コードと同じように、エージェントが提案する内容を確認してから変更を承認してください。

1 つのプロンプトでプロジェクトをセットアップする

0:05:00

ここが Toolkit の真価を発揮する場面です。従来 RevenueCat のセットアップは、ダッシュボードをクリックして進み、アプリ、プロダクト、エンタイトルメント、オファリング、パッケージを(正しい順序で)作成し、そのうえでコードに SDK を組み込む作業でした。Toolkit を導入すれば、望む結果を説明するだけで、エージェントが両方をこなします。

ダッシュボードの構成を作成する

プロジェクトで、次のようなプロンプトから始めます。

text
You: Set up RevenueCat for my fitness app

Agent: I'll help you set up RevenueCat. What platforms are you building for?

You: iOS and Android

Agent: Creating your iOS app... [creates app]
       Creating your Android app... [creates app]
       What subscription tiers do you want? (e.g., monthly, annual)

You: Monthly at $9.99 and annual at $79.99

Agent: [Creates products, entitlements, offering, packages]

       Setup complete! Here are your API keys:
       iOS: appl_xxxxx
       Android: goog_xxxxx

裏側では、create-revenuecat-project スキルが MCP サーバーを動かし、正しい依存順ですべてを作成します。まずアプリ、次にプロダクト、次にそのプロダクトに紐付いたエンタイトルメント(premium など)、次に月額と年額のパッケージを持つオファリング、という順です。これらは RevenueCat ダッシュボード上の実際のリソースです。ブラウザーで開けば確認できます。

SDK を連携する

既存のアプリのコードベースで作業している場合は、代わりにエンドツーエンドの連携スキルを使いましょう。ダッシュボード側の処理、プロジェクトへの Purchases SDK の導入・設定の両方をこなします。

text
You: Integrate RevenueCat into this app

integrate-revenuecat スキルは、プラットフォーム(iOS、Android、KMP、Flutter、React Native)を検出し、SDK の依存関係を追加し、MCP を介してプロジェクトから正しい公開 API キーを取得し、ベストプラクティスに沿ってアプリの起動時に Purchases を設定します。これは、このサイトのプラットフォーム別コードラボで教えているのと同じパターンです。

ヒント: 終わったら /revenuecat-status を実行して(あるいは「プロジェクトのステータスは?」と尋ねて)、アプリ、プロダクト、エンタイトルメント、オファリングがすべて揃っているか確認しましょう。

スキルで機能を構築する

0:04:00

プロジェクトの構成が済めば、連携スキルがエージェントを助けて、各マネタイズ機能を正しく構築してくれます。スキルを名前で呼び出す必要はありません。リクエストが一致すると自動で有効になります。それぞれを起動するプロンプトは次のとおりです。

ペイウォールを表示する

text
You: Gate the premium analytics screen behind a paywall

revenuecat-paywall スキルは RevenueCatUI SDK を組み込みます。iOS では PaywallView、Android では PaywallActivity やペイウォールの composable、必要に応じて presentPaywallIfNeeded を使い、ダッシュボードの Paywall Editor で設定したペイウォールを表示します。

購入、復元、エンタイトルメントゲート

購入ロジックを頼むと、たとえば 「年額パッケージの購入フローを、復元付きで実装して」 のように伝えると、revenuecat-purchase-flow が有効になります。これはオファリングを取得し、パッケージを購入し、ユーザーのキャンセルとエラーを処理し、復元を実装します。「この機能はサブスク登録者だけに見せて」 と頼むと revenuecat-entitlements-gate が有効になり、CustomerInfo からアクティブなエンタイトルメントを確認し、エンタイトルメントの変化に反応します。

ID と Customer Center

RevenueCat を認証システムに接続するとき、たとえば 「ログインとログアウトのタイミングで RevenueCat を Firebase Auth のユーザーと同期して」 と頼むと、revenuecat-identify-user スキルが logIn/logOut と匿名から識別済みへの遷移を処理します。また 「サブスクリプション管理画面を追加して」 と頼むと revenuecat-customer-center が有効になり、セルフサービスの Customer Center UI を埋め込みます。

お金を使わずにテストする

text
You: How do I test purchases without real money?

revenuecat-testing-setup スキルは、プラットフォームに応じたサンドボックスのセットアップをエージェントに案内します。iOS では StoreKit の構成ファイルとサンドボックスアカウント、Android ではライセンステスターと内部テストトラックを扱い、購入フロー全体を安全に試せるようにします。(もっと手早く始めるなら、iOS 用 Test StoreAndroid 用 Test Store のコードラボを参照してください。)

分析、トラブルシューティング、さらに深く

0:02:00

Toolkit はセットアップだけのものではありません。サブスクリプションビジネスを運営する日々の業務でも役立ち続けます。

データについて質問する

revenuecat-charts スキルは、エージェントを分析コンソールに変えます。「MRR は?」「前回の価格テスト後、トライアルのコンバージョンはどう変わった?」「直近四半期のチャーンを見せて」 のように尋ねると、エージェントが MCP サーバーを介して実際のチャートデータを照会し、答えをまとめてくれます。

対話的にトラブルシューティングする

何かおかしいとき(オファリングが空、購入後もエンタイトルメントがアクティブにならない、ペイウォールが読み込まれない)は、その症状を説明します。

text
You: My offerings are coming back empty on Android

revenuecat-troubleshoot スキルは、MCP を介してダッシュボードの設定を調べ、SDK のデバッグログをたどり、コード側でよくある落とし穴を確認します。これは トラブルシューティングのコードラボと同じ手法を、エージェントが実際のプロジェクトに対して実行するものです。

移行とアップグレード

すでに素の StoreKit や Google Play Billing のコードがありますか? 「このアプリを RevenueCat に移行して」 と頼むと revenuecat-migrate が有効になります。これはオブザーバーモードや、SDK のメジャーバージョンアップグレード(v4 → v5 など)もカバーします。

Google Play をさらに深く

revenuecat-play-billing を導入していれば、Google Play のサブスクリプションライフサイクルに関するハンドブック並みのスキル 20 個をエージェントが手に入れます。サブスクリプションの状態、プラン変更、価格変更、支払いの回復、解約と一時停止、ウィンバック、都度購入プロダクト、Webhook、セキュリティなどです。「猶予期間中のサブスクリプションはどうなる?」「更新時のダウングレードはどう処理する?」 と尋ねると、答えはオープンな Web ではなく、RevenueCat が厳選した Play Billing の知識から返ってきます。

まとめ

0:01:00

おめでとうございます! RevenueCat AI Toolkit を導入し、アカウントで認証し、1 つのプロンプトから完全な RevenueCat プロジェクトをセットアップしました。さらに、スキルがエージェントを助けて、ペイウォール、購入フロー、エンタイトルメントゲート、Customer Center を構築し、データを分析し、問題をトラブルシューティングする方法も、すべて AI コーディングエージェントから離れずに学びました。

Toolkit は、RevenueCat のベストプラクティスを、エージェントが自動で適用してくれるものに変えます。フロー状態を保ったままでいられ、構成、ボイラープレート、そして組織の知見が向こうからやってきます。

次のステップ

各プラットフォームをさらに深く学ぶには、Toolkit と実践的なコードラボを組み合わせましょう。iOSAndroidKotlin MultiplatformFlutterReact Native があります。MCP サーバーそのものについては、MCP ドキュメントを参照してください。

以下のリソースでもさらに学べます。

さあ、すばらしいものをリリースして、面倒な作業はエージェントに任せましょう! 🤖💰