English 中文TürkçeРусскийFrançaisTiếng ViệtEspañol日本語

Claude アプリで Adapty CLI をセットアップする

Adapty Developer CLI は Claude アプリでも動作するため、ターミナルではなくチャットから Adapty アカウントを管理できます。Claude はコマンドをサンドボックス内で実行し、許可済みドメインにのみアクセスできるため、アカウントにサインインする前に Claude 側で一度だけセットアップが必要です。

Note

Claude CoworkとチャットはAIが一つのClaudeに統合されました：Coworkでできたことは、どの会話でも実行できるようになりました。統合はプランごとに順次展開中です。お使いのプランにCoworkが別途ある場合は、同じ手順に従って各タスクをCoworkで開始してください。

必要なもの：

  • Claudeアプリ
  • Adaptyアカウント
  • 企業向けClaude ワークスペースの場合は、ワークスペース管理者のサポート — Adaptyドメインを許可する を参照
Tip

セットアップを最小限にしてClaudeアプリからAdaptyアカウントを管理するには、代わりにAdapty MCPサーバーを接続してください。カスタムコネクターとして一度追加するだけで、許可リストへのドメイン登録も、会話ごとのログインも不要です。

Adapty プラグインを追加する

Adapty プラグインには、CLI のインストール、認証、操作を行うためのスキルが含まれており、Ads Manager の作業用の Apple Ads スキルも含まれています。

プラグインを追加するには：

  1. Claude で Settings → Plugins を開きます。
  2. Add → Add marketplace をクリックします。
  3. Add from a repository を選択します。
  4. URL フィールドに https://github.com/adaptyteam/apple-ads-cli を貼り付けます。
  5. Sync をクリックします。
AdaptyリポジトリURLとSyncボタンが表示されたClaudeのマーケットプレイス追加ダイアログ

Adapty プラグインはプラグインディレクトリの Personal の下に表示されます。

Adapty ドメインを許可する

サンドボックスのドメイン許可リストに Adapty を追加するまで、CLI はサインインやアカウントの読み取りができません。

adapty.io と *.adapty.io の両方を許可してください。ほとんどの許可リスト実装では、ワイルドカードは apex ドメインをカバーしません。CLI 自体は api.adapty.io に接続し、作業中に Adapty ドキュメントを参照するエージェントは apex ドメインに接続します。

Claude はこれらの設定を会話開始時に適用します。会話中にアクセスモードを変更したりドメインを追加したりしても、その会話は開始時の設定を引き継ぎます — 新しい会話を開始してください。

個人アカウント

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

  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 を追加します。
Claude の Allow network egress 設定画面。追加許可ドメインリストに adapty.io と *.adapty.io が入力されている

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

企業ワークスペース

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

CLI のインストールと認証

会話は毎回クリーンな状態から始まります。CLI もトークンも設定も前の会話から引き継がれないため、インストールとログインの手順は会話のたびに繰り返す必要があります。

CLI をインストールして認証するには：

  1. Claude で新しい会話を開始します。

  2. Claude に Adapty CLI のインストールを依頼します。例：「Install the Adapty CLI」。Claude がインストールリンクを開く許可を求める場合があります — 許可してください。

    A Claude chat where Claude confirms the Adapty CLI is installed

  3. インストールが完了すると、Claude が Adapty へのサインインを提案します。同意すると、デバイスコード付きの認証リンクが投稿されます。コードは約15分で期限切れになります。

    A Claude chat where Claude posts the Adapty authorization link and device code

  4. リンクを開くと、ブラウザに Adapty CLI の認証ページが表示されます。

  5. ページに表示されているコードが Claude から提示されたコードと一致していることを確認し、Authorize をクリックします。コードが一致しない場合は Deny をクリックし、Claude に新しいリンクを要求してください。

    ブラウザに表示されたAdapty CLI認証ページ。デバイスコードと「Authorize」ボタンが表示されています

  6. チャットに戻り、認証が完了したことをClaudeに伝えます — 例えば「done」と入力します。Claudeがログインを確認し、アカウントの詳細を表示します。

CLIの準備が整いました。チャットからアプリ、プロダクト、ペイウォールを設定するには、クイックスタートガイドに従ってください。

トラブルシューティング

問題対処方法
Sync をクリックしてもスキルが表示されないリポジトリURLが https://github.com/adaptyteam/apple-ads-cli であることを確認し、Sync を再度クリックしてください。
インストールまたは認証中にネットワークエラーが発生するadapty.io と *.adapty.io の両方をドメイン許可リストに追加してください。設定は会話の開始時に適用されるため、追加後は新しい会話を開始してください。
認証リンクが開かない、または拒否されるコードは約15分で期限切れになります。Claudeに新しいリンクの生成を依頼してください。
ブラウザのコードとチャットのコードが一致しないAuthorize をクリックしないでください。Claudeに新しいリンクを依頼し、最初からやり直してください。