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

Set up the Adapty CLI in the Claude app

The Adapty Developer CLI works in the Claude app, so you can manage your Adapty account from a chat instead of a terminal. Claude runs commands in a sandbox that reaches only allowlisted domains, so the CLI needs a one-time setup in Claude before it can sign in to your account.

Note

Claude Cowork and chat are now one Claude: anything you did in Cowork, you can now do in any conversation. The merge is rolling out by plan. If your plan still has a separate Cowork, follow the same steps and start each task in Cowork.

What you need:

  • The Claude app
  • An Adapty account
  • For corporate Claude workspaces, help from your workspace administrator — see Allow the Adapty domains
Tip

To manage your Adapty account from the Claude app with less setup, connect the Adapty MCP server instead. You add it once as a custom connector, and it needs no allowlisted domains and no login in each conversation.

Add the Adapty plugin

The Adapty plugin includes the skills Claude follows to install, authenticate, and drive the CLI, including the Apple Ads skill for Ads Manager work.

To add the plugin:

  1. In Claude, open Settings → Plugins.
  2. Click Add → Add marketplace.
  3. Select Add from a repository.
  4. In the URL field, paste https://github.com/adaptyteam/apple-ads-cli.
  5. Click Sync.
Add marketplace dialog in Claude with the Adapty repository URL and the Sync button

The Adapty plugins appear under Personal in the plugin directory.

Allow the Adapty domains

Until you allow Adapty in the sandbox’s domain allowlist, the CLI can’t sign in or read your account.

Allow both adapty.io and *.adapty.io. A wildcard doesn’t cover the apex domain in most allowlist implementations. The CLI itself reaches api.adapty.io, and an agent that reads the Adapty documentation while it works reaches the apex.

Claude applies these settings when a conversation 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 conversation.

Personal accounts

You set the allowlist yourself:

  1. In Claude, open Settings → Capabilities.
  2. Turn on Code execution and file creation. The Allow network egress block stays hidden until you do.
  3. Turn on Allow network egress.
  4. In Domain allowlist, select Package managers only.
  5. Under Additional allowed domains, add adapty.io, then add *.adapty.io.
Allow network egress settings in Claude, with adapty.io and *.adapty.io in the additional allowed domains list

The other access mode, All domains, lets the sandbox reach any site. With that selected, you don’t add the Adapty domains at all.

Corporate workspaces

An administrator controls the allowlist. Ask them to add both domains for the workspace.

Install and authorize the CLI

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

To install and authorize the CLI:

  1. Start a new conversation in Claude.

  2. Ask Claude to install the Adapty CLI — for example, “Install the Adapty CLI”. Claude may ask permission to open installation links — allow it.

    A Claude chat where Claude confirms the Adapty CLI is installed

  3. After the installation, Claude offers to sign in to Adapty — agree, and it posts an authorization link with a device code. The code expires in about 15 minutes.

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

  4. Open the link. The Adapty CLI authorization page opens in your browser.

  5. Verify that the code on the page matches the code Claude gave you, then click Authorize. If the codes don’t match, click Deny and ask Claude for a new link.

    The Adapty CLI authorization page in a browser showing the device code and the Authorize button

  6. Back in the chat, tell Claude you’ve authorized — for example, “done”. Claude verifies the login and prints your account details.

The CLI is ready. To set up your app, products, and paywalls from the chat, follow the quickstart guide.

Troubleshooting

ProblemHow to fix it
Skills don’t appear after you click SyncVerify the repository URL is https://github.com/adaptyteam/apple-ads-cli, then click Sync again.
Network errors during installation or authorizationAdd both adapty.io and *.adapty.io to the domain allowlist. Settings apply when a conversation starts, so start a new conversation after adding them.
The authorization link doesn’t open or is rejectedThe code expires in about 15 minutes. Ask Claude to generate a new link.
The code in the browser doesn’t match the code in the chatDon’t click Authorize. Ask Claude for a new link and start over.