Android Studioで完結するサブスク管理:AIエージェント搭載IntelliJ Pluginの実務ガイド
コードを書く画面と、MRRを確認する画面、オファリングを設定する画面、ペイウォールをデザインする画面——サブスクリプションアプリの開発では、これらを行き来するたびに集中が途切れます。本稿で扱うのは、サブスクリプション管理機能をIDE内に統合するIntelliJ Pluginです。認証・指標確認・オファリング操作・ペイウォール生成・コード編集の入口をIDE内にまとめることで、この往復を減らすことを狙った外部ツールとして紹介します。初回セットアップから日々の操作までを、何を確認し、どこで承認し、どの状態を見ればよいかという観点で整理します。
セットアップ:OAuthサインインとプロジェクト選択
最初に開くツールウィンドウには「サインイン」ボタンを持つウェルカム画面が表示されます。サインインを押すとブラウザが開き、プラグイン側はローカルのコールバックサーバーを起動してトークン交換を自動処理し、認証情報を保存します。手動でAPIキーを貼り付ける工程はここにはありません。
認証方式はPKCEフローを用いたOAuth 2.0です。要求されるスコープはプロジェクト設定、チャートと指標、顧客情報です(スコープの最終的な範囲は提供元のポリシーに従います)。トークンは期限切れ時に自動更新されるため、セッションをまたいでも再サインインの手間がかかりにくい設計です。認証が終わるとプロジェクト一覧が取得され、作業対象を選べるようになります。
セットアップ時の確認項目:
- ブラウザ側でサインインを完了したか
- ツールウィンドウにプロジェクト一覧が表示されたか
- 作業したいプロジェクトを選択済みか
- 顧客情報スコープを含む権限が許可されているか
AIによるコード編集とステージド編集の承認フロー
エージェントはデータの参照だけでなく、プロジェクトのソースファイルを読み取り、検索し、編集できます。たとえば「ApplicationクラスにSDKの初期化処理を追加して」「ペイウォール画面を新しいoffering IDに対応させて」といった依頼が可能です。
提案された変更は、すぐにファイルへ書き込まれるのではなく、インライン差分プレビュー付きのステージド編集として提示されます。適用前に内容を確認し、次の3通りから選べます。
- 個別に承認:必要な変更だけを適用し、それ以外は拒否する
- すべて承認:提案された変更をまとめて適用する
- 拒否:ファイルを変更せず、提案を破棄する
複数ファイルにまたがる変更では、まず差分を読み、意図しない箇所が含まれていないかを確認してから個別承認を使うと安全です。一括適用は、変更範囲が小さく内容を把握しきれている場合に向いています。
AIによるペイウォール生成:依頼から公開までの流れ
ペイウォール生成は、オファリング作成、パッケージ設定、プロダクト紐付け、そしてコピー・画像・スタイリング・テンプレート選択を含むデザイン生成までを一続きで行う機能です。必要な内容を文章で伝えると、エージェントが生成ジョブをバックグラウンドで監視します。
準備が完了すると通知が表示され、ペイウォールビルダーへの直接リンクからデザインの確認と公開ができます。この監視は、OAuthトークンが期限切れになった場合でも、APIキーを独立したフォールバックとして使うことで安定して動作します(APIキー運用の可否は提供元のセキュリティ方針に従います)。
複数のペイウォールを続けて依頼することも可能です。各ジョブは個別に追跡されるため、「プレミアム」の後に「フリーミアム」を依頼しても競合しません。
生成後の確認チェックリスト:
- オファリングにパッケージが設定されているか
- 各パッケージにプロダクトが紐付いているか
- コピー・画像・スタイルがブランド意図に合っているか
- ビルダー上で公開前の最終確認を行ったか
会話ベースのプロジェクト管理と統合デバッグ
エージェントは提供元のサブスクリプション管理リソースに対して作成・取得・更新・削除の各操作に対応します。依頼の例としては、オファリングと月額・年額パッケージの作成、エンタイトルメントの作成と全サブスクリプションプロダクトへの紐付け、オファリングとペイウォール設定状況の一覧表示、パッケージに紐付いていないプロダクトの特定、既存ペイウォールの複製と名前変更などがあります。
既存リソースと重複する依頼では、エラーにせず再利用する挙動も特徴です。たとえば同じ名前のオファリングを作ろうとした場合、重複を検出して既存のものを活用します。
統合時のトラブルシューティングにも使えます。「ペイウォールを表示しようとすると 'Configuration not found' エラーが出る」といった相談では、プロジェクト設定を確認し、オファリングにプロダクトが紐付いたパッケージが存在するかを検証して根本原因を特定します。Kotlin Multiplatformプロジェクトの設定手順を尋ねれば、Codelabsの内容も参照したステップバイステップの案内が得られます。offering lookup keyとoffering IDの違いについても、一般的な説明に加えて実際のプロジェクト設定の文脈を踏まえた回答が返ります。
Charts APIで収益を分析する
エージェントは収益、MRR、ARR、チャーン率、トライアルから有料への転換率、アクティブなサブスクリプション数、リテンションコホートなど、21種類のチャートにアクセスできます。分析的な質問を投げると、適切な日付範囲・解像度・セグメントフィルターを指定してCharts APIをクエリし、結果を読みやすい形式で提示します。
質問例:
- 過去6か月間のMRRトレンドは?
- トライアルから有料への転換率を週別で見せて
- 今月の収益と先月の収益を比較して
- 年額サブスクライバーのチャーン率は?
指標の定義や集計期間が意思決定に影響する場合は、回答だけでなく前提条件も確認しておくと安心です。
モデル選択:性能と応答速度のバランス
AIエージェントは複数のモデルに対応しており、入力バーの歯車アイコンから切り替えられます。利用可能なモデルにはGPT-4.1、GPT-4.1 Mini、Claude Sonnet 4、Claude Haiku 4.5などがあります(提供状況は時期や契約により変わる場合があります)。
用途別の目安:
- 複雑なコード編集や設計判断:GPT-4.1、Claude Sonnet 4
- 素早い確認や単純な質問:GPT-4.1 Mini、Claude Haiku 4.5
同じ依頼でもモデルによって応答の詳しさや速度が変わるため、まず小さいモデルで試し、必要に応じて上位モデルへ切り替える使い方も考えられます。
ダッシュボードパネル:IDE内で指標と状態を確認
ダッシュボードパネルでは、ブラウザを開かずに提供元プロジェクトの状態をリアルタイムで確認できます。サブスクリプションデータは折りたたみ可能なセクションとして整理され、ツールウィンドウを開くと読み込まれます。
収益概要:最上部にアクティブなサブスクライバー数、アクティブなトライアル数、MRR、収益が表示されます。これらの数値はAPIから直接取得されます。
マイルストーン:指標の下には、初めてのサブスクライバー獲得、収益の節目、トライアルに関するマイルストーンなど、提供元ダッシュボードと同じ内容がIDE内に表示されます。
設定済みオファリング:すべてのオファリングと紐づくパッケージ・プロダクトが一覧表示されます。展開するとパッケージ構成、紐付くプロダクト、ペイウォール設定の有無を確認でき、ペイウォールが設定されているオファリングにはビルダーへの直接リンクが表示されます。
ペイウォールセクション:すべてのペイウォールがステータスバッジ付きで表示されます。Published(緑)、Draft(黄)、Has Unpublished Changes(オレンジ)が色分けされ、状態に応じてEdit、Publish、Unpublish、Discard、Duplicate、Deleteの操作が可能です。Editを押すとブラウザでペイウォールビルダーが開きます。ライフサイクル操作はAPIを直接呼び出し、パネルは自動更新されます。
実務での作業順序チェックリスト
日々の開発でプラグインを使う際の流れを整理します。
- ツールウィンドウを開き、サインイン状態と対象プロジェクトを確認する
- ダッシュボードパネルでMRRやアクティブサブスクライバー数など現状の指標を把握する
- 必要なオファリング・パッケージ・プロダクトの構成をオファリングセクションで確認する
- 新規ペイウォールが必要ならエージェントに依頼し、生成完了の通知後にビルダーで確認・公開する
- コード変更が必要ならエージェントに依頼し、差分プレビューを見て個別承認または一括承認を選ぶ
- 収益やチャーンを分析したい場合はCharts API経由の質問で数値を確認する
- 統合エラーが出た場合は、設定と紐付けの検証をエージェントに依頼する
この順序に固定する必要はありませんが、状態確認→変更→検証の流れを意識すると、意図しない変更を減らせます。インストール手順や配布状況は時期によって変わるため、導入前に提供元の案内で最新の入手方法を確認してください。プラグインの入手先URLは所有者が確定する必要があります。
Frequently asked questions
APIキーを手動で設定する必要はありますか?
通常のサインインはOAuth 2.0(PKCEフロー)で行われ、手動のAPIキー設定は不要です。ただし、ペイウォール生成ジョブの監視では、OAuthトークンが期限切れになった場合のフォールバックとしてAPIキーが独立して使われると説明されています。APIキー運用の可否は提供元のセキュリティ方針に従います。
「Configuration not found」エラーが出たとき、何を確認すればよいですか?
エージェントに相談すると、プロジェクト設定を確認し、オファリングにプロダクトが紐付いたパッケージが存在するかを検証して根本原因を特定します。自分で確認する場合は、オファリング→パッケージ→プロダクトの紐付けが途切れていないかを見てください。
同じ名前のオファリングを依頼するとエラーになりますか?
重複するリソースがすでに存在する場合、エージェントは重複を検出し、エラーにせず既存のリソースを再利用します。
モデルはどこで切り替えますか?
入力バーの歯車アイコンから切り替えます。GPT-4.1、GPT-4.1 Mini、Claude Sonnet 4、Claude Haiku 4.5などが利用可能で、用途に応じて性能と応答速度のバランスを選べます。提供状況は時期や契約により変わる場合があります。
ペイウォールの状態はどうやって見分けますか?
ペイウォールセクションでステータスバッジの色を確認します。Publishedは緑、Draftは黄、Has Unpublished Changesはオレンジで表示され、状態に応じた操作ボタンが用意されています。