Partner MCP: أدِر شراكتك مع زد من Claude أو Cursor أو VS Code

شراكتك كلها في محادثة واحدة

كشريك في زد، يتوزع يومك غالبًا بين محرر الكود ولوحة الشركاء. مع Partner MCP تصل إلى لوحة الشركاء من داخل محرر الكود. تربط Claude أو Cursor أو VS Code بحسابك كشريك في زد، ثم تطلب ما تحتاجه بلغة طبيعية بدل التنقل بين الشاشات.

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

ماذا تستطيع أن تفعل؟

يغطي Partner MCP العمل اليومي لإدارة تطبيقاتك في سوق التطبيقات:

• التطبيقات: أنشئ تطبيقًا، وعدّل صفحته في السوق، واضبط الصلاحيات ووضع التطبيق المدمج، ثم أرسله للمراجعة.
• الباقات والأسعار: أدِر باقاتك، ومنها الباقة الخاصة بتاجر محدد.
• التحليلات: التثبيتات والاشتراكات والتقييمات والمتاجر التي ثبّتت تطبيقك، وأسباب إلغاء التثبيت كما كتبها التاجر نفسه.
• Webhooks: اطّلع على نموذج للبيانات قبل أن تكتب المعالج، وراجع سجل الإرسال مع سبب كل فشل، وأرسل تجربة، وأعِد إرسال حدث فشل.
• المستحقات: كل دفعة والعمليات التي تتكوّن منها، مع الفواتير والإيصالات.
• المتاجر التجريبية: أنشئ متجرًا، وثبّت تطبيقك عليه، وجرّب دورة التثبيت كاملة.
• وأكثر: التقييمات والكوبونات وفريقك وبيانات شراكتك.

هذه أمثلة لطلبات يمكنك كتابتها:

• «اعرض لي أسباب إلغاء تثبيت تطبيقي خلال الشهر الماضي».
• «أعطني نموذج بيانات لحدث order.create».
• «أنشئ متجرًا تجريبيًا وثبّت تطبيقي عليه».
• «اعرض العمليات التي تتكوّن منها آخر دفعة وصلتني».

القرار دائمًا بيدك

حين يستطيع المساعد تعديل صفحة تطبيقك أو تغيير أسعارك، تحتاج إلى ضمانات. لذلك يعتمد Partner MCP على اثنتين:

1. تأكيد صريح: لا يُنفَّذ أي إجراء حساس قبل موافقتك. يشرح لك المساعد التغيير، والقرار لك.
2. سجل نشاط وإلغاء الربط: راجع سجل نشاط الربط متى شئت، وألغِ الربط في أي وقت.

إعداد اتصال MCP

في توثيق زد للمطورين دليل بعنوان Our custom MCP server. الـ Server الموثّق فيه اسمه zid-open-apis-mcp، ويتيح لأداة الذكاء الاصطناعي أن تقرأ توثيق واجهات Zid Payments المفتوحة (Open APIs) وتجيب عن أسئلة التكامل منه. أما واجهات التاجر (Merchant API) فوجّه أداتك إلى صفحات التوثيق نفسها. المتطلبات كما يذكرها التوثيق:

• Node.js بالإصدار 18 أو أحدث، ويُفضَّل أحدث إصدار LTS.
• بيئة تطوير تدعم MCP، مثل Cursor أو VS Code مع إضافة Cline.

أضِف الـ Server إلى ملف JSON الخاص بـ Servers MCP في بيئة التطوير:

{
  "mcpServers": {
    "zid-open-apis-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "zid-open-apis-mcp"
      ]
    }
  }
}

لتتأكد أن الاتصال يعمل، اسأل الذكاء الاصطناعي في وضع Agent سؤالًا مثل: Based on the open apis doc, explain how merchant onboarding works. إذا جاءتك الإجابة من توثيق Open APIs، فالاتصال يعمل.

أضِف إليه Zid AI Agent Skill

Zid AI Agent Skill مهارة مفتوحة المصدر مكتوبة بصيغة Markdown لوكلاء البرمجة بالذكاء الاصطناعي. تغطي OAuth 2.0، وتخزين الـ Tokens لعدة متاجر، وطلبات Merchant API، ومعالجة الأخطاء، وحدود الطلبات، وتطلب من الـ Agent أن يتحقق من توثيق زد الحالي قبل أن يستخدم أي endpoint. يذكر التوثيق أنها تعمل مع Claude وClaude Code وopencode وغيرها من الوكلاء التي تدعم المهارات المخصّصة.

في Claude Code، شغّل هذا الأمر من جذر مشروعك:

# للمشروع الحالي
git clone https://github.com/zidsa/zid-agent-skill.git .claude/skills/zid-api-integration

# أو لكل مشاريعك
git clone https://github.com/zidsa/zid-agent-skill.git ~/.claude/skills/zid-api-integration

ثم أعِد تشغيل Claude Code أو حدّثه. في Claude، نزّل ملف .skill الجاهز من Repository Zid Agent Skill على GitHub، وأضِفه عبر خيار المهارات المخصّصة في مساحة عملك. أما في opencode والوكلاء الأخرى، فانسخ مجلد zid-api-integration إلى المجلد الذي يقرأ منه الـ Agent مهاراته.

المهارة لا تُغني عن Server MCP. المهارة توجّه الـ Agent في تصميم تكاملك وكتابة كوده، و Server MCP يساعده على جلب التوثيق المناسب أثناء العمل. ويذكر التوثيق أنك تستطيع استخدامهما معًا.