Adapty Developer CLI クイックスタートガイド

Adapty CLI を使えば、アプリの設定をすべてコマンドラインから行えます。ターミナルツールや MCP クライアントを好む場合は、ダッシュボードのクイックスタートの代わりに使用してください。

完了すると、アプリ、アクセスレベル、プロダクト、ペイウォール、プレースメントがすべて Adapty ダッシュボードに表示されます。

Claude Cowork で CLI を実行する場合は、開始前に Adapty のドメインを許可してください。詳しくはCowork で CLI を実行するをご覧ください。

1. CLI をインストールする

Node.js 18 以降が必要です。

CLI をインストールするには、次のコマンドを実行します：

npm install -g adapty

または、直接実行する場合：

npx adapty auth login

2. 認証する

ログインコマンドを実行して、CLI を Adapty アカウントに接続します。

adapty auth login

CLI がブラウザタブを開きます。ターミナルに表示されたコードとブラウザに表示されたコードが一致していることを確認し、Authorize をクリックします。認証が完了するとターミナルに確認メッセージが表示されます。

3. アプリを作成する

Adapty のアプリはモバイルアプリケーションを表します。1 つの Adapty アプリが App Store と Google Play の両方に接続されるため、公開するストアの数に関わらず、作成するのは 1 つで十分です。

adapty apps create --title "My App" --platform ios --platform android --apple-bundle-id com.example.app --google-bundle-id com.example.app

adapty apps create --title "My App" --platform ios --apple-bundle-id com.example.app

adapty apps create --title "My App" --platform android --google-bundle-id com.example.app

このコマンドは <app-id> を返します。以降のコマンドではすべてこの ID を使用します。

4. アクセスレベルを作成する（任意）

アクセスレベルは、購入後にユーザーがアクセスできる内容を管理します。特定のプロダクトを購入したかどうかを確認する代わりに、アプリはユーザーが特定のアクセスレベルを持っているかどうかを確認します。これにより、アプリのロジックを特定のプロダクト ID から切り離すことができます。

premium アクセスレベルは新しいアプリとともに自動的に作成されます。ほとんどのアプリではこの手順はスキップできます。 手順 5 ではアクセスレベル ID として premium を使用してください。

異なるプロダクトが異なるユーザーグループの異なる機能をアンロックする場合 — たとえば「Basic」サブスクライバーと「Pro」サブスクライバーがアプリの異なる部分にアクセスできる場合 — にのみ、このコマンドを実行してください。

adapty access-levels create --app <app-id> --sdk-id "pro" --title "Pro"

• --sdk-id はアプリコード内でユーザーがその機能を利用できるかどうかを確認するために使う識別子です（例：if user.hasAccessLevel("pro")）。この手順をスキップしてデフォルトのアクセスレベルを使う場合、その --sdk-id は premium です。
• --title は Adapty ダッシュボードでの参照用に表示されるラベルです。

このコマンドは <access-level-id> を返します。

5. プロダクトを作成する

Adapty におけるプロダクトは、アプリが販売するもの — サブスクリプションや買い切り購入 — を表します。App Store Connect と Google Play のアイテムを 1 つの Adapty プロダクトにまとめて、一元管理できます。

各ストアのプロダクト ID が必要です：App Store Connect の Apple プロダクト ID、および Google Play Console の Android プロダクト ID とベースプラン ID。確認方法の詳細はプロダクトを参照してください。

ステップ4をスキップした場合は、ステップ3の apps create コマンドで返された default_access_level.id を <access-level-id> として使用してください。

adapty products create --app <app-id> --title "My Product" --access-level-id <access-level-id> --period monthly --ios-product-id <your.apple.id> --android-product-id <your.google.id> --android-base-plan-id <your.base-plan.id>

adapty products create --app <app-id> --title "My Product" --access-level-id <access-level-id> --period monthly --ios-product-id <your.apple.id>

adapty products create --app <app-id> --title "My Product" --access-level-id <access-level-id> --period monthly --android-product-id <your.google.id> --android-base-plan-id <your.base-plan.id>

コマンドは <product-id> を返します。

このプロダクトをStripeまたはPaddleを通じてウェブでも販売する場合は、同じコマンドにそれらのIDを追加してください。コマンドリファレンスの products create を参照してください。

6. ペイウォールを作成する

ペイウォールはプロダクトを格納するコンテナです。Adapty では、ペイウォールがユーザーにプロダクトを届ける唯一の方法です。すべてのプロダクトは、アプリに表示される前にペイウォールに含まれている必要があります。

adapty paywalls create --app <app-id> --title "My Paywall" --product-id <product-id>

adapty paywalls create --app <app-id> --title "My Paywall" --product-id <product-id-1> --product-id <product-id-2>

このコマンドは <paywall-id> を返します。

7. プレースメントを作成する

プレースメントは、アプリ内でペイウォールを表示する場所を指します。アプリコードにハードコードするのはプレースメント ID だけです。どのペイウォールをどのユーザーに表示するかといった設定はすべて、新しいアプリバージョンをリリースすることなくダッシュボードから管理できます。

--developer-id は、後でアプリコードからこの場所に表示するペイウォールを Adapty に問い合わせる際に参照する文字列です。場所を表すわかりやすい名前（例："main"、"onboarding"、"settings"）を指定してください。

adapty placements create --app <app-id> --title "Main" --developer-id "main" --audiences '[{"segment_ids":[],"paywall_id":"<paywall-id>","priority":0}]'

--audiences フラグは、どのユーザーにどのペイウォールを表示するかを制御します。上の例では単一のデフォルトオーディエンスを設定しており、このプレースメントのすべてのユーザーに同じペイウォールが表示されます。

Cowork で CLI を実行する

Claude Cowork はコマンドを、許可リストに登録されたドメインにのみアクセスできるサンドボックス内で実行します。Adapty を許可しない限り、CLI はサインインもアカウントの読み取りもできません。自分のターミナルから CLI を実行する場合は、このセクションをスキップしてください。

adapty.io と *.adapty.io の両方を許可してください。ほとんどの許可リスト実装では、ワイルドカードは頂点ドメイン（apex domain）をカバーしません。CLI 自体は api.adapty.io にアクセスし、作業中に Adapty のドキュメントを読むエージェントは頂点ドメインにアクセスします。

Cowork applies these settings when a task starts. If you change the access mode or add a domain during a conversation, that conversation keeps the settings it started with — start a new task.

A task also starts on a clean machine: no CLI, no token, and no config carries over from a previous session, so the install and login steps repeat at the start of each one.

個人アカウント

許可リストはご自身で設定します：

1. Claude で Settings → Capabilities を開きます。
2. Code execution and file creation をオンにします。これをオンにするまで、Allow network egress ブロックは表示されません。
3. Allow network egress をオンにします。
4. Domain allowlist で Package managers only を選択します。
5. Additional allowed domains に adapty.io を追加し、次に *.adapty.io を追加します。

もう一方のアクセスモード、All domains を選択すると、サンドボックスはあらゆるサイトにアクセスできるようになります。この場合、Adapty のドメインを追加する必要はありません。

企業向けワークスペース

ワークスペースの管理者が許可リストを管理しています。両ドメインをワークスペースに追加するよう管理者に依頼してください。

次のステップ

すべてのエンティティが Adapty ダッシュボード に表示されるようになりました。次のステップ：

• ペイウォールをデザインする — ノーコードのペイウォールビルダーを使って、作成したペイウォールにビジュアル、レイアウト、コピーを追加します。
• Adapty SDK を統合する — アプリに SDK を追加して、プレースメントを取得・表示します。
• 異なるユーザー セグメント を異なるペイウォールにルーティングする — コマンドリファレンスの placements update と segments list を参照してください。