Rehber

Bayraklar

• --domains=<liste>: Yüklenecek domainler, virgülle ayrılmış ya da all (sadece birleşik sunucu)
• --read-only: Yalnızca hiçbir şeyi değiştiremeyen araçları göster
• --confirm : Yalnızca güçlü risk seviyelerinde değil, her yazmadan önce sor
• --no-confirm : Hiç sorma; tek kapı client'ın kendi araç onayı olur
• --dry-run: Yazmalar Apple'a gitmez; her mutasyon çağrısı gönderilecek olanı risk seviyesiyle döndürür
• --include-deprecated: Apple'ın kullanımdan kaldırdığı 123 işlemi de yükle. Profil modunda, o profilin kapsadığı domain'lerdeki emekli işlemleri ekler — 123'ün 102'si Game Center

Riskli yazmalardan önce onay varsayılan olarak açıktır. Yani, fiyat değiştirme, admin yetkisi verme, sertifika silme gibi taleplerinizde Heimdall client'ınızın istemi üzerinden (MCP elicitation) onay ister ve neyin değişeceğini gösterir. Böylece "fiyatı biraz düşür"ü yanlışlıkla 0.99 olarak anlasa bile, siz onaylamadan hiçbir şey değişmez.

Zincirler yerine tek çağrı

Elle yazılmış birkaç araç, çok adımlı bir akışı tek çağrıya indiriyor. Ham araçlar olduğu gibi kalır; bunlar üstüne oturur ve her biri sahibi olan alt profille açılır. İşlenmiş hâlleri Örnekler'de.

Şunun yerine	Bunu çağır	Gereken
app → grup → abonelik → fiyat noktaları	pricing__get_subscription_price — tek ülke, ya da territory verilmezse ~175 ülke fiyata göre gruplanmış	monetization:subscription-pricing
aynı zincir artı yazma	pricing__set_subscription_price	monetization:subscription-pricing
ülke ülke fiyat belirlemek	pricing__equalize_price — tek çapa fiyat, diğer tüm pazarları Apple türetir; uygulama, IAP veya abonelik için	monetization:subscription-pricing
submission aç, sürümü ekle, teslim et — bu sırayla üç çağrı	release__submit — ön denetimin blokladığını reddeder	distribution:submission
kırk dilin mağaza metnini gözle karşılaştırmak	metadata_ai__audit_localizations	distribution:version
her dile çeviriyi elle yapıştırmak	metadata_ai__apply_localizations — CSV veya JSON dosyadan	distribution:version
sürüm + build + inceleme detayı + yerelleştirmeler + ekran görüntüleri, "gönderilebilir mi" sorusu için	preflight__check_version	distribution:version
iki sürümü, her dil için elle karşılaştırmak	listing__diff_metadata — yalnızca farklı alanlar, artı eklenen ve düşen diller	distribution:version
sürüm → 50 yerelleştirme → ekran görüntüsü setleri → görüntüler	listing__get_screenshots	distribution:version
ekran görüntüsü için yer ayırıp baytları kendiniz taşımak	listing__upload_screenshot	distribution:version
istek → rapor → örnek → segment → imzalı URL	analytics__get_report — bağlantı değil, satır döndürür	analytics
yorumları çekip elle gruplamak	reviews_ai__triage, reviews_ai__daily_briefing, reviews_ai__draft_response	marketing:customer-review
uygulamaları listeleyip her biri için sürüm çağrısı yapmak, sonra App Store durumlarını yorumlamak	asc__account_status — hangi uygulama yayında, hangisi yolda, sıradaki hamle sizde mi Apple'da mı	çekirdek, yani her profilde

pricing__equalize_price yaklaşık 175 ülkeye dokunan REVENUE seviyesinde bir yazmadır. Önce --dry-run altında çalıştırın: hiçbir şey gönderilmeden türetilen tablonun tamamını döndürür.

Uygulamayı adıyla çağırmak

/v1/apps/{id} altındaki 46 araç uygulama adı, bundle ID ya da sayısal Apple ID kabul eder ve çağrıdan önce çözer. "Acme'nin sürümlerini listele" için önce ID aramanız gerekmez. Yalnızca orada ve yalnızca değer zaten sayısal değilse — başka her yerde id, id'dir.

StoreKit 2 — müşteri işlemleri

App Store Server API mağaza sayfanızı değil tek tek müşterileri sorar: satın alma geçmişi, hak sahipliği, iadeler, abonelik durumu. Bir Bundle ID yapılandırıldığında (setup ya da ASC_BUNDLE_ID) açılır ve monetization:storekit ile gelir.

• Her StoreKit aracı isteğe bağlı environment argümanı alır (Production / Sandbox). Bir işlem ID'si tam olarak bir ortamda vardır; varsayılan setup'taki seçiminiz, çağrı başına değiştirebilirsiniz.
• --read-only iki yazan aracı (request_test_notification, extend_renewal_date) gizler; yedi okuma aracı kalır.

Prompt'lar

Üç iş akışı MCP prompt'u olarak sunuluyor.

Prompt	Ne çalıştırır	Ne zaman sunulur
release-readiness	preflight__check_version, ardından listing__diff_metadata, sonuçta GO ya da NO-GO	distribution:version
review-triage	brifing → triyaj → yorum başına taslak yanıt, hiçbiri gönderilmeden	marketing:customer-review
price-check	tek çağrıda dünya fiyatları, ardından istenmemiş görünenler	monetization:subscription-pricing

Bir prompt yalnızca adını verdiği araçların hepsi yüklüyse görünür; daraltılmış bir profil ya da --read-only araçları nasıl kaldırdıysa prompt'u da öyle kaldırır. Her biri yazmadan önce durur: gönderim, yanıt ve fiyat değişikliği sizin kararınızdır.