Mağaza MCP yordamida App Store Connect va Google Play’ni boshqaring

Mağaza MCP nima?

Mağaza MCP — AI yordamchilariga bitta o‘rnatish orqali App Store Connect va Google Play xizmatlaridan foydalanish imkonini beruvchi ochiq kodli Model Context Protocol serveridir. U alohida integratsiyalar o‘rtasida almashmasdan iOS va Android do‘konlari ma’lumotlarini tekshirish, taqqoslash va boshqarishga muhtoj dasturchilar hamda ilova operatorlari uchun mo‘ljallangan.

Server kompyuteringizda mahalliy ravishda ishlaydi va Apple hamda Google bilan bevosita bog‘lanadi. Oraliq xizmat mavjud emas. Apple vositalari appstore__ prefiksidan, Google Play vositalari play__ prefiksidan, do‘konlararo yoki umumiy API vositalari esa magaza__ prefiksidan foydalanadi.

Uning asosiy afzalligi — do‘konlararo savollarga bitta amal orqali javob bera olishidir. Masalan, yordamchingiz App Store va Google Play’dagi bir xil obunaning turk lirasi bo‘yicha narxini taqqoslashi, mos iOS va Android ilovalarini juftlashi yoki har ikki do‘kondagi ilova ichidagi xarid konfiguratsiyasi muammosini tekshirishi mumkin.

Asosiy imkoniyatlar

• Ikki do‘kon uchun bitta MCP serveri: App Store Connect, Google Play yoki ikkala xizmatga ulaning.
• Do‘konlararo jarayonlar: Obunalarni taqqoslang, ilovalarning umumiy ko‘rinishini yarating va har ikki platformadagi ilova ichidagi xarid konfiguratsiyasini tekshiring.
• 27 ta maqsadli vosita: Ikki do‘konli o‘rnatish keng tarqalgan do‘kon amallari va umumiy API’dan foydalanish uchun 27 ta vositani taqdim etadi.
• To‘liq API qamrovi: App Store Connect API v4.5, Android Publisher API v3 va Play Developer Reporting API v1beta1’dan 1 440 ta amalni qidiring va ishga tushiring.
• Kontekst sarfi kam: To‘liq API katalogi barcha 1 440 ta amalni alohida MCP vositalari sifatida ochish o‘rniga qidiruv va yo‘naltirish vositalari orqali taqdim etiladi.
• Hisob ma’lumotlarini mahalliy saqlash: Hisob ma’lumotlari mavjud bo‘lsa, macOS Keychain’da saqlanadi; Keychain’dan foydalanib bo‘lmaydigan tizimlarda esa ruxsati cheklangan faylga yoziladi.
• Yozish amallari uchun tasdiq: Ma’lumotni o‘zgartiruvchi amallar aniq onayla=true tasdig‘ini talab qiladi.
• Faqat o‘qish rejimi: Yozish vositalarini model vositalari ro‘yxatidan butunlay olib tashlash mumkin.
• Telemetriya yo‘q: Loyiha tahliliy ma’lumotlar, xatolar haqidagi hisobotlar yoki foydalanish ma’lumotlarini yubormaydi.

Talablar

Paketni ishga tushirishdan oldin Node.js 18 yoki undan yangiroq versiyasini o‘rnating. Shuningdek, ulamoqchi bo‘lgan har bir do‘kon uchun mos hisob ma’lumotlari kerak bo‘ladi.

App Store Connect talablari

App Store Connect API kalitini yarating va sozlash vaqtida uning Key ID, Issuer ID hamda .p8 faylini tayyorlab qo‘ying. Ko‘pchilik amallar uchun App Manager roli yetarli. Foydalanuvchilar va kirish huquqlarini boshqarish endpointlari, shuningdek ayrim tahliliy hisobotlar yuqoriroq imtiyozlarni talab qilishi mumkin.

Kalit App Store Connect API kaliti bo‘lishi shart. StoreKit va push-bildirishnoma kalitlaridan muqobil sifatida foydalanib bo‘lmaydi.

Google Play talablari

1. Servis hisobini Play Console → Users and permissions orqali taklif qiling, so‘ng tegishli ilovalarga kirish huquqini bering.
2. Tegishli Google Cloud loyihasida Android Publisher API va Play Developer Reporting API xizmatlarini yoqing.

Reporting API nafaqat ishdan chiqish ko‘rsatkichlari, balki ilovalarni aniqlash uchun ham kerak. Android Publisher API hisob uchun mavjud barcha ilovalarni ro‘yxatlash endpointini taqdim etmaydi.

Shartnomalar, soliq ma’lumotlari va bank ma’lumotlarini ushbu API’lar orqali o‘qib bo‘lmaydi. Apple bu ma’lumotlarni App Store Connect API kalitlari orqali taqdim etmaydi.

Mağaza MCP’ni o‘rnatish

Interaktiv o‘rnatuvchini bitta buyruq bilan ishga tushiring:

npx magaza-mcp kur

Usta sizni quyidagi bosqichlar orqali yo‘naltiradi:

1. App Store Connect, Google Play yoki ikkala do‘konni tanlang.
2. App Store Connect Key ID va Issuer ID qiymatlarini kiriting, so‘ng .p8 fayliga yo‘lni ko‘rsating.
3. Google Play servis hisobi JSON fayliga yo‘lni ko‘rsating.
4. MCP konfiguratsiyasi o‘rnatiladigan aniqlangan AI mijozlarini tanlang.
5. Server faqat o‘qish rejimida ishlash- ishlamasligini tanlang.

O‘rnatuvchi Apple va Google hisob ma’lumotlarini saqlashdan oldin haqiqiy API so‘rovlari orqali tekshiradi. Hisob ma’lumotlari AI mijozining konfiguratsiya fayliga yozilmaydi. Konfiguratsiya faqat MAGAZALAR orqali qaysi do‘konlar yoqilgani kabi ma’lumotlarni o‘z ichiga oladi.

macOS’da hisob ma’lumotlari Keychain’da saqlanadi. Keychain mavjud bo‘lmasa, loyiha 0600 ruxsatlariga ega fayldan foydalanadi.

Qo‘llab-quvvatlanadigan MCP mijozlari

O‘rnatuvchi Claude Code, Claude Desktop, Antigravity, Cursor, Windsurf va Codex’ni qo‘llab-quvvatlaydi. U faqat magaza-mcp yozuvini yangilaydi, bog‘liq bo‘lmagan konfiguratsiyani saqlab qoladi, yozishdan oldin .magaza-mcp-yedek zaxira nusxasini yaratadi va atomik yozuvlarni amalga oshiradi.

Yangi MCP serverini yuklashlari uchun sozlashdan so‘ng ochiq mijoz ilovalarini qayta ishga tushiring.

O‘rnatishni tekshirish

Natijani tasdiqlash uchun holat va vositalar ro‘yxati buyruqlaridan foydalaning:

npx magaza-mcp durum
npx magaza-mcp durum --json
npx magaza-mcp araclar
npx magaza-mcp surum
npx magaza-mcp yardim

durum qaysi do‘konlar ulanganini bildiradi, araclar esa o‘rnatilgan vositalar ro‘yxatini ko‘rsatadi. ✎ belgisi bilan ko‘rsatilgan vositalar do‘kon ma’lumotlarini o‘zgartirishi mumkin.

Asosiy foydalanish

Mağaza MCP’dan MCP bilan mos yordamchingizda tabiiy tildagi so‘rovlar orqali foydalanish mo‘ljallangan. Mijoz qayta ishga tushirilgach, oddiy inventar so‘rovi bilan boshlang:

Ikkala do‘kondagi ilovalarimni ro‘yxatlang va har biri hozir qayerda nashr etilganini ko‘rsating.

Ikkala do‘kon ham ulanganida, magaza__genel_kans ilovalar ro‘yxatini birlashtiradi, mos keluvchi iOS va Android mahsulotlarini juftlaydi hamda faqat bitta do‘konda topilgan ilovalarni ajratadi.

Obuna narxlarini taqqoslash

Muayyan mamlakat uchun obunani taqqoslashni yordamchidan so‘rang:

Turkiyada Note Keeper uchun oylik obuna App Store va Google Play’da qancha turadi? Farq bormi?

magaza__abonelik_karsilastir vositasi mahsulot identifikatorlari, hisob-kitob davrlari va mamlakatga xos narxlarni taqqoslaydi. Shuningdek, mamlakat kodini har bir do‘kon kutadigan shaklga o‘giradi.

Xarid muammolarini aniqlash

Pul to‘lagan, ammo premium kirish huquqini olmagan mijoz uchun quyidagiga o‘xshash so‘rovdan foydalaning:

Mijoz pul to‘laganini, ammo premium kirish huquqi faollashtirilmaganini aytmoqda. Ikkala do‘kondagi xarid sozlamalarini tekshirib, ehtimoliy sabablarni umumlashtiring.

magaza__iap_teshis vositasi mahsulotlar chop etilganmi, tegishli mamlakatda narx mavjudmi va Google Play bazaviy rejasi yangi obunachilar uchun mavjudmi, shularni tekshiradi. Play xarid tokenini taqdim etsangiz, vosita tashxisning bir qismi sifatida tokenni tasdiqlashi mumkin.

App Store Connect’ni tekshirish

App Store’ga xos vositalar ilovalar, relizlar, TestFlight buildlari, sharhlar, obuna guruhlari, obuna narxlari, ilova ichidagi xaridlar, TestFlight guruhlari va savdo hisobotlarini ro‘yxatlay oladi. So‘rovlar misollari:

• Hozir qaysi App Store versiyasi ko‘rib chiqishda qolib ketgan?
• Kecha yuklagan TestFlight buildimni qayta ishlash tugadimi?
• O‘tgan haftadagi bir va ikki yulduzli sharhlarni umumlashtiring.
• Ushbu ilova uchun kunlik savdo hisobotini yuklab oling.

Do‘kon metama’lumotlari va sharhlarga berilgan javoblarni ham o‘zgartirish mumkin, ammo bunday amallar aniq tasdiqlashni talab qiladi.

Google Play’ni tekshirish

Google Play vositalari ilovalar, reliz treklari, sharhlar, obunalar, bazaviy reja narxlari, bir martalik mahsulotlar, xaridlarni tasdiqlash, bekor qilingan xaridlar va Android vitals’dagi ishdan chiqish ko‘rsatkichlarini qamrab oladi. So‘rovlar misollari:

• Ishlab chiqarish trekida qaysi versiya bor va foydalanuvchilarning necha foiziga u yetkazilmoqda?
• Oxirgi 14 kun ichida ishdan chiqish darajasi oshdimi?
• Bu xarid tokeni yaroqlimi va obuna hali ham faolmi?
• Mavjud davrdagi qaytarilgan yoki bekor qilingan xaridlarni ko‘rsating.

Google tegishli API orqali taxminan faqat eng so‘nggi bir haftadagi sharhlarni taqdim etadi. Bekor qilingan xaridlar ma’lumotlari oxirgi 30 kun bilan cheklangan.

Yozish amallarini xavfsiz bajarish

appstore__yorum_yanitla, appstore__metin_guncelle va play__yorum_yanitla kabi vositalar do‘kon ma’lumotlarini o‘zgartirishi mumkin. Ular birinchi so‘rovdayoq darhol bajarilmaydi. Buning o‘rniga server taklif etilgan amal va kutilayotgan so‘rov tanasini qaytaradi.

Taklifni ko‘rib chiqqach, uni tasdiqlang va yordamchiga amalni quyidagicha takrorlatib bajartiring:

onayla=true

Bu tasdiqlash to‘sig‘i faqat MCP mijozining interfeysiga tayanmaydi, balki server tomonidan majburiy qo‘llanadi.

Faqat o‘qish rejimini yoqish

Audit, hisobot tayyorlash yoki ehtiyotkor tajribalar uchun serverni faqat o‘qish rejimida ishga tushiring:

npx magaza-mcp --salt-okunur

Quyidagini ham o‘rnatishingiz mumkin:

SALT_OKUNUR=1

Ikkala do‘kon ulanganida, faqat o‘qish rejimi ko‘rsatiladigan vositalar ro‘yxatini 27 tadan 24 taga qisqartiradi. Yozishga xos vositalar yo‘qoladi, shuning uchun model ularni ko‘ra olmaydi yoki chaqira olmaydi. Umumiy magaza__cagir dispetcheri mavjud bo‘lib qoladi, chunki u o‘qish amallari uchun ham kerak, ammo faqat o‘qish rejimida yozish amallarini rad etadi.

To‘liq API katalogidan foydalanish

Maxsus vositalar keng tarqalgan ish jarayonlarini qamrab oladi, ammo Mağaza MCP 1 440 ta API amaliga ham kirish imkonini beradi. Har bir amalni model kontekstiga joylashtirish o‘rniga, u uchta umumiy vositani taqdim etadi:

• magaza__endpoint_ara ulangan do‘konlarning API kataloglaridan qidiradi va mos amal nomlari, HTTP usullari, yo‘llari hamda parametrlarini qaytaradi.
• magaza__sema amal uchun so‘rov tanasi sxemasini ko‘rsatadi; bu ayniqsa POST yoki PATCH so‘rovlaridan oldin foydalidir.
• magaza__cagir tanlangan amalni chaqiradi va yo‘l parametrlarini avtomatik to‘ldiradi.

Foydali ilg‘or so‘rov:

Ulangan do‘kon API’sidan ushbu resursni boshqaradigan endpointni qidiring. Yozish amalini bajarishdan oldin so‘rov sxemasini ko‘rsating.

Kataloglar Apple’ning rasmiy App Store Connect OpenAPI spetsifikatsiyasi hamda Google’ning Android Publisher va Play Developer Reporting discovery hujjatlaridan yaratiladi. Eskirgan Apple amallari biror imkoniyatga olib boradigan yagona yo‘l bo‘lib qolganida qidirish mumkin bo‘ladi, ammo ularning qisqacha tavsifi [ESKİMİŞ] bilan boshlanadi va qidiruv natijalarida pastroq o‘rin egallaydi.

Vositalar izolyatsiyasini tushunish

Server do‘konlarni aralashtirib yubormaslik uchun bir nechta dizayn qoidalariga amal qiladi:

• Har bir do‘konga xos vosita aniq prefiksga ega.
• appstore__ prefiksli vosita hech qachon Google Play’ni chaqirmaydi, play__ vositasi esa Apple’ni chaqirmaydi.
• Tanlanmagan do‘kon uchun vositalar xotiraga yuklanmaydi yoki modelga ko‘rsatilmaydi.
• Do‘konlararo vositalar faqat ikkala do‘kon yoqilganida mavjud bo‘ladi.
• Dispetcherlar qabul qiladigan magaza argumenti o‘rnatish vaqtida sozlangan do‘konlar bilan cheklanadi.

Ikki do‘konli o‘rnatish 27 ta vositani yuklaydi. Faqat App Store o‘rnatishlari 14 ta, faqat Play o‘rnatishlari esa 13 ta vositani yuklaydi. Bu MCP kontekstini sozlangan muhit bilan moslashtiradi.

Ilg‘or xavfsizlik maslahatlari

• Hisob ma'lumotlarini chatga joylashtirmang: npx magaza-mcp kur buyrug'ini o'zingiz ishga tushiring va hisob ma'lumotlari yo'llarini mahalliy sozlash ustasi orqali kiriting.
• Tahlil uchun faqat o'qish rejimidan foydalaning: Sizga faqat reliz, ko'rib chiqish, narxlash, xarid yoki holat haqidagi ma'lumotlar kerak bo'lganda ushbu rejimni yoqing.
• Tavsiya etilgan har bir yozuv amalini ko'rib chiqing: onayla=true ni tasdiqlashdan oldin ilova, resurs, til va so'rov tanasini tekshiring.
• Minimal ruxsatlarni bering: Apple'da zarur endpoint aniqroq kengroq ruxsatni talab qilmasa, App Manager'dan foydalaning; Google xizmat hisobini esa tegishli ilovalar bilan cheklang.
• Tizim vaqtini aniq saqlang: Apple JWT'larining amal qilish muddati 20 daqiqa, shuning uchun soatdagi katta farq autentifikatsiya xatolariga olib kelishi mumkin.

Server yo'l parametrlarini tekshiradi va kodlaydi, . va .. kabi katalogdan chiqish urinishlarini rad etadi hamda mutlaq URL manzillari uchun xostlarni tekshiradi. Tarmoq trafigi faqat Apple API'si, Android Publisher API'si, Play Developer Reporting API'si va Google OAuth token endpoint'i bilan cheklangan.

Muammolarni bartaraf etish

Apple 401 xatosini qaytaradi

Key ID, Issuer ID va .p8 fayli bir xil App Store Connect API kalitiga tegishli ekanini tekshiring. Mashina soatini tekshiring, chunki vaqti noto'g'ri JWT rad etilishi mumkin. Shuningdek, fayl StoreKit yoki push-bildirishnoma kaliti emasligini tasdiqlang.

Apple 403 xatosini qaytaradi

API kalitida ushbu amal uchun zarur rol bo'lmasligi mumkin. App Manager ko'pchilik ish jarayonlarini qamrab oladi, ammo foydalanuvchilarni boshqarish va ayrim hisobotlar qo'shimcha imtiyozlarni talab qiladi. Rolidan qat'i nazar, shartnoma, soliq va bank ma'lumotlarini API orqali olish mumkin emas.

Google Play 403 xatosini qaytaradi

Xizmat hisobi Play Console'ga taklif qilinganini va mo'ljallangan ilovaga kirish huquqiga ega ekanini tasdiqlang. Ruxsatlardagi o'zgarishlar kuchga kirishi uchun bir necha daqiqa ketishi mumkin. Shuningdek, Cloud loyihasida Android Publisher API va Play Developer Reporting API yoqilganini tekshiring.

Agar xato eski inappproducts endpoint'iga tegishli bo'lsa, ilova Google'ning yangiroq mahsulot modelidan foydalanayotgan bo'lishi mumkin. play__urunler vositasi buni avval oneTimeProducts ni sinab ko'rish va zarur bo'lganda eski modelga o'tish orqali hal qiladi.

Trek ma'lumotlari sekin ko'rinadi

Google Play reliz treki ma'lumotlarini tahrirlash sessiyasi orqali taqdim etadi. O'qish vositalari sessiyani yaratadi, ma'lumotlarni o'qiydi va o'zgarishlarni saqlamasdan sessiyani tark etadi, shuning uchun do'konda hech qanday o'zgarish yuz bermaydi. Bu jarayon qo'shimcha HTTP so'rovlarini talab qiladi va shu sababli uzoqroq davom etishi mumkin.

Ishlab chiqish muhiti

Loyihaning o'zida ishlash uchun repozitoriyani klonlang va uning bog'liqliklarini o'rnating:

git clone https://github.com/tunaarikaya/magaza-mcp.git
cd magaza-mcp
npm install
npm run build
npm run kontrol
npm run dev

npm run build TypeScript manba kodini kompilyatsiya qiladi, npm run kontrol fayllar yaratmasdan turlarni tekshiradi, npm run dev esa kuzatuv rejimida kompilyatsiyani ishga tushiradi.

spec/ ostidagi uchta spetsifikatsiya faylidan API kataloglarini qayta yaratish uchun quyidagini ishga tushiring:

node scripts/uret-katalog.mjs

Yaratilgan operatsiya kataloglari src/katalog/ ostiga yoziladi; operatsiyalar ro'yxatini qo'lda yuritish ko'zda tutilmagan.

Xulosa

Mağaza MCP App Store Connect va Google Play'ni MCP bilan mos bitta yordamchidan boshqarishning amaliy usulini taqdim etadi. Uning do'konlararo vositalari narxlarni taqqoslash, ilovalar ro'yxatini ko'rish va xaridlar diagnostikasini soddalashtiradi, qidirish imkoniyatiga ega to'liq API katalogi esa kam uchraydigan operatsiyalarni ham qamrab oladi. Hisob ma'lumotlarini mahalliy boshqarish, tasdiqlash bosqichlari, faqat o'qish rejimi va telemetriyaning yo'qligi do'konga kirish nazorat ostida qolishi kerak bo'lgan ish jarayonlari uchun uni mos qiladi.