AIアシスタントをAdaptyに接続する(MCP)
Adapty MCPサーバーは、AIアシスタントをあなたのAdaptyアカウントに接続します。チャットで平易な言葉を使って、収益やコンバージョンについて質問したり、プロダクトやプレースメントのセットアップ、フローの公開、A/Bテストの開始などができます。アシスタントはブラウザでAdaptyアカウントにサインインし、あなたの権限を取得します。APIキーは不要です。
| サーバーURL | https://mcp.adapty.io/mcp |
| プロトコル | Streamable HTTP上のMCP、ブラウザでのOAuth 2.1サインイン |
| 対応クライアント | Claudeアプリ(WebおよびDesktop)、Claude Code、Codex、およびOAuthサインインをサポートするその他のMCPクライアント |
MCP サーバーは Adapty スキルと組み合わせることで最大限の効果を発揮します。サーバーはアシスタントにアカウントへのアクセスを提供し、スキルは実績あるワークフローを提供します。フローやペイウォールの構築、アナリティクスでのテスト対象の特定はスキルに依存しています。
Adapty ツールを 6 つ使用
analytics_conversion— 国別のトライアルから有料への転換率、過去2ヶ月analytics_conversion— ドイツのトライアルから有料への転換率、プレースメント別placements_get—settings_upgradepaywalls_listab_tests_list—settings_upgradeのペイウォールテストab_tests_create— ドラフトテスト、50/50
有料への転換率の低下はドイツのみで発生しており、settings_upgrade プレースメントに限定されています(41% → 29%)。
他のすべての国は安定していました。10月2日に、settings_upgrade がペイウォール Annual first から Weekly focus に切り替わりました。Weekly focus は週次プランを前面に出しています。それ以降、そこでトライアルを開始したドイツのユーザーのトライアル終了後の有料転換が減っています。
settings_upgrade でドイツのユーザーを対象に、Annual first と Weekly focus を50/50で比較する A/B テストの下書きを作成しました。まだあなたのユーザーには何も変更は加えられていません。
テストを開始すると、今日からsettings_upgradeを開くドイツユーザーの半数に年間プランが最初に表示されます。他の国のユーザーは引き続きWeekly focusが表示されます。テストはいつでも停止できますが、開始を取り消すことはできません。開始しますか?
- はい、テストを開始する
- いいえ、下書きのままにする
Adapty スキルを追加する
MCP サーバーはアシスタントに Adapty アカウントへのアクセスを提供します。Adapty スキルはその実行方法を提供します。変更を計画し、検証し、ユーザーに影響を与えるステップごとに確認を求める、テスト済みのワークフローです。この MCP サーバーには、スキルと合わせてインストールしてください。adapty-skills プラグインにはスキルとこの MCP サーバーが含まれています。
スキルが必要な作業は 2 種類あります。
- フローとペイウォール: flow-generator スキルには、フロービルダーの設定ルールが含まれています。説明またはスクリーンショットからスクリーンを構築し、フローを保存する前にすべての変更を検証してプレビューします。スキルがない場合、アシスタントはフローの設定を読み書きできますが、有効な設定のルールを持っていません。
- アナリティクスと次にテストすべきこと: growth-advisor スキルは、どのレポートをどのように読むかを把握し、あなたの数値をA/B テストの仮説に変換します。スキルがない場合、アシスタントはチャートを取得できますが、それを説明する方法を持っていません。
Claudeアプリでプラグインを追加する
プラグインはClaudeの設定から追加できます。コマンドラインは不要です。
- Claudeで Settings → Plugins を開きます。
- Add → Add marketplace をクリックします。
- Add from a repository を選択します。
- URL フィールドに
adaptyteam/adapty-skillsと入力し、リポジトリを選択します。新しいスキルや修正を随時受け取るには、Sync automatically をオンのままにしておきます。 - Sync をクリックします。
Claude は Discover タブを開き、Adapty マーケットプレイスのプラグインを表示します。スキルをインストールするには、Adapty の行にある Add をクリックします。
スキルはClaude のサンドボックス内でスクリプトを実行します。これを許可するには、Settings → Capabilities で Code execution and file creation をオンにしてください。
コーディングエージェントにプラグインをインストールする
Claude Code、Codex、Copilot CLI、Gemini CLI、Cursor、その他のコーディングエージェントで次のコマンドを実行します。
npx adapty skills install
このコマンドは、エージェントが専用のインストーラーを持っている場合はそれを通じてプラグインをインストールします。実行後はエージェントを再起動してください。Claude Code と Codex では、プラグインによって Adapty MCP サーバーも追加されるため、アシスタントを接続する で説明しているようにサインインするだけで使えます。
MCPサーバーを使うスキルとCLIを使うスキル
各スキルは最初のステップを実行する前に、エージェントが MCPサーバー、Adapty Developer CLI、またはその両方を持っているかどうかを検出します。どちらか一方があれば、スキルはそれを使用します。両方ある場合は、作業内容に適した方を使用します。
- MCPサーバー: A/B テストの実行、SDKの統合、購入のテスト。
- Adapty CLI: フローのビルドと監査、次にテストすべき内容の検索、プレースメントのフローへの移行、セグメントの作成。これらのスキルは独自のスクリプトやファイルを実行し、CLIはそれらのファイルを直接渡します。
フローの作成と編集
flow-generator スキルをインストールして、お使いの AI コーディングツールが Adapty CLI を通じて Adapty フローの作成、翻訳、再構成を行えるようにします。
次にテストする内容を見つける
growth-advisor スキルをインストールすると、AIコーディングツールが Adapty のアナリティクスを読み取り、アプリの収益損失箇所を特定し、次の A/B テストの提案を行います。
A/B テストを実行する
ab-tests スキルをインストールして、AI コーディングツールが Adapty でペイウォールとフローの A/B テストを作成・開始・停止・置き換えできるようにしましょう。また、元に戻せない手順の前に、誰が何を見ているかを確認できます。
スキルベースの統合
adapty-integrationスキルを使って、AIコーディングツールでAdapty SDKをiOSアプリにエンドツーエンドで統合します。
アシスタントにできること
サーバーのツールは、Adapty ダッシュボードおよび Adapty Developer CLI に準拠しています。アシスタントはリクエストに応じて適切なツールを選択します。ツール名を指定する必要はありません。
| エリア | アシスタントができること | 試してみてください |
|---|---|---|
| アプリとアクセスレベル | アプリとアクセスレベルの一覧表示、作成、更新 | 「Fitness ProにアクセスレベルのPremiumを作成して。」 |
| プロダクトとオファー | プロダクトの作成とストアプロダクトIDの設定、ストアオファーとの紐付け | 「Google PlayのプロダクトIDが設定されていないプロダクトはどれ?」 |
| ペイウォール | ペイウォールの作成・更新、各ペイウォールを表示しているプレースメントの確認 | 「Annual saleのペイウォールはどのプレースメントで表示されている?」 |
| フロー | フローの作成、ビルダー設定の読み書き、バリデーション、プレビュー、公開、フロー指標の確認 | 「フロー Onboarding v2 を公開して、どのプレースメントで表示されているか教えて。」 |
| プレースメントとオーディエンス | プレースメントの作成、表示対象の変更、フロープレースメントの指標確認 | 「onboarding プレースメントでは誰に何が表示されている?」 |
| セグメント | セグメントとそのフィルターの確認 | 「セグメントの一覧と、それぞれのフィルター条件を教えて。」 |
| A/B テスト | ペイウォールおよびフローの A/B テストの作成、開始、停止、差し替え、アーカイブ | 「ドイツのユーザー向けにドラフトテスト Weekly vs annual を開始して。」 |
| アナリティクス | 売上、MRR、コンバージョン、ファネル、リテンション、LTV、インストールコホートの確認 | 「先月の国別トライアル→有料コンバージョン率を比較して。」 |
| RevenueCat からの移行 | RevenueCat のカタログを新しい Adapty アプリに移行する作業の作成・実行 | 「RevenueCat のプロジェクトを新しい Adapty アプリに移行して。」 |
Adapty Mail には専用の MCP サーバーがあります。アシスタントを Adapty Mail プロジェクトに接続するには、AI アシスタントで Adapty Mail を管理するをご覧ください。
MCPサーバーまたはCLIを選ぶ
MCPサーバーとAdapty Developer CLIは、どちらも同じAdaptyアカウントにアクセスします。アシスタントがどこで動作するかに応じて選択してください:
| Adapty MCPサーバー | Adapty CLI | |
|---|---|---|
| 動作環境 | Claudeアプリなどのチャットアプリを含む、あらゆるMCPクライアント | ターミナルコマンドを実行するエージェント、および独自のスクリプト |
| サインイン | クライアントごとに1回、ブラウザで実施 | adapty auth login、マシンごとに1回 |
| 最適な用途 | チャットからの質問や変更 | フローコンフィグの編集、一括変更、スクリプト |
| インストール | インストール不要 | npm install -g adapty |
エージェントはどちらも使用できます。Claude アプリでは、MCP サーバーの方が CLI よりもセットアップが少なくて済みます。CLI は会話のたびにインストールと認証が必要ですが、その手順は Claude アプリで Adapty CLI をセットアップする に記載されています。
始める前に
- Adapty アカウント: アシスタントは、あなたの Adapty アカウントでアクセスできる企業やアプリの範囲内で、あなたの権限に基づいて動作します。
- OAuth 対応の MCP クライアント: OAuth でサインインできるリモート MCP サーバーをクライアントがサポートしている必要があります。
アシスタントはあなたの権限で操作を行い、その変更は実際に反映されます。A/B テストの開始やプレースメントの変更は、ユーザーに即座に影響します。A/B テストの開始・停止、またはプレースメントの表示対象の変更を行う前に、サーバーはアシスタントに対して変更内容の詳細を説明させ、あなたの承認を待つよう求めます。承認する前に必ず内容を確認してください。
アシスタントを接続する
サインイン
どのクライアントも最終的に同じ場所、つまりブラウザに表示される Adapty のサインインページへ誘導されます。
- まだログインしていない場合は、Adapty アカウントでログインしてください。
- クライアントが Adapty アカウントにアクセスすることを許可してください。
クライアントはその後、あなたのアカウントでアクセスできる企業のデータを読み取ったり変更したりします。接続を切断するまでサインイン状態が維持されます。自分で開始したサインインのみを承認してください。
接続を確認するには、アシスタントにどの Adapty アカウントにサインインしているかを聞いてみてください。あなたの名前とアカウントでアクセスできる企業名が返ってくるはずです。
作業を開始する
アシスタントに参照可能なアプリを尋ね、作業対象のアプリ名を伝えましょう。試せるリクエスト例:
List my Adapty apps and their placements.
How did revenue and new subscriptions change last month compared with the month before?
Which products in Fitness Pro have no App Store product ID?
Show who sees what on the onboarding placement, including any A/B test.
Create a draft A/B test on main_paywall: the current paywall against Annual sale, 50/50.
ユーザーが目にするものを変更するステップの前に、アシスタントは確認を求めます。データの読み取りのみのリクエストは、確認なしに実行されます。
複数のステップにわたるタスクが完了した後、アシスタントはAdaptyチームにタスクの進行状況に関する短いメモを送ることができます。このメモには、アプリのユーザーの個人データは含まれません。
接続を解除する
接続を解除するには、クライアント側でサーバーを削除します。
- Claude app: Settings → Connectors で Adapty コネクターを削除します。
- Claude Code:
claude mcp remove adaptyを実行します。サーバーがadapty-skillsプラグインとともに追加された場合は、代わりに/mcpで無効化します。 - Codex:
~/.codex/config.tomlからadaptyサーバーを削除します。
再度接続するには、サーバーを追加してもう一度サインインしてください。
トラブルシューティング
| 問題 | 解決策 |
|---|---|
| Claude Code でサーバーが Needs authentication と表示される | クライアントがサーバーを追加したがサインインしていない。/mcp を実行し、Adapty サーバーを選択して Authenticate を選ぶ。 |
| クライアントに Adapty のツールが表示されない | サインインを完了してから新しいセッションを開始する。クライアントによってはセッション開始時にのみツールを読み込む場合がある。 |
| アシスタントがアプリを見つけられない | そのアプリは、あなたの Adapty アカウントがアクセスできない会社に属している。会社のオーナーにアクセス権を依頼する。 |
| クライアントがサインインを完了できない | クライアントがサーバーの使用するサインイン方式に対応していない。Claude アプリ、Claude Code、または Codex から接続するか、Adapty Developer CLI を使用する。 |