Phatha i-App Store Connect ne-Google Play nge-Mağaza MCP

Yini i-Mağaza MCP?

I-Mağaza MCP iyiseva ye-Model Context Protocol yomthombo ovulekile enikeza abasizi be-AI ukufinyelela kukho kokubili i-App Store Connect ne-Google Play ngokufakwa okukodwa. Yakhelwe onjiniyela nabasebenzisi bezinhlelo zokusebenza abadinga ukuhlola, ukuqhathanisa nokuphatha idatha yezitolo ze-iOS ne-Android ngaphandle kokushintsha phakathi kokuhlanganiswa okuhlukene.

Iseva isebenza endaweni yakho futhi ixhumana ngokuqondile no-Apple no-Google. Ayikho isevisi ephakathi. Amathuluzi e-Apple asebenzisa isiqalo esithi appstore__, amathuluzi e-Google Play asebenzisa play__, kanti amathuluzi ezitolo zombili noma e-API evamile asebenzisa magaza__.

Isici sayo esihlukile yikhono lokuphendula imibuzo ephathelene nezitolo zombili ngokusebenza okukodwa. Ngokwesibonelo, umsizi wakho angaqhathanisa intengo yaseTurkey yokubhalisa okufanayo ku-App Store naku-Google Play, ahlanganise izinhlelo zokusebenza ezihambisanayo ze-iOS ne-Android, noma aphenye inkinga yokulungiselela ukuthenga ngaphakathi kohlelo kuzo zombili izitolo.

Izici Eziyinhloko

• Iseva eyodwa ye-MCP yezitolo ezimbili: Xhuma i-App Store Connect, i-Google Play, noma zombili.
• Ukuhamba komsebenzi kweziteshi zombili: Qhathanisa okubhaliselwe, wenze isifinyezo esihlanganisiwe sohlelo lokusebenza, futhi uhlole izilungiselelo zokuthenga ngaphakathi kohlelo kuzo zombili izinkundla.
• Amathuluzi agxile angu-27: Ukufakwa kwezitolo ezimbili kuveza amathuluzi angu-27 okusebenza okuvamile ezitolo nokufinyelela ku-API evamile.
• Ukufakwa okuphelele kwe-API: Sesha futhi usebenzise imisebenzi engu-1,440 evela ku-App Store Connect API v4.5, Android Publisher API v3, naku-Play Developer Reporting API v1beta1.
• Ukusetshenziswa okuncane komongo: Ikhathalogi ephelele ye-API ifinyelelwa ngamathuluzi okusesha nawokusabalalisa esikhundleni sokuveza yonke imisebenzi engu-1,440 njengamathuluzi e-MCP ahlukene.
• Ukugcinwa kwemininingwane yokungena endaweni: Imininingwane yokungena igcinwa ku-macOS Keychain uma itholakala, bese kusetshenziswa ifayela elinemvume ekhawulelwe uma i-Keychain ingasetshenziswa ohlelweni.
• Ukuqinisekisa izinguquko: Imisebenzi eshintsha idatha idinga ukuqinisekiswa okusobala nge-onayla=true.
• Imodi yokufunda kuphela: Amathuluzi okubhala angasuswa ngokuphelele ohlwini lwamathuluzi emodeli.
• Ayikho i-telemetry: Iphrojekthi ayithumeli izibalo zokusetshenziswa, imibiko yamaphutha, noma idatha yokusebenzisa.

Okudingekayo

Faka i-Node.js 18 noma entsha ngaphambi kokusebenzisa iphakheji. Udinga futhi imininingwane yokungena efanele yesitolo ngasinye ofuna ukusixhuma.

Izidingo ze-App Store Connect

Dala ukhiye we-App Store Connect API futhi ugcine i-Key ID, i-Issuer ID, kanye nefayela le-.p8 kutholakala ngesikhathi sokusetha. Indima ye-App Manager yanele emisebenzini eminingi. Ama-endpoint okuphatha abasebenzisi nokufinyelela, kanye neminye imibiko yezibalo, kungadinga amalungelo aphezulu.

Ukhiye kufanele kube ukhiye we-App Store Connect API. Okhiye be-StoreKit nabazaziso ze-push ngeke basetshenziswe esikhundleni salo.

Izidingo ze-Google Play

1. Mema i-service account nge-Play Console → Users and permissions, bese uyinikeza ukufinyelela ezinhlelweni zokusebenza ezifanele.
2. Vumela kokubili i-Android Publisher API ne-Play Developer Reporting API kuphrojekthi ehambisanayo ye-Google Cloud.

I-Reporting API iyadingeka hhayi kuphela kumamethrikhi okuphahlazeka, kodwa nasekutholeni izinhlelo zokusebenza. I-Android Publisher API ayinayo i-endpoint yokufaka ohlwini zonke izinhlelo zokusebenza ezitholakala ku-akhawunti.

Izinkontileka, imininingwane yentela, kanye nolwazi lwasebhange ngeke kufundwe ngala ma-API. U-Apple akaludaluli lolu lwazi ngokusebenzisa okhiye be-App Store Connect API.

Faka i-Mağaza MCP

Qalisa isifaki esisebenzisanayo ngomyalo owodwa:

npx magaza-mcp kur

Iwizadi ikuqondisa kulezi zinyathelo ezilandelayo:

1. Khetha i-App Store Connect, i-Google Play, noma zombili izitolo.
2. Faka i-App Store Connect Key ID ne-Issuer ID, bese unikeza indlela eya kufayela le-.p8.
3. Faka indlela eya kufayela le-JSON le-service account ye-Google Play.
4. Khetha amaklayenti e-AI atholiwe lapho kufanele kufakwe khona ukulungiselelwa kwe-MCP.
5. Khetha ukuthi iseva kufanele isebenze ngemodi yokufunda kuphela.

Isifaki siqinisekisa imininingwane yokungena ka-Apple neka-Google ngezicelo zangempela ze-API ngaphambi kokuyigcina. Imininingwane yokungena ayibhalwa efayeleni lokulungiselela leklayenti le-AI. Ukulungiselela kuqukethe kuphela ulwazi olufana nokuthi yiziphi izitolo ezinikwe amandla nge-MAGAZALAR.

Ku-macOS, imininingwane yokungena igcinwa ku-Keychain. Uma i-Keychain ingatholakali, iphrojekthi isebenzisa ifayela elinezimvume ze-0600.

Amaklayenti e-MCP Asekelwayo

Isifaki sisekela i-Claude Code, i-Claude Desktop, i-Antigravity, i-Cursor, i-Windsurf, ne-Codex. Sibuyekeza kuphela okufakiwe kwe-magaza-mcp, sigcine ukulungiselelwa okungahlobene, sidale isipele se-.magaza-mcp-yedek ngaphambi kokubhala, futhi senze ukubhala kwe-athomu.

Qalisa kabusha noma yiziphi izinhlelo zokusebenza zamaklayenti ezivuliwe ngemva kokusetha ukuze zilayishe iseva entsha ye-MCP.

Qinisekisa Ukufakwa

Sebenzisa imiyalo yesimo nohlu lwamathuluzi ukuqinisekisa umphumela:

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

durum ibika ukuthi yiziphi izitolo ezixhunyiwe, kanti araclar ibala amathuluzi afakiwe. Amathuluzi amakwe nge-✎ angashintsha idatha yesitolo.

Ukusetshenziswa Okuyisisekelo

I-Mağaza MCP ihloselwe ukusetshenziswa ngezicelo zolimi lwemvelo kumsizi wakho ohambisana ne-MCP. Ngemva kokuba iklayenti seliqalisiwe kabusha, qala ngesicelo esilula sohlu:

Faka ohlwini izinhlelo zami zokusebenza kuzo zombili izitolo futhi ubonise ukuthi ngayinye ishicilelwe kuphi njengamanje.

Uma zombili izitolo zixhunyiwe, i-magaza__genel_bakis ihlanganisa uhlu lwezinhlelo zokusebenza, iqondanise imikhiqizo ehambisanayo ye-iOS ne-Android, bese ihlukanisa izinhlelo zokusebenza ezitholakala esitolo esisodwa kuphela.

Qhathanisa Amanani Okubhalisa

Celisa umsizi ukuthi aqhathanise ukubhalisa ezweni elithile:

Ibiza malini imali yokubhalisa yanyanga zonke ye-Note Keeper ku-App Store naku-Google Play eTurkey? Ingabe kukhona umehluko?

Ithuluzi le-magaza__abonelik_karsilastir liqhathanisa izihlonzi zemikhiqizo, izikhathi zokukhokha, namanani aqondene nezwe. Liphinde liguqule ikhodi yezwe ibe yifomethi elindelwe yisitolo ngasinye.

Thola Izimbangela Zezinkinga Zokuthenga

Kumakhasimende akhokhile kodwa angazange athole ukufinyelela kwe-premium, sebenzisa isicelo esifana nalesi:

Ikhasimende lithi likhokhile kodwa ukufinyelela kwe-premium akuzange kusebenze. Hlola ukusethwa kokuthenga kuzo zombili izitolo bese ufingqa izimbangela ezingaba khona.

Ithuluzi le-magaza__iap_teshis lihlola ukuthi imikhiqizo ishicilelwe yini, ukuthi amanani akhona yini ezweni elifanele, nokuthi uhlelo oluyisisekelo lwe-Google Play luyatholakala yini kwababhalisi abasha. Uma unikeza ithokheni yokuthenga ye-Play, ithuluzi lingaqinisekisa leyo thokheni njengengxenye yokuhlolwa.

Hlola i-App Store Connect

Amathuluzi aqondene ne-App Store angabhala izinhlelo zokusebenza, ukukhishwa, ama-build e-TestFlight, izibuyekezo, amaqembu okubhalisa, amanani okubhalisa, ukuthenga kwangaphakathi kohlelo lokusebenza, amaqembu e-TestFlight, nemibiko yokuthengisa. Izicelo eziyizibonelo zihlanganisa:

• Iyiphi inguqulo ye-App Store ebambeke ekubuyekezweni njengamanje?
• Ingabe i-build ye-TestFlight engiyilayishe izolo isiqedile ukucutshungulwa?
• Fingqa izibuyekezo ezinenkanyezi eyodwa nezimbili zesonto eledlule.
• Landa umbiko wokuthengisa wansuku zonke walolu hlelo lokusebenza.

Imethadatha yesitolo nezimpendulo kuzibuyekezo nakho kungashintshwa, kodwa le misebenzi idinga ukuqinisekiswa okusobala.

Hlola i-Google Play

Amathuluzi e-Google Play ahlanganisa izinhlelo zokusebenza, amathrekhi okukhishwa, izibuyekezo, okubhaliselwe, amanani ezinhlelo eziyisisekelo, imikhiqizo yesikhathi esisodwa, ukuqinisekiswa kokuthenga, ukuthenga okuhoxisiwe, namazinga okuphahlazeka e-Android vitals. Izicelo eziyizibonelo zihlanganisa:

• Iyiphi inguqulo esethrekhini yokukhiqiza, futhi yimaphi amaphesenti abasebenzisi ayitholayo?
• Ingabe izinga lokuphahlazeka lenyukile ezinsukwini ezingu-14 ezedlule?
• Ingabe le thokheni yokuthenga isemthethweni, futhi ingabe ukubhalisa kusasebenza?
• Bonisa ukuthenga okubuyiselwe imali noma okuhoxisiwe kwesikhathi esitholakalayo.

I-Google iveza cishe izibuyekezo zesonto lakamuva kuphela nge-API efanele. Idatha yokuthenga okuhoxisiwe ikhawulelwe ezinsukwini ezingu-30 ezedlule.

Yenza Imisebenzi Yokubhala Ngendlela Ephephile

Amathuluzi afana ne-appstore__yorum_yanitla, appstore__metin_guncelle, kanye ne-play__yorum_yanitla angashintsha idatha yesitolo. Awasebenzi ngokushesha esicelweni sokuqala. Kunalokho, iseva ibuyisa isenzo esiphakanyisiwe nomzimba wesicelo olindelekile.

Ngemva kokubuyekeza isiphakamiso, sigunyaze bese ucela umsizi aphinde umsebenzi ngo:

onayla=true

Lesi sivimbelo sokuqinisekisa siphoqelelwa yiseva, hhayi ukuthembela kuphela kusixhumi esibonakalayo seklayenti le-MCP.

Vumela Imodi Yokufunda Kuphela

Ukuze wenze ukuhlola, ukubika, noma ukuzama ngokuqapha, qala iseva ngemodi yokufunda kuphela:

npx magaza-mcp --salt-okunur

Ungasetha futhi:

SALT_OKUNUR=1

Uma zombili izitolo zixhunyiwe, imodi yokufunda kuphela yehlisa uhlu oluveziwe lwamathuluzi lusuke ku-27 lube ngu-24. Amathuluzi aqondene nokubhala ayanyamalala ukuze imodeli ingawaboni noma iwabize. I-dispatcher evamile ye-magaza__cagir iyaqhubeka nokutholakala ngoba iyadingeka nasemisebenzini yokufunda, kodwa iyenqaba imisebenzi yokubhala kwimodi yokufunda kuphela.

Sebenzisa Ikhathalogi Egcwele ye-API

Amathuluzi agxilile ahlanganisa izinqubo ezivamile, kodwa i-Mağaza MCP iphinde inikeze ukufinyelela emisebenzini ye-API engu-1,440. Esikhundleni sokufaka wonke umsebenzi kumongo wemodeli, iveza amathuluzi amathathu ajwayelekile:

• magaza__endpoint_ara isesha amakhathalogi e-API ezitolo ezixhunyiwe bese ibuyisa amagama emisebenzi ehambisanayo, izindlela ze-HTTP, izindlela, namapharamitha.
• magaza__sema ibonisa i-schema yomzimba wesicelo somsebenzi, okuwusizo ikakhulukazi ngaphambi kwezicelo ze-POST noma ze-PATCH.
• magaza__cagir ibiza umsebenzi okhethiwe bese igcwalisa ngokuzenzakalelayo amapharamitha endlela.

Umyalelo othuthukile owusizo uthi:

Sesha i-API yesitolo esixhunyiwe ukuze uthole i-endpoint ephethe le nsiza. Ngibonise i-schema yesicelo ngaphambi kokuzama noma yikuphi ukubhala.

Amakhathalogi akhiqizwa kusukela ku-Apple App Store Connect OpenAPI specification esemthethweni kanye nemibhalo yokutholwa ye-Android Publisher ne-Play Developer Reporting yakwa-Google. Imisebenzi ye-Apple ephelelwe yisikhathi iyaqhubeka nokusesheka uma kuseyiyona ndlela kuphela yokufinyelela ikhono elithile, kodwa izifinyezo yayo ziqala ngo-[ESKİMİŞ] futhi ibekwa ezikhundleni eziphansi emiphumeleni yosesho.

Qonda Ukuhlukaniswa Kwamathuluzi

Iseva igwema ukuhlanganisa izitolo ngemithetho eminingana yokuklama:

• Wonke amathuluzi aqondene nesitolo anesiqalo esicacile.
• Ithuluzi elinesiqalo se-appstore__ alilokothi libize i-Google Play, futhi ithuluzi le-play__ alilokothi libize i-Apple.
• Amathuluzi esitolo esingakhethiwe awalayishwa kwimemori noma aboniswe imodeli.
• Amathuluzi ezitolo ezahlukene akhona kuphela uma zombili izitolo zivuliwe.
• Impikiswano ye-magaza eyamukelwa amathuluzi e-dispatch ikhawulelwe ezitolo ezilungiselelwe ngesikhathi sokufakwa.

Ukufakwa kwezitolo ezimbili kulayisha amathuluzi angu-27. Ukufakwa kwe-App Store kuphela kulayisha angu-14, kanti okwe-Play kuphela kulayisha angu-13. Lokhu kugcina umongo we-MCP uhambisana nendawo elungiselelwe.

Amathiphu Athuthukile Okuphepha

• Unganamathiseli imininingwane yokungena engxoxweni: Sebenzisa npx magaza-mcp kur ngokwakho bese ufaka izindlela zemininingwane yokungena ngokusebenzisa iwizadi yasendaweni.
• Sebenzisa imodi yokufunda kuphela ekuhlaziyeni: Yivule lapho udinga kuphela imininingwane yokukhishwa, ukubuyekezwa, amanani, ukuthenga, noma impilo yesistimu.
• Buyekeza konke okubhaliwe okuhlongozwayo: Qinisekisa uhlelo, insiza, ulimi, nomzimba wesicelo ngaphambi kokuvumela onayla=true.
• Nikeza izimvume ezincane ezidingekayo: Sebenzisa i-App Manager ku-Apple ngaphandle kwalapho i-endpoint edingekayo idinga ukufinyelela okwengeziwe, futhi ukhawulele i-akhawunti yesevisi yakwa-Google ezinhlelweni ezifanele.
• Gcina isikhathi sesistimu sinembile: Ama-JWT e-Apple anesikhathi sokusebenza esiyimizuzu engu-20, ngakho ukuphambuka okukhulu kwewashi kungabangela ukwehluleka kokuqinisekisa.

Iseva iqinisekisa futhi ifake ikhodi kumapharamitha ezindlela, yenqabe imizamo yokudlula indlela efana ne-. ne-.., futhi iqinisekise ama-host kuma-URL aphelele. Ithrafikhi yenethiwekhi ikhawulelwe ku-API yakwa-Apple, i-Android Publisher API, i-Play Developer Reporting API, kanye ne-OAuth token endpoint yakwa-Google.

Ukuxazulula Izinkinga

I-Apple Ibuyisa 401

Qinisekisa ukuthi i-Key ID, i-Issuer ID, kanye nefayela le-.p8 kungokhiye ofanayo we-App Store Connect API. Hlola iwashi lomshini ngoba i-JWT enesikhathi esingalungile inganqatshwa. Futhi qinisekisa ukuthi ifayela aliyona ukhiye we-StoreKit noma wezaziso ze-push.

I-Apple Ibuyisa 403

Ukhiye we-API kungenzeka awunayo indima edingekayo kulokho kusebenza. I-App Manager ihlanganisa ukuhamba komsebenzi okuningi, kodwa ukuphathwa kwabasebenzisi neminye imibiko kudinga izimvume ezengeziwe. Idatha yezinkontileka, intela, kanye nebhange ayikwazi ukutholwa nge-API kungakhathaliseki indima.

I-Google Play Ibuyisa 403

Qinisekisa ukuthi i-akhawunti yesevisi yamenywa ku-Play Console futhi inokufinyelela kuhlelo oluqondiwe. Izinguquko zezimvume zingathatha imizuzu embalwa ukusabalala. Futhi qinisekisa ukuthi i-Android Publisher API kanye ne-Play Developer Reporting API kuvuliwe kuphrojekthi ye-Cloud.

Uma ukwehluleka kuthinta i-endpoint endala ye-inappproducts, uhlelo kungenzeka lusebenzisa imodeli entsha yemikhiqizo yakwa-Google. Ithuluzi le-play__urunler liphatha lokhu ngokuzama i-oneTimeProducts kuqala bese libuyela kumodeli endala lapho kudingeka.

Ulwazi Lwe-Track Luvela Kancane

I-Google Play iveza ulwazi lwama-release track ngeseshini yokuhlela. Amathuluzi okufunda akha iseshini, afunde idatha, bese ayishiya ngaphandle kokuyithumela, ngakho azikho izinguquko ezenzeka esitolo. Le nqubo idinga izicelo ezengeziwe ze-HTTP futhi ngenxa yalokho ingathatha isikhathi eside.

Ukusetha Ukuthuthukisa

Ukuze usebenze kuphrojekthi uqobo, klona indawo yokugcina bese ufaka okuncikile kuyo:

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 ihlanganisa umthombo we-TypeScript, npm run kontrol iqhuba ukuhlolwa kwezinhlobo ngaphandle kokukhipha amafayela, kanti npm run dev iqala ukuhlanganisa ngemodi yokubuka.

Ukuze uphinde ukhiqize amakhathalogi e-API kumafayela amathathu ezincazelo angaphansi kwe-spec/, sebenzisa:

node scripts/uret-katalog.mjs

Amakhathalogi okusebenza akhiqiziwe abhalwa ngaphansi kwe-src/katalog/; uhlu lwemisebenzi aluhloselwe ukugcinwa ngesandla.

Isiphetho

IMağaza MCP inikeza indlela esebenzayo yokusebenzisa i-App Store Connect ne-Google Play kusuka kumsizi ohambisana ne-MCP. Amathuluzi ayo asebenza kuzo zombili izitolo enza ukuqhathanisa amanani, uhlu lwezinhlelo, nokuxilongwa kokuthenga kube lula, kanti ikhathalogi ephelele ye-API eseshekayo ihlanganisa imisebenzi engavamile ukusetshenziswa. Ukuphathwa kwemininingwane yokungena endaweni, izinyathelo zokuqinisekisa, imodi yokufunda kuphela, kanye nokungabikho kwe-telemetry kwenza ilungele ukuhamba komsebenzi lapho ukufinyelela esitolo kufanele kuhlale kulawulwa.