Adapty CLI'yı Claude Cowork'te Kurma
Adapty Geliştirici CLI, Claude Cowork’te çalışır; bu sayede Adapty hesabınızı bir terminal yerine sohbet üzerinden yönetebilirsiniz. Cowork, komutları yalnızca izin verilenler listesindeki alan adlarına erişebilen bir sandbox ortamında çalıştırır; bu nedenle CLI’nın hesabınıza giriş yapabilmesi için Claude’da tek seferlik bir kurulum yapılması gerekir.
İhtiyacınız olanlar:
- Cowork ile Claude masaüstü uygulaması
- Bir Adapty hesabı
- Kurumsal Claude çalışma alanları için çalışma alanı yöneticinizin yardımı — bkz. Adapty domain’lerine izin ver
Adapty eklentisini ekleyin
Adapty eklentisi, CLI’yi kurma, kimlik doğrulama ve yönetme konusunda Claude’un takip ettiği becerileri içerir; Ads Manager çalışmaları için Apple Ads becerisi de dahildir.
Eklentiyi eklemek için:
- Claude’da Settings → Plugins bölümünü açın.
- Add → Add marketplace seçeneğine tıklayın.
- Add from a repository seçeneğini belirleyin.
- URL alanına
https://github.com/adaptyteam/apple-ads-cliyapıştırın. - Sync düğmesine tıklayın.
Adapty eklentileri, eklenti dizininde Personal altında görünür.
Adapty alan adlarına izin verin
Sandbox’ın alan adı izin listesine Adapty’yi eklemeden CLI oturum açamaz veya hesabınızı okuyamaz.
Hem adapty.io hem de *.adapty.io adreslerine izin verin. Çoğu izin listesi uygulamasında wildcard, apex alan adını kapsamaz. CLI’nin kendisi api.adapty.io adresine ulaşır; çalışırken Adapty belgelerini okuyan bir ajan ise apex adresine ulaşır.
Cowork, bir görev başladığında bu ayarları uygular. Bir konuşma sırasında erişim modunu değiştirir veya alan adı eklerseniz, o konuşma başladığı andaki ayarlarla devam eder — yeni bir görev başlatın.
Kişisel hesaplar
İzin listesini kendiniz belirlersiniz:
- Claude’da Settings → Capabilities bölümünü açın.
- Code execution and file creation seçeneğini etkinleştirin. Allow network egress bloğu bunu yapana kadar görünmez.
- Allow network egress seçeneğini etkinleştirin.
- Domain allowlist bölümünde Package managers only seçeneğini seçin.
- Additional allowed domains altında
adapty.ioekleyin, ardından*.adapty.ioekleyin.
Tüm domainler olan diğer erişim modu, sandbox’ın herhangi bir siteye ulaşmasına izin verir. Bu seçiliyken Adapty domainlerini hiç eklemezsiniz.
Kurumsal çalışma alanları
Bir yönetici izin listesini kontrol eder. Her iki alan adını da çalışma alanına eklemelerini isteyin.
CLI’yi yükleyin ve yetkilendirin
Her Cowork görevi temiz bir makinede başlar: önceki oturumdan CLI, token veya yapılandırma aktarılmaz; bu nedenle kurulum ve giriş adımları her görevin başında tekrarlanır.
CLI’yi yüklemek ve yetkilendirmek için:
-
Cowork’ta yeni bir görev başlatın.
-
Claude’dan Adapty CLI’yi yüklemesini isteyin — örneğin, “Adapty CLI’yi yükle”. Cowork, kurulum bağlantılarını açmak için izin isteyebilir — izin verin.
-
Kurulumun ardından Cowork, Adapty’ye giriş yapmanızı önerir — kabul edin; ardından bir yetkilendirme bağlantısı ve cihaz kodu gönderir. Kod yaklaşık 15 dakika içinde geçerliliğini yitirir.
-
Bağlantıyı açın. Tarayıcınızda Adapty CLI yetkilendirme sayfası açılır.
-
Sayfadaki kodun Cowork’ün size verdiği kodla eşleştiğini doğrulayın, ardından Authorize düğmesine tıklayın. Kodlar eşleşmiyorsa Deny’a tıklayın ve Cowork’ten yeni bir bağlantı isteyin.
- Sohbete geri dönün ve Cowork’e yetkilendirdiğinizi söyleyin — örneğin “tamam”. Cowork girişi doğrular ve hesap bilgilerinizi gösterir.
CLI hazır. Uygulamanızı, ürünlerinizi ve paywalllarınızı sohbet üzerinden kurmak için hızlı başlangıç kılavuzunu takip edin.
Sorun Giderme
| Sorun | Nasıl düzeltilir |
|---|---|
| Sync butonuna tıkladıktan sonra skill’ler görünmüyor | Repository URL’sinin https://github.com/adaptyteam/apple-ads-cli olduğunu doğrulayın, ardından tekrar Sync butonuna tıklayın. |
| Kurulum veya yetkilendirme sırasında ağ hataları oluşuyor | adapty.io ve *.adapty.io adreslerini domain izin listesine ekleyin. Ayarlar bir görev başladığında geçerli olur, bu nedenle ekledikten sonra yeni bir görev başlatın. |
| Yetkilendirme bağlantısı açılmıyor veya reddediliyor | Kodun geçerlilik süresi yaklaşık 15 dakikadır. Cowork’ten yeni bir bağlantı oluşturmasını isteyin. |
| Tarayıcıdaki kod sohbetteki kodla eşleşmiyor | Authorize butonuna tıklamayın. Cowork’ten yeni bir bağlantı isteyin ve baştan başlayın. |