https://github.com/tunaarikaya/magaza-mcp — bunu kur, AGENTS.md'yi oku

Sen: Nota Defteri'nin aylık aboneliği App Store'da ve Play'de Türkiye'de kaç para?

Asistan: App Store'da ₺129,99, Play'de ₺99,99. Play tarafı belirgin biçimde daha ucuz — iki mağazada aynı fiyatı istiyorsan Play'deki temel planı güncellemen gerekiyor.

Bu soruyu tek çağrıda cevaplayabilen başka bir MCP sunucusu yok, çünkü hepsi tek mağazaya bakıyor. magaza-mcp ikisini aynı anda görür.

flowchart LR
    A["🤖 Asistanın<br/>Claude · Antigravity · Cursor"] -->|MCP / stdio| B["📦 magaza-mcp<br/>senin makinende"]
    B -->|appstore__| C["🍎 App Store Connect"]
    B -->|play__| D["🤖 Google Play"]
    B -->|magaza__| E["🔀 İkisi birden<br/>karşılaştırma · teşhis"]
    E -.-> C
    E -.-> D
    F["🔑 Anahtar Zinciri"] -.->|anahtarlar burada kalır| B

    style B fill:#2d6cdf,stroke:#1a4a9e,color:#fff
    style E fill:#7c3aed,stroke:#5b21b6,color:#fff
    style F fill:#059669,stroke:#047857,color:#fff

Araya giren sunucu yok: paket senin makinende çalışır, doğrudan Apple ve Google ile konuşur, anahtarın Anahtar Zinciri'nden dışarı çıkmaz.

Piyasadaki MCP sunucularının neredeyse hepsi tek mağazalı. İkisini birden kullanmak istiyorsan iki ayrı sunucu kurar, iki ayrı araç setiyle uğraşır ve karşılaştırma gerektiren her soruyu elle birleştirirsin.

Asıl kazanç araç sayısının artması değil: iki mağazayı aynı çağrıda sorgulayabilen araçlar ancak böyle mümkün oluyor.

Asistanına (Claude Code, Antigravity, Cursor, Codex, Gemini CLI…) bunu yaz:

https://github.com/tunaarikaya/magaza-mcp — bunu kur, AGENTS.md'yi oku

Asistan AGENTS.md'yi okur ve kurulumun tamamını üstlenir. Senin yapman gereken tek şey sorularına cevap vermek:

Sen  › https://github.com/tunaarikaya/magaza-mcp — bunu kur, AGENTS.md'yi oku

Asistan › Anahtarlarını makinende arıyorum...

          Makinende iki anahtar buldum:
            App Store : ~/Downloads/AuthKey_ABC123DEFG.p8   (Key ID ABC123DEFG)
            Play      : ~/.config/play/hesap.json           (yayin@proje.iam...)

          Bunları kullanayım mı? Başka bir dosya varsa yolunu söyle,
          ya da anahtarı kopyalayıp bana at — ikisi de olur.

Sen  › evet, kullan

Asistan › App Store için Issuer ID lazım. App Store Connect → Kullanıcılar ve
          Erişim → Entegrasyonlar sayfasında, anahtar listesinin üstündeki UUID.

Sen  › 69a6de70-0000-0000-0000-000000000000

Asistan › ✓ App Store Connect bağlandı — 4 uygulama görüldü
          ✓ Google Play bağlandı — 3 uygulama görüldü
          ✓ Claude Code ve Antigravity ayarlarına kaydedildi

          Claude Code'u yeniden başlat, sonra şunu sor:
          "İki mağazadaki uygulamalarımı listele"

Anahtarını bulamazsa ne yapacağını sorar: dosyanın yolunu söylersin, panona kopyalarsın, ya da anahtarın hiç yoksa nereden alacağını adım adım anlatır.

Kurulumdan sonra açık olan uygulamaları yeniden başlat — MCP sunucuları yalnızca açılışta yüklenir.

Asistan kullanmıyorsan sihirbaz aynı işi yapar:

npx magaza-mcp kur

  Mağaza MCP kurulumu
  App Store Connect + Google Play, tek kurulumda

  1. Hangi mağazaları bağlayalım?

     App Store Connect (iOS / macOS)? [E/h] e
     Google Play (Android)? [E/h] e

  2. App Store Connect anahtarı

     Key ID: ABC123DEFG
     Issuer ID: 00000000-0000-0000-0000-000000000000
     .p8 dosyasının yolu: ~/Downloads/AuthKey_ABC123DEFG.p8
     Apple'a bağlanılıyor... ✓ 4 uygulama görüldü
     ✓ Anahtar kaydedildi (macOS Anahtar Zinciri)

  3. Google Play servis hesabı

     Servis hesabı JSON yolu: ~/.config/play/hesap.json
     Google'a bağlanılıyor... ✓ 3 uygulama görüldü
     ✓ Anahtar kaydedildi (macOS Anahtar Zinciri)

  4. Hangi uygulamalara kurulsun?

     Claude Code? [E/h] e
     Antigravity (IDE + CLI)? [E/h] e
     Cursor? [e/H] h

  Kurulum tamam.

Anahtarların ayar dosyasına yazılmaz. macOS'ta Anahtar Zinciri'ne kaydedilir; ayar dosyasına yalnızca hangi mağazaların açık olduğu (MAGAZALAR) girer. Anahtar Zinciri'ne erişilemeyen sistemlerde izinleri 0600 olan bir dosyaya düşülür.

npx magaza-mcp tara        # Makinede .p8 ve servis hesabı anahtarı ara
npx magaza-mcp anahtar ... # Anahtarı doğrula ve kasaya yaz (aşağıda)
npx magaza-mcp kaydet      # Sunucuyu istemcilerin ayarlarına ekle
npx magaza-mcp durum       # Neyin bağlı olduğunu göster (--json ile makine okunur)
npx magaza-mcp araclar     # Yüklü araçları listele (✎ = veri değiştirebilir)
npx magaza-mcp kur         # Elle kurulum sihirbazı
npx magaza-mcp surum       # Sürümü yazdır
npx magaza-mcp yardim      # Yardım

npx magaza-mcp anahtar --apple-p8 ~/Downloads/AuthKey_ABC123DEFG.p8 \
  --issuer-id 69a6de70-0000-0000-0000-000000000000

npx magaza-mcp anahtar --play-json ~/.config/play/hesap.json

pbpaste | npx magaza-mcp anahtar --play-json -   # panodan, dosya olmadan
npx magaza-mcp anahtar --sil appstore            # kasadan sil

Hayır — ve bu tesadüf değil, tasarımın kendisi.

1. Araç isimleri önekle ayrılmıştır. App Store'a giden her araç appstore__, Play'e giden her araç play__ ile başlar. Bir araç asla iki API'ye birden gitmez. Ortak isim olmadığı için karışma ihtimali de yok.

2. Seçmediğin mağazanın araçları hiç yüklenmez. Sunucu açılışta MAGAZALAR değişkenini okur ve listeyi ona göre kurar — seçmediğin mağazanın araçları belleğe bile alınmaz, modele gösterilmez, token harcamaz.

3. Çapraz araçlar yalnızca iki mağaza da açıkken var olur. Tek mağazalı kurulumda hiç oluşturulmazlar — anlamları olmadığı için.

4. Dispatch araçları da kapsamını bilir. magaza__endpoint_ara ve magaza__cagir araçlarının magaza parametresi, yalnızca kurduğun mağazaları kabul eden bir enum'dur. Sadece Play kurduysan model magaza: "appstore" diye bir çağrı yapamaz; şema buna izin vermez.

Örneklerdeki uygulama adları uydurmadır; sen kendi uygulamalarının adını kullanırsın.

İki mağaza birden

• "İki mağazadaki uygulamalarımı listele, hangisi nerede yayında?"
• "Nota Defteri'nin aylık aboneliği App Store'da ve Play'de Türkiye'de kaç para? Fark var mı?"
• "Bir kullanıcı ödeme yaptığını ama premium açılmadığını söylüyor. İki mağazada da satın alma kurulumunu kontrol et."

App Store

• "Hangi sürümüm incelemede takıldı?"
• "Dün yüklediğim TestFlight build'inin işlenmesi bitti mi?"
• "Son bir haftadaki 1 ve 2 yıldızlı yorumları özetle, en sık şikâyet ne?"
• "Hazırlanmakta olan sürümün 'Bu sürümde neler yeni' metnini güncelle."

Google Play

• "Hangi sürüm production kanalında ve yüzde kaç kullanıcıya açık?"
• "Çökme oranı son 14 günde arttı mı?"
• "Bu satın alma token'ı geçerli mi, abonelik hâlâ aktif mi?"
• "Şu yoruma kibar bir yanıt yaz, ama önce bana göster."

Önek hangi mağazaya gidildiğini söyler. ✎ işaretli araçlar veri değiştirir ve onayla=true gelmeden çalışmaz.

Seçilmiş araçlar günlük işin büyük kısmını görür. Geri kalanı için sunucu iki mağazanın API'lerinin tamamını taşır:

Hazır araçlar yetmediğinde model önce magaza__endpoint_ara ile aradığı işlemi bulur, sonra magaza__cagir ile çalıştırır.

MCP araç tanımları her istekte bağlama girer — yani yüklü araç listesi, sen hiçbirini kullanmasan bile her mesajda yeniden ödenir.

Kataloglar Apple ve Google'ın resmî spesifikasyonlarından üretilir: Apple'ın yayınladığı App Store Connect OpenAPI dosyası ile Google'ın Android Publisher ve Play Developer Reporting discovery dökümanları. Elle yazılmış uç nokta listesi yoktur. Apple'ın eskimiş (deprecated) işaretlediği 159 operasyon katalogdan atılmaz — bazıları o yeteneğe giden tek yol — ama özetleri [ESKİMİŞ] ile başlar ve arama sonuçlarında geriye itilir.

App Store Connect — Anahtarı oluştururken App Manager rolü yeterlidir; Admin gerekmez. İstisnalar: kullanıcı ve erişim yönetimi uç noktaları ile bazı analitik raporlar daha yüksek yetki ister.

Google Play — İki adım da şart:

1. Servis hesabının Play Console → Kullanıcılar ve izinler'den davet edilmesi ve ilgili uygulamalara izin verilmesi.
2. Cloud projesinde Android Publisher API ve Play Developer Reporting API'nin etkinleştirilmiş olması. Uygulama listelemesi ve çökme metrikleri Reporting API'sinden geldiği için ikincisi de gerçekten gereklidir.

• Anahtarlar Anahtar Zinciri'nde. Apple .p8 ve Google servis hesabı JSON'u macOS Anahtar Zinciri'nde saklanır; ayar dosyalarına, ortam değişkenlerine veya repoya yazılmaz.
• Kurulumu asistan yapsa bile anahtarı görmez. anahtar komutu dosyanın yolunu alır, içeriği kendisi okur ve doğrudan kasaya yazar; panodan verilen anahtar da borudan geçer. Anahtarın içeriği hiçbir komutun çıktısında görünmez — durum yalnızca Key ID'nin son dört hanesini, tara yalnızca dosya yollarını basar.
• Veri değiştiren işlemler onay ister. Yazma araçları ilk seferde çalışmaz: ne yapılacağını ve beklenen gövdeyi döndürürler; işlem ancak kullanıcı onayladıktan sonra onayla=true ile tekrarlandığında yürür. Bu sunucu tarafında uygulanır — istemcinin onay arayüzüne bağlı değildir.
• Salt-okunur mod. --salt-okunur (veya SALT_OKUNUR=1) yazma yapan araçları listeden tamamen çıkarır: model onları göremez, çağıramaz. 27 araç 24'e düşer. magaza__cagir listede kalır çünkü okuma uçlarının da tek kapısıdır — ama yazma operasyonu istendiğinde reddeder.
• Yol parametreleri doğrulanır. Araçlara verilen kimlikler URL'e girmeden önce kodlanır; . ve .. gibi yol gezinme denemeleri reddedilir. Mutlak adreslerde hedef host doğrulanır, böylece hiçbir istek Apple ve Google dışındaki bir adrese token taşıyamaz.
• İstemci hangi aracın veri değiştirdiğini görür. Araç listesi MCP annotations alanlarıyla (readOnlyHint, destructiveHint) birlikte verilir.
• Paket kaynağı kanıtlanabilir. npm'e yayınlanan her sürüm GitHub Actions içinde derlenir ve npm, Sigstore ile imzalı bir köken belgesi (provenance) üretir: npm sayfasındaki Provenance bölümü, indirdiğin tarball'ın bu depodaki hangi commit'ten üretildiğini gösterir. Yayın için depoda saklanan bir token yoktur; GitHub her yayında kısa ömürlü, imzalı bir kimlik üretir (trusted publishing), dolayısıyla çalınacak bir yayın anahtarı da yoktur.
• Telemetri yok. Hiçbir analitik, hata raporu veya kullanım verisi gönderilmez. Ağ trafiği yalnızca api.appstoreconnect.apple.com, androidpublisher.googleapis.com, playdeveloperreporting.googleapis.com ve token için oauth2.googleapis.com adreslerine gider. Araya giren bir sunucu yoktur; veri doğrudan senin makinenle Apple ve Google arasında akar.

git clone https://github.com/tunaarikaya/magaza-mcp.git
cd magaza-mcp
npm install
npm run build      # TypeScript derle
npm run kontrol    # Tip kontrolü (tsc --noEmit)
npm run dev        # İzleme modunda derleme

Araç kataloglarını spesifikasyonlardan yeniden üretmek için:

node scripts/uret-katalog.mjs

spec/ altındaki üç spesifikasyon dosyasını okur ve src/katalog/ altındaki katalogları yeniden yazar. Operasyon listesi elle düzenlenmez.

Bu alanda önce yola çıkmış, iyi iş yapan projeler var. İhtiyacın tek mağazayla sınırlıysa bunlara bakmanı içtenlikle öneririz:

• Heimdall — App Store Connect API'sinin tamamını 890 araçla kapsayan, profil sistemiyle araç setini daraltmana izin veren çok kapsamlı bir sunucu. Sadece iOS tarafıyla ilgileniyorsan bu alandaki en derin proje.
• app-store-connect-mcp-server — Alanın ilki. App Store Connect'i bir MCP sunucusunun arkasına koyma fikrini ilk kuran proje; sonradan gelen herkes bir şekilde buna borçlu.
• google-play-developer-mcp — Play tarafında kapsamlı ve olgun bir sunucu. Yalnızca Android yayınlıyorsan işini fazlasıyla görür.

Farkımız şu: bu projelerin hepsi tek mağazaya bakar. magaza-mcp ikisini tek kurulumda birleştirir ve iki mağazayı aynı çağrıda karşılaştırabilen araçlar sunar — tek mağazalı bir sunucuda yapılamayan şey tam olarak budur.

MIT — ayrıntılar için LICENSE. Üçüncü taraf kaynaklar için THIRD-PARTY-NOTICES.md.

App Store, TestFlight, App Store Connect, Google Play ve Play Console adları sahiplerinin tescilli markalarıdır. Bu proje bağımsız bir açık kaynak çalışmasıdır; Apple Inc. veya Google LLC ile bağlantılı değildir, onlar tarafından onaylanmamış, desteklenmemiş veya sponsor edilmemiştir.