دوز مباشرة للمحتوى الرئيسي
دروس فالذكاء الاصطناعي

سيّر App Store Connect وGoogle Play مع Mağaza MCP

تعلّم كيفاش تركّب Mağaza MCP، تربط بيانات الدخول ديال Apple وGoogle بأمان، تستعمل اللغة الطبيعية باش تستعلم من المتجرين، تقارن الاشتراكات، تشخّص عمليات الشراء، توصل لعمليات API متقدّمة، وتفعّل حماية القراءة فقط.

حوالي 26 دقايق ديال القراية
سيّر App Store Connect وGoogle Play مع Mağaza MCP

شنو هو Mağaza MCP؟

Mağaza MCP هو خادم مفتوح المصدر ديال Model Context Protocol، كيعطي للمساعدات ديال الذكاء الاصطناعي الولوج لـ App Store Connect وGoogle Play من تثبيت واحد. تدار للمطورين ولمسؤولي التطبيقات اللي محتاجين يفتشو ويقارنو ويدبرو معطيات المتاجر ديال iOS وAndroid بلا ما يبدلو بين تكاملات مختلفة.

الخادم كيخدم محليا فالجهاز ديالك وكيتواصل مباشرة مع Apple وGoogle. ما كاين حتى خدمة وسيطة. أدوات Apple كتستعمل السابقة appstore__، وأدوات Google Play كتستعمل play__، أما أدوات المتجرين أو أدوات API العامة فكتستعمل magaza__.

الميزة المميزة ديالو هي القدرة على الجواب على الأسئلة اللي كتهم المتجرين فعملية وحدة. مثلا، المساعد يقدر يقارن ثمن الاشتراك نفسه بالليرة التركية فـ App Store وGoogle Play، يربط التطبيقات المتناظرة ديال iOS وAndroid، أو يقلب على مشكل فإعدادات المشتريات داخل التطبيق فالمتجرين بجوج.

أهم المميزات

  • خادم MCP واحد للمتجرين: ربط App Store Connect أو Google Play أو بجوج.
  • مسارات عمل مشتركة بين المتاجر: قارن الاشتراكات، خرج نظرة عامة موحدة على التطبيقات، وشخّص إعدادات المشتريات داخل التطبيق فالمنصتين بجوج.
  • 27 أداة مركزة: التثبيت ديال المتجرين كيوفر 27 أداة للعمليات الشائعة ديال المتاجر وللولوج العام إلى API.
  • تغطية كاملة ديال API: قلب واستعمل 1,440 عملية من App Store Connect API v4.5 وAndroid Publisher API v3 وPlay Developer Reporting API v1beta1.
  • استهلاك منخفض للسياق: الكتالوج الكامل ديال API كيتوصل ليه عبر أدوات البحث والتوزيع، بلا ما يتعرضو جميع العمليات الـ1,440 كأدوات MCP منفصلة.
  • تخزين محلي لبيانات الدخول: بيانات الدخول كتتحفظ فـ macOS Keychain إلا كان متاح، ومعاه ملف بديل بصلاحيات محدودة فالأنظمة اللي ما كتقدرش تستعمل Keychain.
  • التأكيد قبل الكتابة: العمليات اللي كتبدل المعطيات كتحتاج تأكيد صريح عبر onayla=true.
  • الوضعية ديال القراءة فقط: أدوات الكتابة تقدر تتحيد نهائيا من لائحة الأدوات ديال النموذج.
  • بلا تتبع: المشروع ما كيبعثش تحليلات ولا تقارير الأخطاء ولا معطيات الاستعمال.

المتطلبات الأساسية

ثبّت Node.js 18 أو أحدث قبل ما تشغل الحزمة. خاصك حتى بيانات دخول مناسبة لكل متجر بغيتي تربطو.

متطلبات App Store Connect

أنشئ مفتاح API ديال App Store Connect وخلي Key ID وIssuer ID وملف .p8 واجدين وقت الإعداد. الدور ديال App Manager كافي لمعظم العمليات. نقاط النهاية ديال تدبير المستخدمين والصلاحيات، وزيد عليها بعض تقارير التحليلات، ممكن تحتاج صلاحيات أكبر.

خاص المفتاح يكون مفتاح API ديال App Store Connect. مفاتيح StoreKit ومفاتيح الإشعارات الفورية ما تقدرش تعوضو.

متطلبات Google Play

  1. عيّط لحساب الخدمة عبر Play Console → Users and permissions، ومن بعد عطيو الولوج للتطبيقات المعنية.
  2. فعّل بجوج Android Publisher API وPlay Developer Reporting API فمشروع Google Cloud المرتبط.

Reporting API ضرورية ماشي غير لمقاييس الأعطال، ولكن حتى لاكتشاف التطبيقات. Android Publisher API ما كتوفرش نقطة نهاية كتسرد جميع التطبيقات المتاحة للحساب.

العقود والتفاصيل الضريبية والمعلومات البنكية ما يمكنش تتقرا عبر هاد الواجهات. Apple ما كتكشفش هاد المعلومات عبر مفاتيح API ديال App Store Connect.

ثبّت Mağaza MCP

بدا برنامج التثبيت التفاعلي بأمر واحد:

npx magaza-mcp kur

المعالج كيوجهك فهاد المراحل:

  1. اختار App Store Connect أو Google Play أو المتجرين بجوج.
  2. دخل App Store Connect Key ID وIssuer ID، ومن بعد عطِ المسار ديال ملف .p8.
  3. عطِ المسار ديال ملف JSON ديال حساب الخدمة فـ Google Play.
  4. اختار عملاء الذكاء الاصطناعي اللي تكتاشفو وفين خاص يتثبت إعداد MCP.
  5. اختار واش الخادم يخدم فالوضعية ديال القراءة فقط.

برنامج التثبيت كيتحقق من بيانات الدخول ديال Apple وGoogle باستعمال طلبات حقيقية لـ API قبل ما يحفظها. بيانات الدخول ما كتكتبش فملف إعدادات عميل الذكاء الاصطناعي. الإعدادات فيها غير معلومات بحال المتاجر المفعلة عبر MAGAZALAR.

فـ macOS، بيانات الدخول كتتحفظ فـ Keychain. إلا ما كانش Keychain متاح، المشروع كيرجع لملف بصلاحيات 0600.

عملاء MCP المدعومين

برنامج التثبيت كيدعم Claude Code وClaude Desktop وAntigravity وCursor وWindsurf وCodex. كيحدّث غير المدخلة magaza-mcp، كيحافظ على الإعدادات اللي ما عندهاش علاقة، كينشئ نسخة احتياطية باسم .magaza-mcp-yedek قبل الكتابة، وكيقوم بالكتابة الذرية.

عاود شغّل أي تطبيقات عميلة محلولة من بعد الإعداد باش تقدر تحمل خادم MCP الجديد.

تحقق من التثبيت

استعمل أوامر الحالة ولائحة الأدوات باش تتأكد من النتيجة:

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

durum كيعطيك المتاجر المربوطة، بينما araclar كيسرد الأدوات المثبتة. الأدوات اللي عليها العلامة ✎ تقدر تبدل معطيات المتجر.

الاستعمال الأساسي

Mağaza MCP موجه للاستعمال عبر طلبات باللغة الطبيعية فالمساعد ديالك المتوافق مع MCP. من بعد ما تعاود تشغيل العميل، بدا بطلب بسيط باش تعرف التطبيقات:

سرد التطبيقات ديالي فالمتجرين بجوج وبيّن فين كل تطبيق منشور حاليا.

ملي كيكونو بجوج الستورات مربوطين، magaza__genel_bakis كيجمع لوائح التطبيقات، كيربط المنتجات المطابقة ديال iOS وAndroid، وكيفرّق بين التطبيقات اللي كاينة غير فستّور واحد.

قارن أثمان الاشتراكات

طلب من المساعد يقارن اشتراك فبلد معيّن:

شحال كيكلف الاشتراك الشهري ديال Note Keeper فـ App Store وGoogle Play فتركيا؟ واش كاين فرق؟

الأداة magaza__abonelik_karsilastir كتقارن معرّفات المنتجات، وفترات الفوترة، والأثمان الخاصة بكل بلد. وكتحوّل حتى رمز البلد للصيغة اللي كيتسناها كل ستّور.

شخّص مشاكل الشراء

إلى كان شي زبون خلّص ولكن ما توصلش بالولوج المميّز، استعمل طلب بحال:

كيقول شي زبون بلّي خلّص ولكن الولوج المميّز ما تفعلش. قلّب فإعدادات الشراء فالجوج ديال الستورات ولخّص الأسباب المحتملة.

الأداة magaza__iap_teshis كتشوف واش المنتجات منشورة، وواش كاين الثمن فالبلد المعني، وواش كاين مخطط أساسي فـ Google Play متاح للمشتركين الجدد. إلا عطيتها رمز شراء ديال Play، تقدر تتحقق من هاد الرمز كجزء من التشخيص.

فحص App Store Connect

الأدوات الخاصة بـ App Store تقدر تعرض التطبيقات، والإصدارات، وبنيات TestFlight، والتقييمات، ومجموعات الاشتراكات، وأثمان الاشتراكات، وعمليات الشراء داخل التطبيق، ومجموعات TestFlight، وتقارير المبيعات. من أمثلة الطلبات:

  • شنو هو إصدار App Store اللي مازال عالق فالمراجعة؟
  • واش سالات معالجة بنية TestFlight اللي رفعت البارح؟
  • لخّص تقييمات نجمة وحدة وجوج نجوم ديال الأسبوع اللي فات.
  • حمّل التقرير اليومي ديال المبيعات لهاد التطبيق.

يمكن حتى تبدّل بيانات الستّور والردود على التقييمات، ولكن هاد العمليات كتحتاج تأكيد صريح.

فحص Google Play

أدوات Google Play كتشمل التطبيقات، ومسارات الإصدارات، والتقييمات، والاشتراكات، وأثمان المخططات الأساسية، والمنتجات ذات الشراء لمرة وحدة، والتحقق من عمليات الشراء، وعمليات الشراء الملغاة، ونسب الأعطال فـ Android vitals. من أمثلة الطلبات:

  • شنو هو الإصدار الموجود فمسار الإنتاج، وشنحال من النسبة ديال المستخدمين كتوصلو؟
  • واش تزادت نسبة الأعطال خلال آخر 14 يوم؟
  • واش رمز الشراء هادا صالح، وواش الاشتراك مازال نشيط؟
  • ورّيني عمليات الشراء اللي تردّات فلوسها ولا تلغات خلال المدة المتاحة.

Google كتعرض غير تقريباً تقييمات الأسبوع الأخير من خلال الـ API المعني. وبيانات عمليات الشراء الملغاة محدودة فآخر 30 يوم.

نفّذ عمليات الكتابة بأمان

أدوات بحال appstore__yorum_yanitla وappstore__metin_guncelle وplay__yorum_yanitla تقدر تبدّل بيانات الستّور. ما كتنفذش مباشرة من أول طلب. عوض ذلك، السيرفر كيرجع العملية المقترحة وجسم الطلب المتوقع.

من بعد ما تراجع الاقتراح، وافق عليه وخلي المساعد يعاود العملية بهاد القيمة:

onayla=true

بوابة التأكيد هادي كيتكلف بها السيرفر، وما كتعتامدش غير على واجهة عميل MCP.

فعّل الوضعية ديال القراءة فقط

بالنسبة للتدقيق، وإعداد التقارير، ولا التجارب الحذرة، شغّل السيرفر فالوضعية ديال القراءة فقط:

npx magaza-mcp --salt-okunur

وتقدر حتى تحدد:

SALT_OKUNUR=1

ملي كيكونو بجوج الستورات مربوطين، الوضعية ديال القراءة فقط كتنقص اللائحة المعروضة من 27 أداة لـ 24. الأدوات الخاصة بالكتابة كتختافي، وبالتالي النموذج ما كيقدرش يشوفها ولا ينادي عليها. الموزّع العام magaza__cagir كيبقى متاح حيث حتى هو ضروري لعمليات القراءة، ولكن كيرفض عمليات الكتابة فالوضعية ديال القراءة فقط.

استعمل الكتالوج الكامل ديال الـ API

الأدوات المركّزة كغطّي المسارات الشائعة، ولكن Mağaza MCP كيوفّر حتى الولوج لـ 1,440 عملية ديال API. بلا ما يحط كل عملية فالسياق ديال النموذج، كيعرض ثلاثة ديال الأدوات العامة:

  • magaza__endpoint_ara كيقلب فكتالوجات API ديال الستورات المربوطة وكيرجع أسماء العمليات المطابقة، وطرق HTTP، والمسارات، والمعاملات.
  • magaza__sema كيعرض مخطط جسم الطلب ديال شي عملية، وهاد الشي مفيد خصوصاً قبل طلبات POST ولا PATCH.
  • magaza__cagir كينادي العملية المختارة وكيعمّر معاملات المسار أوتوماتيكياً.

من الطلبات المتقدمة المفيدة:

قلّب فـ API ديال الستّور المربوط على endpoint كيدبّر هاد المورد. ورّيني مخطط الطلب قبل ما تحاول أي عملية كتابة.

الكتالوجات متولّدة من مواصفة OpenAPI الرسمية ديال Apple الخاصة بـ App Store Connect، ومن وثائق الاكتشاف ديال Android Publisher وPlay Developer Reporting ديال Google. عمليات Apple القديمة كيبقاو قابلين للبحث ملي كيكونو مازال الطريق الوحيد لإمكانية معيّنة، ولكن الملخصات ديالهم ككتبدا بـ [ESKİMİŞ] وكيتصنّفو بدرجة أقل فنتائج البحث.

فهم عزل الأدوات

السيرفر كيتفادى الخلط بين الستورات بفضل مجموعة ديال قواعد التصميم:

  • كل أداة خاصة بستّور عندها بادئة واضحة.
  • الأداة اللي عندها البادئة appstore__ ما كتناديش أبداً على Google Play، وأداة play__ ما كتناديش على Apple.
  • الأدوات ديال الستّور اللي ما تختارش ما كيتحمّلوش فالذاكرة وما كيبانوش للنموذج.
  • الأدوات المشتركة بين الستورات كتكون موجودة غير ملي كيكونو بجوج الستورات مفعّلين.
  • المعامل magaza اللي كيتقبلوه أدوات التوزيع محدود فالستورات اللي تهيّأو وقت التثبيت.

التثبيت ديال جوج ستورات كيحمّل 27 أداة. التثبيت ديال App Store بوحدو كيحمّل 14، وديال Play بوحدو كيحمّل 13. هاد الشي كيخلي سياق MCP منسجم مع البيئة المهيّأة.

نصائح متقدمة للأمان

  • ما تلصقش بيانات الدخول فالدردشة: شغّل npx magaza-mcp kur بوحدك ودخّل مسارات بيانات الدخول عبر المعالج المحلي.
  • استعمل الوضع للقراءة فقط فالتحليل: فعّلو ملي كتحتاج غير لمعلومات الإصدار، المراجعة، التسعير، الشراء، ولا الحالة.
  • راجع كل عملية كتابة مقترحة: تأكّد من التطبيق، المورد، اللغة، ونص الطلب قبل ما توافق على onayla=true.
  • عطي أقل الصلاحيات الضرورية: استعمل App Manager فـ Apple إلا إلى كان واحد المسار المطلوب كيحتاج صلاحيات أكثر بشكل صريح، وحدّد حساب الخدمة ديال Google فالتطبيقات المعنية.
  • خلّي وقت النظام مضبوط: رموز JWT ديال Apple عندها مدة صلاحية ديال 20 دقيقة، وفرق كبير فالساعة يقدر يسبب فشل فالمصادقة.

السيرفر كيتحقق من معاملات المسارات وكيشفّرها، وكيرفض محاولات تجاوز المسار بحال . و..، وكيتحقق من المضيفين فالعناوين المطلقة. حركة الشبكة محدودة فـ API ديال Apple، وAndroid Publisher API، وPlay Developer Reporting API، ونقطة OAuth ديال Google.

حلّ المشاكل

Apple كترجع 401

تأكّد باللي Key ID وIssuer ID وملف .p8 تابعين لنفس مفتاح App Store Connect API. راقب ساعة الجهاز، حيث JWT بتوقيت غير صحيح يقدر يترفض. وتأكد حتى باللي الملف ماشي مفتاح StoreKit ولا مفتاح إشعارات الدفع.

Apple كترجع 403

ممكن مفتاح API ما عندوش الدور المطلوب لهاد العملية. App Manager كيغطي أغلب المسارات، ولكن تدبير المستخدمين وبعض التقارير كيتطلبو صلاحيات إضافية. بيانات العقود والضرائب والبنوك ما يمكنش استرجاعها عبر API مهما كان الدور.

Google Play كترجع 403

تأكد باللي حساب الخدمة تدعى فـ Play Console وعندو الولوج للتطبيق المستهدف. تغييرات الصلاحيات تقدر تحتاج بضع دقايق باش تنتاشر. وتأكد حتى باللي Android Publisher API وPlay Developer Reporting API مفعّلين فمشروع Cloud.

إلى كان المشكل مرتبط بالمسار القديم inappproducts، ممكن التطبيق كيستعمل نموذج المنتجات الجديد ديال Google. أداة play__urunler كتدبّر هاد الحالة بمحاولة oneTimeProducts أولا، ومن بعد كتستعمل النموذج القديم إلا كان ضروري.

معلومات المسارات ككتبان بشوية

Google Play كتعرض معلومات مسارات الإصدارات عبر جلسة تعديل. أدوات القراءة كتنشئ الجلسة، كتقرا البيانات، وكتخليها بلا ما تدير commit، وبالتالي ما كيتبدل والو فالمتجر. هاد العملية كتحتاج طلبات HTTP إضافية، وهادشي يقدر يخليها تاخذ وقت أكثر.

إعداد التطوير

باش تخدم على المشروع براسو، نسخ المستودع وثبّت التبعيات ديالو:

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، وnpm run kontrol كيدير التحقق من الأنواع بلا ما يخرّج ملفات، وnpm run dev كيشغّل الترجمة فـ وضع المراقبة.

باش تعاود تولّد كتالوجات API من ملفات المواصفات الثلاثة اللي كاينين فـ spec/، شغّل:

node scripts/uret-katalog.mjs

كتالوجات العمليات المتولّدة كيتكتبو فـ src/katalog/؛ لائحة العمليات ماشي مخصّصة للصيانة اليدوية.

الخلاصة

Mağaza MCP كيوفّر طريقة عملية باش تسيّر App Store Connect وGoogle Play من مساعد متوافق مع MCP. الأدوات المشتركة بين المتاجر كسهّلو مقارنة الأثمنة، وجرد التطبيقات، وتشخيص عمليات الشراء، بينما كيغطي كتالوج API الكامل والقابل للبحث العمليات الأقل استعمالا. تدبير بيانات الدخول محليا، وبوابات التأكيد، والوضع للقراءة فقط، وغياب التتبع، كيخليوه مناسب لسيرورات الخدمة اللي خاص الولوج للمتجر يبقى مضبوط.