Set up the Adapty CLI in Claude Cowork

The Adapty Developer CLI works in Claude Cowork, so you can manage your Adapty account from a chat instead of a terminal. Cowork 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.

What you need:

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

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.

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.

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.

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.

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 Cowork task 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 task.

To install and authorize the CLI:

1. Start a new task in Cowork.

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

   

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

   

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

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

   

6. Back in the chat, tell Cowork you’ve authorized — for example, “done”. Cowork 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