Configurer le CLI Adapty dans l'application Claude

Le CLI développeur Adapty fonctionne dans l’application Claude, ce qui vous permet de gérer votre compte Adapty depuis une conversation plutôt qu’un terminal. Claude exécute les commandes dans un sandbox qui n’accède qu’aux domaines autorisés, donc le CLI nécessite une configuration unique dans Claude avant de pouvoir se connecter à votre compte.

Note

Claude Cowork et chat ne font désormais plus qu’un : tout ce que vous faisiez dans Cowork, vous pouvez maintenant le faire dans n’importe quelle conversation. La fusion est déployée progressivement selon les plans. Si votre plan dispose encore d’un Cowork séparé, suivez les mêmes étapes et démarrez chaque tâche dans Cowork.

Ce dont vous avez besoin :

L’application Claude
Un compte Adapty
Pour les espaces de travail Claude d’entreprise, l’aide de votre administrateur d’espace de travail — voir Autoriser les domaines Adapty

Tip

Pour gérer votre compte Adapty depuis l’application Claude avec moins de configuration, connectez plutôt le serveur MCP Adapty. Vous l’ajoutez une seule fois en tant que connecteur personnalisé, sans domaines à autoriser et sans connexion à chaque conversation.

Ajouter le plugin Adapty

Le plugin Adapty regroupe les instructions que Claude suit pour installer, authentifier et piloter le CLI, y compris la skill Apple Ads pour les tâches dans Ads Manager.

Pour ajouter le plugin :

Dans Claude, ouvrez Settings → Plugins.
Cliquez sur Add → Add marketplace.
Sélectionnez Add from a repository.
Dans le champ URL, collez https://github.com/adaptyteam/apple-ads-cli.
Cliquez sur Sync.

Boîte de dialogue d'ajout de marketplace dans Claude avec l'URL du dépôt Adapty et le bouton Sync

Les plugins Adapty apparaissent sous Personal dans le répertoire des plugins.

Autoriser les domaines Adapty

Tant que vous n’autorisez pas Adapty dans la liste des domaines autorisés du sandbox, le CLI ne peut pas se connecter ni lire votre compte.

Autorisez adapty.io et *.adapty.io. Un joker ne couvre pas le domaine racine dans la plupart des implémentations de listes blanches. Le CLI lui-même atteint api.adapty.io, et un agent qui consulte la documentation Adapty pendant son travail atteint le domaine racine.

Claude applique ces paramètres au démarrage d’une conversation. Si vous modifiez le mode d’accès ou ajoutez un domaine en cours de conversation, cette conversation conserve les paramètres avec lesquels elle a démarré — commencez une nouvelle conversation.

Comptes personnels

Vous configurez vous-même la liste d’autorisation :

Dans Claude, ouvrez Settings → Capabilities.
Activez Code execution and file creation. Le bloc Allow network egress reste masqué jusqu’à ce que vous le fassiez.
Activez Allow network egress.
Dans Domain allowlist, sélectionnez Package managers only.
Sous Additional allowed domains, ajoutez adapty.io, puis ajoutez *.adapty.io.

Paramètres Allow network egress dans Claude, avec adapty.io et *.adapty.io dans la liste des domaines autorisés supplémentaires

L’autre mode d’accès, All domains, permet au sandbox d’accéder à n’importe quel site. Avec cette option, vous n’avez pas besoin d’ajouter les domaines Adapty.

Espaces de travail d’entreprise

Un administrateur contrôle la liste d’autorisations. Demandez-lui d’ajouter les deux domaines pour l’espace de travail.

Installer et autoriser le CLI

Chaque conversation commence sur une machine vierge : ni CLI, ni token, ni configuration ne sont conservés d’une conversation à l’autre. Les étapes d’installation et de connexion se répètent donc au début de chaque conversation.

Pour installer et autoriser le CLI :

Démarrez une nouvelle conversation dans Claude.
Demandez à Claude d’installer le CLI Adapty — par exemple, « Install the Adapty CLI ». Claude peut demander l’autorisation d’ouvrir des liens d’installation — acceptez.
Une fois l’installation terminée, Claude propose de se connecter à Adapty — acceptez, et il publie un lien d’autorisation avec un code d’appareil. Le code expire dans environ 15 minutes.
Ouvrez le lien. La page d’autorisation de l’Adapty CLI s’ouvre dans votre navigateur.
Vérifiez que le code affiché sur la page correspond au code que Claude vous a donné, puis cliquez sur Authorize. Si les codes ne correspondent pas, cliquez sur Deny et demandez à Claude un nouveau lien.
De retour dans le chat, dites à Claude que vous avez autorisé — par exemple, « done ». Claude vérifie la connexion et affiche les détails de votre compte.

Le CLI est prêt. Pour configurer votre app, vos produits et vos paywalls depuis le chat, suivez le guide de démarrage rapide.

Résolution des problèmes

Problème	Comment le résoudre
Les skills n’apparaissent pas après avoir cliqué sur Sync	Vérifiez que l’URL du dépôt est `https://github.com/adaptyteam/apple-ads-cli`, puis cliquez à nouveau sur Sync.
Erreurs réseau pendant l’installation ou l’autorisation	Ajoutez `adapty.io` et `*.adapty.io` à la liste des domaines autorisés. Les paramètres s’appliquent au démarrage d’une conversation, donc démarrez une nouvelle conversation après les avoir ajoutés.
Le lien d’autorisation ne s’ouvre pas ou est refusé	Le code expire au bout d’environ 15 minutes. Demandez à Claude de générer un nouveau lien.
Le code dans le navigateur ne correspond pas au code dans le chat	Ne cliquez pas sur Authorize. Demandez à Claude un nouveau lien et recommencez depuis le début.