App Store Connect MCP Sunucusu

Apple'ın App Store Connect API'si ile etkileşim kurmak için bir Model Context Protocol (MCP) sunucusu. Bu sunucu, App Store Connect'te uygulamaları, beta test kullanıcılarını, bundle ID'lerini, cihazları, uygulama meta verilerini ve yetenekleri yönetmek için araçlar sağlar.

Genel Bakış

App Store Connect MCP Sunucusu, yapay zeka ile Apple'ın App Store Connect ekosistemi arasındaki boşluğu dolduran kapsamlı bir araçtır. Model Context Protocol (MCP) temelinde inşa edilen bu sunucu, geliştiricilerin App Store Connect verilerine doğrudan konuşma tabanlı yapay zeka aracılığıyla erişmesini sağlayarak uygulama yönetimini, beta testini ve analitiği daha erişilebilir hale getirir.

Ana Avantajlar:

• 🤖 Yapay Zeka Destekli Uygulama Yönetimi: iOS ve macOS uygulamalarınızı doğal dil ile yönetin
• 📊 Kapsamlı Analitik: Ayrıntılı uygulama performansı, satış ve kullanıcı katılım verilerine erişin
• 👥 Kolaylaştırılmış Beta Testi: Beta gruplarını ve test kullanıcılarını verimli bir şekilde yönetin
• 🌍 Yerelleştirme Yönetimi: Uygulama açıklamalarını, anahtar kelimeleri ve meta verileri tüm diller arasında güncelleyin
• 🔧 Geliştirici Araçları Entegrasyonu: Xcode proje şemalarını listeleyin ve geliştirme iş akışları ile entegre olun
• 🔐 Güvenli Kimlik Doğrulama: Resmi App Store Connect API'si ile JWT kimlik doğrulaması kullanır
• 🚀 Gerçek Zamanlı Veriler: Apple sistemlerinden doğrudan güncel bilgilere erişin

Bu Kimin İçin:

• App Store Connect'te uygulama yöneten iOS/macOS geliştiricileri
• Beta test programlarını koordine eden geliştirme ekipleri
• Uygulama performansını ve kullanıcı katılımını analiz eden ürün yöneticileri
• Uygulama meta verileri ve yerelleştirmelerini yöneten pazarlama ekipleri
• App Store iş akışlarını otomatikleştiren DevOps mühendisleri
• Apple geliştirici deneyimini kolaylaştırmak isteyen herkes

Bu sunucu, karmaşık App Store Connect işlemlerini basit konuşma komutlarına dönüştürür; ister uygulama analitiklerini kontrol edin, beta test kullanıcılarını yönetin, uygulama açıklamalarını güncelleyin ya da geliştirme hattınızı keşfedin.

[](https://mseep.ai/app/joshuarileydev-app-store-connect-mcp-server)

Özellikler

• Uygulama Yönetimi

  • Tüm uygulamaları listele
  • Ayrıntılı uygulama bilgisine ulaş
  • Uygulama meta verileri ve ilişkilerini görüntüle

• Beta Testi

  • Beta gruplarını listele
  • Beta test kullanıcılarını listele
  • Gruplardan test kullanıcılarını ekle/çıkar
  • Beta test yapılandırmalarını yönet
  • Beta geri bildirimini ekran görüntüleri ve cihaz bilgileri ile görüntüle

• App Store Sürüm Yerelleştirmeleri ✨ YENİ

  • Yayın planlaması ile yeni app store sürümleri oluştur
  • Bir uygulama için tüm app store sürümlerini listele
  • Bir uygulama sürümü için tüm yerelleştirmeleri listele
  • Belirli yerelleştirme ayrıntılarını al
  • Uygulama açıklamalarını, anahtar kelimeleri ve promosyon metnini güncelle
  • Pazarlama ve destek URL'lerini yönet
  • Sürümler için "Yenilikleri" metnini güncelle

• Bundle ID Yönetimi

  • Bundle ID'lerini listele
  • Yeni bundle ID'leri oluştur
  • Bundle ID ayrıntılarını al
  • Yetenekleri etkinleştir/devre dışı bırak

• Cihaz Yönetimi

  • Kayıtlı cihazları listele
  • Cihaz türü, platform, duruma göre filtrele
  • Cihaz ayrıntılarını görüntüle

• Kullanıcı Yönetimi

  • Takım üyelerini listele
  • Kullanıcı rollerini ve izinlerini görüntüle
  • Kullanıcıları role ve erişime göre filtrele

• Analitik & Raporlar

  • Uygulamalar için analitik rapor istekleri oluştur
  • App Store katılım, ticaret ve kullanım analitiklerini indir
  • Performans ve framework kullanım raporlarına erişin
  • Satış ve trend raporlarını indir (günlük, haftalık, aylık, yıllık)
  • Bölgeye göre finansal raporları indir

• Xcode Geliştirme Araçları

  • Xcode projelerinde ve çalışma alanlarında mevcut şemaları listele
  • Geliştirme iş akışları ve CI/CD pipeline'ları ile entegre ol

Kurulum

Smithery Kullanarak

App Store Connect Sunucusunu Claude Desktop için otomatik olarak yüklemek için:

npx @smithery/cli install appstore-connect-mcp-server --client claude

Manuel Kurulum

npm install @joshuarileydev/app-store-connect-mcp-server

Yapılandırma

Claude Desktop yapılandırma dosyanıza aşağıdakini ekleyin:

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

Windows

%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "app-store-connect": {
      "command": "npx",
      "args": [
        "-y",
        "appstore-connect-mcp-server"
      ],
      "env": {
        "APP_STORE_CONNECT_KEY_ID": "YOUR_KEY_ID",
        "APP_STORE_CONNECT_ISSUER_ID": "YOUR_ISSUER_ID",
        "APP_STORE_CONNECT_P8_PATH": "/path/to/your/auth-key.p8",
        "APP_STORE_CONNECT_VENDOR_NUMBER": "YOUR_VENDOR_NUMBER_OPTIONAL"
      }
    }
  }
}

Kimlik Doğrulama

Gerekli Yapılandırma

1. App Store Connect adresinden bir App Store Connect API Anahtarı oluşturun
2. .p8 özel anahtar dosyasını indirin
3. Anahtar Kimliğinizi ve İhraçcı Kimliğinizi not edin
4. Yapılandırmanızda gerekli ortam değişkenlerini ayarlayın:
   • APP_STORE_CONNECT_KEY_ID: API Anahtar Kimliğiniz
   • APP_STORE_CONNECT_ISSUER_ID: İhraçcı Kimliğiniz
   • APP_STORE_CONNECT_P8_PATH: .p8 özel anahtar dosyasının yolu

Satış & Finansal Raporlar için İsteğe Bağlı Yapılandırma

Satış ve finansal raporlama araçlarını etkinleştirmek için şu da gereklidir:

• APP_STORE_CONNECT_VENDOR_NUMBER: App Store Connect'teki satıcı numaranız

Not: Satış ve finansal rapor araçları (download_sales_report, download_finance_report) yalnızca satıcı numarası yapılandırılmışsa kullanılabilir. Satıcı numaranızı App Store Connect'te "Satış ve Trendler" veya "Ödemeler ve Finansal Raporlar" altında bulabilirsiniz.

Tam Araç Referansı

📱 Uygulama Yönetimi Araçları

list_apps

App Store Connect'te bulunan tüm uygulamaların bir listesini alın.

Parametreler:

• limit (opsiyonel): Döndürülecek maksimum uygulama sayısı (varsayılan: 100, maksimum: 200)
• bundleId (opsiyonel): Bundle tanımlayıcısına göre filtrele

Örnek:

"Tüm uygulamalarımı listele"
"Bundle ID'si com.example.myapp olan uygulamaları göster"
"İlk 50 uygulamayı al"

get_app_info

Belirli bir uygulama hakkında ayrıntılı bilgi alın.

Parametreler:

• appId (gerekli): Uygulamanın kimliği
• include (opsiyonel): Dahil edilecek ilişkili kaynaklar (örn. appClips, appInfos, appStoreVersions, betaGroups, builds)

Örnek:

"Uygulama kimliği 123456789 için bilgi al"
"Uygulama 123456789'u beta grupları ve derlemeler ile göster"
"Uygulamam hakkında app store sürümleri dahil ayrıntılı bilgi al"

👥 Beta Testi Araçları

list_beta_groups

Tüm beta test gruplarını (iç ve dış) listeleyin.

Parametreler:

• limit (opsiyonel): Döndürülecek maksimum grup sayısı (varsayılan: 100, maksimum: 200)
• appId (opsiyonel): Uygulama kimliğine göre filtrele

Örnek:

"Tüm beta gruplarını göster"
"Uygulama 123456789 için beta gruplarını listele"
"İlk 20 beta grubunu al"

list_group_testers

Belirli bir beta gruptaki test kullanıcılarını listeleyin.

Parametreler:

• groupId (gerekli): Beta grubunun kimliği
• limit (opsiyonel): Döndürülecek maksimum test kullanıcı sayısı (varsayılan: 100, maksimum: 200)

Örnek:

"ABC123 grubundaki tüm test kullanıcılarını listele"
"Beta grubu ABC123'teki ilk 50 test kullanıcısını göster"

add_tester_to_group

Beta grubuna yeni bir test kullanıcı ekleyin.

Parametreler:

• groupId (gerekli): Beta grubunun kimliği
• email (gerekli): Test kullanıcısının e-posta adresi
• firstName (opsiyonel): Test kullanıcısının adı
• lastName (opsiyonel): Test kullanıcısının soyadı

Örnek:

"john@example.com adresini beta grubu ABC123'e ekle"
"John Smith (john@example.com) adresini grubu ABC123'e ekle"

remove_tester_from_group

Test kullanıcısını beta gruptan çıkarın.

Parametreler:

• groupId (gerekli): Beta grubunun kimliği
• testerId (gerekli): Test kullanıcısının kimliği

Örnek:

"Test kullanıcısı XYZ789'u grubu ABC123'ten çıkar"
"Test kullanıcısı XYZ789'u beta grubundan sil"

list_beta_feedback_screenshots

Beta geri bildirim ekran görüntüsü gönderilerini listeleyin.

Parametreler:

• appId (opsiyonel): Uygulama kimliğine göre filtrele
• bundleId (opsiyonel): Bundle tanımlayıcısına göre filtrele
• buildId (opsiyonel): Derleme kimliğine göre filtrele
• limit (opsiyonel): Maksimum sonuçlar (varsayılan: 100)
• includeBuilds (opsiyonel): Derleme bilgilerini dahil et
• includeTesters (opsiyonel): Test kullanıcı bilgilerini dahil et

Örnek:

"Uygulama 123456789 için beta geri bildirim ekran görüntülerini göster"
"Bundle ID'si com.example.app için geri bildirim ekran görüntülerini listele"
"Derleme XYZ için test kullanıcı bilgisi ile geri bildirim al"

get_beta_feedback_screenshot

Belirli bir beta geri bildirim ekran görüntüsü hakkında ayrıntılı bilgi alın.

Parametreler:

• feedbackId (gerekli): Geri bildirimin kimliği
• includeBuilds (opsiyonel): Derleme bilgilerini dahil et
• includeTesters (opsiyonel): Test kullanıcı bilgilerini dahil et
• downloadScreenshot (opsiyonel): Ekran görüntüsü görüntüsünü indir (varsayılan: true)

Örnek:

"Geri bildirim ekran görüntüsü FEEDBACK123'ü al"
"Test kullanıcı ayrıntıları ile geri bildirim FEEDBACK123'ü göster"
"Geri bildirim FEEDBACK123'ten ekran görüntüsünü indir"

🌍 App Store Sürüm Yerelleştirme Araçları

create_app_store_version

Bir uygulama için yeni bir app store sürümü oluşturun.

Parametreler:

• appId (gerekli): Uygulamanın kimliği
• platform (gerekli): Platform (IOS, MAC_OS, TV_OS, VISION_OS)
• versionString (gerekli): X.Y veya X.Y.Z biçiminde sürüm dizesi (örn. '1.0' veya '1.0.0')
• copyright (opsiyonel): Bu sürüm için telif hakkı metni
• releaseType (opsiyonel): Uygulamanın nasıl yayınlanması gerektiği (MANUAL, AFTER_APPROVAL, SCHEDULED)
• earliestReleaseDate (opsiyonel): ISO 8601 tarih dizesi (releaseType SCHEDULED olduğunda gerekli)
• buildId (opsiyonel): Bu sürümle ilişkilendirilecek derlemenin kimliği

Örnek:

"Uygulama 123456789 için iOS sürümü 2.0.0 oluştur"
"Uygulama 123456789 için manuel yayın ile macOS sürümü 1.5.0 oluştur"
"Uygulama 123456789 için 2024-02-01 tarihinde yayınlanacak planlı iOS sürümü 2.1.0 oluştur"
"Uygulama 123456789 için derleme BUILD456 ve telif hakkı '2024 My Company' ile sürüm 1.2.0 oluştur"

list_app_store_versions

Belirli bir uygulama için tüm app store sürümlerini alın.

Parametreler:

• appId (gerekli): Uygulamanın kimliği
• limit (opsiyonel): Döndürülecek maksimum sürüm sayısı (varsayılan: 100, maksimum: 200)
• filter (opsiyonel): Filtre seçenekleri
  • platform: Platforma göre filtrele (IOS, MAC_OS, TV_OS)
  • versionString: Sürüm dizesine göre filtrele (örn. '1.0.0')
  • appStoreState: Duruma göre filtrele (örn. READY_FOR_SALE, PREPARE_FOR_SUBMISSION)

Örnek:

"Uygulama 123456789 için tüm sürümleri listele"
"Uygulama 123456789 için iOS sürümlerini göster"
"Uygulama 123456789 için sürüm 2.0.0'ı bul"
"Uygulama 123456789 için incelemede olan sürümleri listele"

list_app_store_version_localizations

Belirli bir app store sürümü için tüm yerelleştirmeleri alın.

Parametreler:

• appStoreVersionId (gerekli): App store sürümünün kimliği
• limit (opsiyonel): Maksimum yerelleştirme sayısı (varsayılan: 100, maksimum: 200)

Örnek:

"Uygulama sürümü VERSION123 için tüm yerelleştirmeleri listele"
"App store sürümü VERSION123 için dil sürümlerini göster"

get_app_store_version_localization

Belirli bir yerelleştirme hakkında ayrıntılı bilgi alın.

Parametreler:

• localizationId (gerekli): Yerelleştirmenin kimliği

Örnek:

"Yerelleştirme LOCALE123 ayrıntılarını al"
"Fransızca yerelleştirme LOCALE123'ü göster"

update_app_store_version_localization

App store sürümü yerelleştirmesinde belirli bir alanı güncelleyin.

Parametreler:

• localizationId (gerekli): Yerelleştirmenin kimliği
• field (gerekli): Güncellenecek alan (description, keywords, marketingUrl, promotionalText, supportUrl, whatsNew)
• value (gerekli): Alan için yeni değer

Örnek:

"Yerelleştirme LOCALE123 için açıklamayı 'Şaşırtıcı yeni uygulama açıklaması' olarak güncelle"
"LOCALE123 için anahtar kelimeleri 'üretkenlik, görevler, organize' olarak değiştir"
"Yerelleştirme LOCALE123 için yenilikleri 'Hata düzeltmeleri ve performans iyileştirmeleri' olarak güncelle"

🔤 Bundle ID Yönetimi Araçları

create_bundle_id

Uygulama geliştirme için yeni bir bundle ID'yi kaydedin.

Parametreler:

• identifier (gerekli): Bundle ID'si dizesi (örn. 'com.example.app')
• name (gerekli): Bundle ID'si için bir ad
• platform (gerekli): Platform (IOS, MAC_OS, veya UNIVERSAL)
• seedId (opsiyonel): Takımınızın seed ID'si

Örnek:

"iOS için 'My New App' adıyla com.mycompany.newapp bundle ID'sini oluştur"
"'Example App' adıyla evrensel bundle ID'sini com.example.app olarak kaydet"

list_bundle_ids

Takımınıza kayıtlı bundle ID'lerini bulun ve listeleyin.

Parametreler:

• limit (opsiyonel): Maksimum sonuçlar (varsayılan: 100, maksimum: 200)
• sort (opsiyonel): Sıralama düzeni (name, -name, platform, -platform, identifier, -identifier)
• filter (opsiyonel): Tanımlayıcı, ad, platform veya seedId'ye göre filtrele
• include (opsiyonel): İlişkili kaynakları dahil et (profiles, bundleIdCapabilities, app)

Örnek:

"Tüm bundle ID'lerini listele"
"Ada göre sıralanmış iOS bundle ID'lerini göster"
"'example' içeren bundle ID'lerini bul"

get_bundle_id_info

Belirli bir bundle ID hakkında ayrıntılı bilgi alın.

Parametreler:

• bundleIdId (gerekli): Bundle ID'sinin kimliği
• include (opsiyonel): Dahil edilecek ilişkili kaynaklar
• fields (opsiyonel): Dahil edilecek belirli alanlar

Örnek:

"Bundle ID BUNDLE123 için bilgi al"
"Bundle ID BUNDLE123'ü yetenekleri ile göster"

enable_bundle_capability

Bir bundle ID için yetenek etkinleştirin.

Parametreler:

• bundleIdId (gerekli): Bundle ID'sinin kimliği
• capabilityType (gerekli): Yetenek türü (örn. PUSH_NOTIFICATIONS, ICLOUD, GAME_CENTER)
• settings (opsiyonel): Yetenek özel ayarları

Örnek:

"Bundle ID BUNDLE123 için push bildirimlerini etkinleştir"
"Bundle BUNDLE123'e iCloud yeteneğini ekle"
"Bundle ID BUNDLE123 için Game Center'ı etkinleştir"

disable_bundle_capability

Bir bundle ID için yetenek devre dışı bırakın.

Parametreler:

• capabilityId (gerekli): Devre dışı bırakılacak yeteneğin kimliği

Örnek:

"Yetenek CAP123'ü devre dışı bırak"
"Yetenek CAP123'ü bundle ID'sinden kaldır"

📱 Cihaz Yönetimi Araçları

list_devices

Takımınıza kayıtlı tüm cihazların bir listesini alın.

Parametreler:

• limit (opsiyonel): Maksimum sonuçlar (varsayılan: 100, maksimum: 200)
• sort (opsiyonel): Sıralama düzeni (name, platform, status, udid, deviceClass, model, addedDate)
• filter (opsiyonel): Ad, platform, durum, udid veya deviceClass'a göre filtrele
• fields (opsiyonel): Dahil edilecek belirli alanlar

Örnek:

"Tüm cihazları listele"
"Etkinleştirilen iOS cihazlarını göster"
"Adında 'John' içeren cihazları bul"
"İPhone'ları ekleme tarihine göre sıralanmış şekilde listele"

👤 Kullanıcı Yönetimi Araçları

list_users

App Store Connect takımınızdaki tüm kullanıcıların bir listesini alın.

Parametreler:

• limit (opsiyonel): Maksimum sonuçlar (varsayılan: 100, maksimum: 200)
• sort (opsiyonel): Sıralama düzeni (username, firstName, lastName, roles)
• filter (opsiyonel): Kullanıcı adı veya rollere göre filtrele
• fields (opsiyonel): Dahil edilecek belirli alanlar
• include (opsiyonel): visibleApps ilişkisini dahil et

Örnek:

"Tüm takım üyelerini listele"
"Yönetici rolüne sahip kullanıcıları göster"
"Geliştiricileri soyadına göre sıralanmış şekilde bul"
"Görünür uygulamaları ile birlikte kullanıcıları listele"

📊 Analitik & Raporlar Araçları

create_analytics_report_request

Bir uygulama için yeni bir analitik rapor isteği oluşturun.

Parametreler:

• appId (gerekli): Uygulama kimliği
• accessType (gerekli): Analitik türü (ONGOING veya ONE_TIME_SNAPSHOT)
• frequency (opsiyonel): Devam eden raporlar için rapor sıklığı (DAILY, WEEKLY, MONTHLY)
• startDate (opsiyonel): Başlama tarihi (YYYY-MM-DD)
• endDate (opsiyonel): Bitiş tarihi (YYYY-MM-DD)

Örnek:

"Uygulama 123456789 için günlük analitik raporu oluştur"
"Uygulama 123456789 için 2024-01-01 ile 2024-01-31 tarihleri arasında tek seferlik anlık görüntü raporu oluştur"

list_analytics_reports

Bir istek için mevcut analitik raporlarını alın.

Parametreler:

• reportRequestId (gerekli): Rapor isteğinin kimliği
• limit (opsiyonel): Maksimum sonuçlar (varsayılan: 100, maksimum: 200)
• filter (opsiyonel): Kategori, ad veya tarihe göre filtrele

Örnek:

"İstek REQ123 için raporları listele"
"İstek REQ123 için uygulama kullanım raporlarını göster"

list_analytics_report_segments

Belirli bir analitik rapor için segmentleri alın.

Parametreler:

• reportId (gerekli): Analitik raporunun kimliği
• limit (opsiyonel): Maksimum sonuçlar (varsayılan: 100, maksimum: 200)

Örnek:

"Rapor REPORT123 için segmentleri listele"
"Rapor REPORT123 için indirme URL'lerini al"

download_analytics_report_segment

Bir analitik rapor segmentinden veri indirin.

Parametreler:

• url (gerekli): Segment indirme URL'si

Örnek:

"https://api.appstoreconnect.apple.com/... adresinden veri indir"

💰 Satış & Finansal Raporlar Araçları (Satıcı Numarası Gerekli)

download_sales_report

Satış ve trend raporlarını indirin.

Parametreler:

• frequency (gerekli): Rapor sıklığı (DAILY, WEEKLY, MONTHLY, YEARLY)
• reportDate (gerekli): Uygun biçimdeki tarih
• reportType (gerekli): Rapor türü (SALES, SUBSCRIPTION, SUBSCRIPTION_EVENT, SUBSCRIBER, NEWSSTAND, PREORDER)
• reportSubType (gerekli