AI asistanlarını Adapty'ye bağlayın (MCP)

Adapty MCP sunucusu, bir yapay zeka asistanını Adapty hesabınıza bağlar. Sohbet yoluyla, sade bir dille gelir ve dönüşüm verilerini sorgulayabilir, ürün ve placement’ları ayarlayabilir, flow’ları yayımlayabilir veya A/B testi başlatabilirsiniz. Asistan, tarayıcıda Adapty hesabınızla oturum açar ve izinlerinizi alır. API anahtarına gerek yoktur.


Sunucu URL’si	`https://mcp.adapty.io/mcp`
Protokol	Streamable HTTP üzerinden MCP, tarayıcıda OAuth 2.1 oturum açma
Çalıştığı ortamlar	Claude uygulaması (web ve masaüstü), Claude Code, Codex ve OAuth oturum açmayı destekleyen diğer MCP istemcileri

Important

MCP sunucusu, Adapty skill’leri ile birlikte en iyi şekilde çalışır. Sunucu, asistana hesabınıza erişim sağlar; skill’ler ise iş akışları için test edilmiş yöntemler sunar. Flow ve paywall oluşturma ile analizlerinizdeki test edilecek alanları bulma işlemleri skill’lere bağlıdır.

Claude

Geçen ay deneme sürümünden ücretli aboneliğe geçiş düştü. Nerede düştüğünü bul ve bunu geri kazanmak için bir test kur.

6 Adapty aracı kullanıldı

analytics_conversion — trial to paid, by country, last two months
analytics_conversion — trial to paid in Germany, by placement
placements_get — settings_upgrade
paywalls_list
ab_tests_list — paywall tests on settings_upgrade
ab_tests_create — a draft test, 50/50

Trial-to-paid yalnızca Almanya’da düştü, %41’den %29’a, ve yalnızca settings_upgrade placement’ında.

Diğer ülkeler sabit kaldı. 2 Ekim’de settings_upgrade, paywall’u Yıllık önce’den Haftalık odaklı’ya geçirdi; bu versiyon haftalık planı öne çıkarıyor. O tarihten bu yana, orada deneme başlatan Alman kullanıcıların daha azı deneme bitiminde ödeme yapıyor.

settings_upgrade için Almanya’daki kullanıcılara yönelik bir taslak A/B testi oluşturdum: Yıllık önce ile Haftalık odaklı, 50/50. Kullanıcılarınız için henüz hiçbir şey değişmedi.

A/B testini başlat

Testi başlatırsam, bugünden itibaren settings_upgrade’i açan Alman kullanıcıların yarısı önce Yıllık planı görecek. Diğer ülkelerdeki kullanıcılar Haftalık odağı görmeye devam edecek. Testi istediğin zaman durdurabilirsin, ancak başlatmayı geri alamazsın. Başlatayım mı?

Evet, testi başlat
Hayır, taslak olarak kalsın

Örnek bir uygulama ile yapılan örnek konuşma. Sizin numaralarınız, paywall'larınız ve testleriniz farklılık gösterecektir.

Adapty skill’lerini ekleyin

MCP sunucusu, asistanınıza Adapty hesabınıza erişim sağlar. Adapty skill’leri ise gerekli bilgi birikimini sunar: bir değişikliği planlayan, doğrulayan ve kullanıcılarınıza ulaşan her adımda onay isteyen test edilmiş iş akışlarıdır. İkisini birlikte kurun. adapty-skills eklentisi hem skill’leri hem de bu MCP sunucusunu içerir.

Skill’lere bağımlı iki tür çalışma vardır:

Flow’lar ve paywall’lar: flow-generator skill, Flow Builder’ın yapılandırma kurallarını içerir. Ekran görüntüsünden veya bir açıklamadan ekranlar oluşturur; her değişikliği flow’u kaydetmeden önce doğrular ve önizler. Skill olmadan, bir asistan flow yapılandırmasını okuyup yazabilir; ancak geçerli bir yapılandırma için gerekli kurallara sahip değildir.
Analitik ve sırada ne test edilmeli: growth-advisor skill, hangi raporların okunacağını ve nasıl okunacağını bilir; sayılarınızı A/B testi için hipotezlere dönüştürür. Skill olmadan, bir asistan grafiklerinizi getirebilir; ancak bunları açıklamak için bir yöntemi yoktur.

Claude uygulamasında eklentiyi ekleyin

Eklentiyi Claude ayarlarından ekleyebilirsiniz; komut satırı gerekmez.

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 adaptyteam/adapty-skills girin ve depoyu seçin. Yeni skill’ler ve düzeltmeler çıktıkça otomatik olarak almak için Sync automatically seçeneğini açık bırakın.
Sync düğmesine tıklayın.

Add marketplace dialog in Claude with adaptyteam/adapty-skills in the URL field and Sync automatically turned on

Claude, Discover sekmesini Adapty marketplace’indeki eklentilerle birlikte açar. Skill’leri yüklemek için Adapty satırında Add düğmesine tıklayın.

Discover tab in Claude listing the Adapty, Apple ads, and Apple ads benchmarks plugins, each with an Add button

Skill’ler betiklerini Claude’un sandbox ortamında çalıştırır. Buna izin vermek için Settings → Capabilities bölümünde Code execution and file creation seçeneğini açın.

Bir kodlama ajanına eklenti ekleyin

Claude Code, Codex, Copilot CLI, Gemini CLI, Cursor ve diğer kodlama ajanlarında şunu çalıştırın:

npx adapty skills install

Bu komut, ajanınızın kendi yükleyicisi varsa eklentiyi o yükleyici aracılığıyla kurar. Kurulumdan sonra ajanınızı yeniden başlatın. Claude Code ve Codex’te eklenti aynı zamanda Adapty MCP sunucusunu da ekler; bu nedenle yalnızca Asistanınızı bağlayın bölümünde anlatıldığı gibi giriş yapmanız yeterlidir.

Hangi skill'ler MCP sunucusunu, hangileri CLI'yi kullanır

Her skill, ilk adımından önce agent’ınızın MCP sunucusuna, Adapty Geliştirici CLI’a veya her ikisine birden sahip olup olmadığını tespit eder. Biri mevcutsa skill onu kullanır. Her ikisi de mevcutsa skill, işine en uygun olanı seçer:

MCP sunucusu: A/B testleri çalıştırma, SDK entegrasyonu ve satın alma testleri.
Adapty CLI: Flow oluşturma ve denetleme, neyin test edileceğini bulma, placement’ları flow’lara taşıma ve segment oluşturma. Bu skill’ler kendi script ve dosyalarını çalıştırır; CLI dosyaları doğrudan onlara iletir.

Flow'ları oluşturun ve düzenleyin

Flow oluşturucu skill'i kurarak kendi AI kodlama aracınızın Adapty CLI üzerinden Adapty flow'ları oluşturmasını, çevirmesini ve yeniden yapılandırmasını sağlayın.

Sırada ne test edeceğinizi bulun

growth-advisor skillini yükleyin; AI kodlama aracınız Adapty analizlerinizi okusun, uygulamanızın nerede gelir kaybettiğini bulsun ve bir sonraki A/B testini önereceği alanları belirlesin.

A/B testi çalıştırın

ab-tests skillini yükleyerek AI kodlama aracınızın Adapty'de paywall ve flow A/B testleri oluşturmasını, başlatmasını, durdurmasını ve değiştirmesini sağlayın; geri alınamaz her adımdan önce kimin neyi gördüğünü görün.

Skill'e dayalı entegrasyon

AI kodlama aracınızla Adapty SDK'yı iOS uygulamanıza uçtan uca entegre etmek için adapty-integration skill'ini kullanın.

Asistanın yapabilecekleri

Sunucunun araçları, Adapty Kontrol Paneli ve Adapty Developer CLI ile uyumludur. Asistan, talebinize uygun araçları kendisi seçer; siz araç adı belirtmezsiniz.

Alan	Asistan ne yapabilir	Örnek sorular
Uygulamalar ve access level’lar	Uygulamaları ve access level’ları listeler, oluşturur ve günceller	”Fitness Pro’da `premium` access level oluştur.”
Ürünler ve teklifler	Store ürün ID’leriyle ürünler oluşturur ve store tekliflerini ürünlere bağlar	”Hangi ürünlerimin Google Play ürün ID’si yok?”
Paywall’lar	Paywall oluşturur ve günceller, her paywall’ı hangi placement’ların gösterdiğini bulur	”Annual sale paywall’ını hangi placement’lar gösteriyor?”
Flow’lar	Flow oluşturur, builder config’lerini okur ve yazar, doğrular, önizler, yayınlar ve flow metriklerini okur	”Onboarding v2 flow’unu yayınla ve hangi placement’ların gösterdiğini söyle.”
Placement’lar ve kitleler	Placement oluşturur, kimin ne gördüğünü değiştirir ve flow placement metriklerini okur	”`onboarding` placement’ında kim ne görüyor?”
Segmentler	Segmentleri ve filtrelerini okur	”Segmentlerimi ve her birinin hangi filtreleri kullandığını listele.”
A/B testleri	Paywall ve flow A/B testleri oluşturur, başlatır, durdurur, değiştirir ve arşivler	”Almanya’daki kullanıcılar için Weekly vs annual taslak testini başlat.”
Analitik	Geliri, MRR’ı, dönüşümleri, hunisini, elde tutmayı, LTV’yi ve yükleme kohortlarını okur	”Geçen ay için ülkeye göre deneme-ücretli dönüşümünü karşılaştır.”
RevenueCat’ten geçiş	RevenueCat kataloğunuzu yeni bir Adapty uygulamasına taşımak için geçiş oluşturur ve çalıştırır	”RevenueCat projemi yeni bir Adapty uygulamasına taşı.”

Adapty Mail’in kendi MCP sunucusu vardır. Bir asistanı Adapty Mail projenize bağlamak için bkz. Adapty Mail’i AI asistanlarla yönetin.

MCP sunucusunu veya CLI’yi seçin

MCP sunucusu ve Adapty Developer CLI, aynı Adapty hesabına erişir. Asistanınızın nerede çalıştığına göre seçim yapın:

	Adapty MCP sunucusu	Adapty CLI
Çalıştığı yer	Claude uygulaması gibi sohbet uygulamaları dahil tüm MCP istemcileri	Terminal komutları çalıştıran agent’lar ve kendi betikleriniz
Oturum açma	İstemci başına bir kez, tarayıcıda	`adapty auth login`, makine başına bir kez
En iyi kullanım	Sohbet üzerinden sorular ve değişiklikler	Flow config dosyalarını düzenleme, toplu değişiklikler ve betikler
Kurulum	Kurulum gerekmez	`npm install -g adapty`

Bir agent her ikisini de kullanabilir. Claude uygulamasında MCP sunucusu, CLI’ya kıyasla daha az kurulum gerektirir: CLI’nın her konuşmada yüklenmesi ve yetkilendirilmesi gerekir; bu işlem Claude uygulamasında Adapty CLI’yi kurma bölümünde açıklanmaktadır.

Başlamadan Önce

Adapty hesabı: Asistan, Adapty hesabınızın erişebildiği şirket ve uygulamalarda, sizin izinlerinizle çalışır.
OAuth destekli MCP istemcisi: İstemciniz, OAuth ile oturum açan uzak MCP sunucularını desteklemelidir.

Warning

Asistan sizin haklarınızla hareket eder ve yaptığı değişiklikler gerçektir. Başlatılan bir A/B testi veya güncellenen bir placement kullanıcılarınıza ulaşır. Asistan bir A/B testi başlatmadan veya durdurmadan ya da bir placement’ta kimin ne göreceğini değiştirmeden önce, sunucu ondan tam etkiyi açıklamasını ve onayınızı beklemesini ister. Onaylamadan önce planı okuyun.

Asistanınızı bağlayın

Claude uygulaması (claude.ai ve Claude desktop), uzak MCP sunucularını özel bağlayıcılar olarak ekler.

Sunucuyu eklemek için Settings → Connectors bölümünü açın ve Add custom connector seçeneğine tıklayın.
Bir ad girin, örneğin Adapty, ve URL olarak https://mcp.adapty.io/mcp yazın.
Varsayılan kimlik doğrulama ayarlarını koruyun ve Add seçeneğine tıklayın.
Açılan tarayıcı sekmesinde Adapty’ye giriş yapın. Bkz. Giriş yap.

Workspace yöneticileri, bağlayıcıyı tüm organizasyon için bir kez ekleyebilir. Her üye, ilk kullanımında kendi Adapty hesabıyla giriş yapar.

adapty-skills eklentisini kullanıyorsanız, Claude Code sunucuyu zaten plugin:adapty-skills:adapty olarak listeler ve durumu Needs authentication şeklinde gösterir. Giriş yapmak için Claude Code’da /mcp komutunu çalıştırın, plugin:adapty-skills:adapty seçeneğini belirleyin ve Authenticate seçeneğine tıklayın.

Eklenti kullanmıyorsanız, önce sunucuyu ekleyin:

claude mcp add --transport http --scope user adapty https://mcp.adapty.io/mcp

Ardından Claude Code’da /mcp komutunu çalıştırın, adapty seçeneğini seçin ve Authenticate üzerine tıklayın. Adapty araçları mevcut oturumda görünmüyorsa yeni bir oturum başlatın.

adapty-skills eklentisini kullanıyorsanız, eklenti sunucuyu otomatik olarak ekler ve Codex bağlandığında oturum açmanızı ister.

Eklenti kullanmadan sunucuyu eklemek ve oturum açmak için:

codex mcp add adapty --url https://mcp.adapty.io/mcp
codex mcp login adapty

Giriş komutu tarayıcınızı açar. Sunucuyu manuel olarak yapılandırmak için ~/.codex/config.toml dosyasına ekleyin, ardından giriş komutunu çalıştırın:

[mcp_servers.adapty]
url = "https://mcp.adapty.io/mcp"

Adapty araçlarını yüklemek için yeni bir codex oturumu başlatın.

https://mcp.adapty.io/mcp adresini istemcinizin ayarlarında veya MCP yapılandırma dosyasında uzak bir MCP sunucusu olarak ekleyin. İstemci, ilk bağlantıda oturum açmanız için tarayıcınızı açar.

Sunucu, her istemciyi Mevcut MCP spesifikasyonunun istemci kayıt yöntemi olan Client ID Metadata Document ile tanımlar. Bu yöntemi desteklemeyen bir istemci oturum açmayı tamamlayamaz. Bu durumda, terminal ajanı yerine Adapty Developer CLI kullanın.

Her istemci aynı yere yönlendirilir: tarayıcınızdaki Adapty oturum açma sayfasına.

Henüz oturum açmadıysanız Adapty hesabınızla giriş yapın.
İstemcinin Adapty hesabınıza erişmesine izin verin.

İstemci bundan sonra hesabınızın erişebildiği şirketlerdeki verileri okuyup değiştirebilir ve siz bağlantıyı kesene kadar oturumu açık kalır. Yalnızca kendinizin başlattığı oturum açma isteklerini onaylayın.

Bağlantıyı doğrulamak için asistana hangi Adapty hesabıyla oturum açtığını sorun. Yanıtta adınız ve hesabınızın erişebildiği şirketler görünmelidir.

Çalışmaya Başlama

Asistana hangi uygulamaları görebildiğini sorun, ardından üzerinde çalışmak istediğiniz uygulamanın adını belirtin. Deneyebileceğiniz bazı istekler:

List my Adapty apps and their placements.
How did revenue and new subscriptions change last month compared with the month before?
Which products in Fitness Pro have no App Store product ID?
Show who sees what on the onboarding placement, including any A/B test.
Create a draft A/B test on main_paywall: the current paywall against Annual sale, 50/50.

Asistan, kullanıcıların gördüklerini değiştiren adımlardan önce onay ister. Yalnızca veri okuyan bir istek soru sormadan çalışır.

Birden fazla adımdan oluşan bir görevin ardından asistan, Adapty ekibine görevin nasıl geçtiğine dair kısa bir not gönderebilir. Not, uygulamanızın kullanıcılarına ait hiçbir kişisel veri içermez.

Bağlantıyı Kes

Bağlantıyı kesmek için sunucuyu istemciden kaldırın:

Claude app: Settings → Connectors bölümünde Adapty connector’ını kaldırın.
Claude Code: claude mcp remove adapty komutunu çalıştırın. Sunucu adapty-skills eklentisiyle geldiyse /mcp üzerinden devre dışı bırakın.
Codex: adapty sunucusunu ~/.codex/config.toml dosyasından kaldırın.

Yeniden bağlanmak için sunucuyu ekleyin ve tekrar oturum açın.

Sorun Giderme

Sorun	Çözüm
Claude Code sunucuyu Needs authentication olarak gösteriyor	İstemci sunucuyu ekledi ancak giriş yapılmadı. `/mcp` komutunu çalıştırın, Adapty sunucusunu seçin ve Authenticate seçeneğini seçin.
İstemci hiç Adapty aracı listelemiyor	Girişi tamamlayın, ardından yeni bir oturum başlatın. Bazı istemciler araçları yalnızca oturum başlangıcında yükler.
Asistan bir uygulamayı bulamıyor	Uygulama, Adapty hesabınızın erişemediği bir şirkete ait. Erişim için şirket sahibinden talepte bulunun.
İstemci girişi tamamlayamıyor	İstemci, sunucunun kullandığı giriş yöntemini desteklemiyor. Claude uygulamasından, Claude Code’dan veya Codex’ten bağlanın ya da Adapty Developer CLI kullanın.