نظرة عامة
بروتوكول سياق النموذج (MCP) هو معيار مفتوح يمكّن تطبيقات الذكاء الاصطناعي من الاتصال بشكل آمن بمصادر البيانات الخارجية وواجهات برمجة التطبيقات. يوفر خادم مدفوعات دودي للمساعدين الذكيين مثل كلود، وكورسر، وغيرهم من العملاء المتوافقين مع MCP وصولاً منظمًا إلى بنية الدفع الخاصة بك. خادم Dodo Payments MCP مبني باستخدام Stainless ويستخدم بنية وضع الكود، التي تمكن وكلاء الذكاء الاصطناعي من كتابة وتنفيذ كود TypeScript ضد Dodo Payments SDK في بيئة معزولة.القدرات الرئيسية
- عمليات الدفع: إنشاء واسترجاع وإدارة المدفوعات والمبالغ المستردة
- إدارة الاشتراكات: التعامل مع الفوترة المتكررة، والترقيات، والإلغاءات
- إدارة العملاء: إدارة بيانات العملاء والوصول إلى البوابة
- كتالوج المنتجات: إنشاء وتحديث المنتجات والأسعار والخصومات
- إدارة التراخيص: تفعيل والتحقق وإدارة تراخيص البرمجيات
- الفوترة بناءً على الاستخدام: تتبع والفوترة للاستخدام المقاس
كيف يعمل وضع الكود
يستخدم خادم Dodo Payments MCP وضع الكود، مما يوفر لوكيل الذكاء الاصطناعي لديك أداتين قويتين:- أداة بحث الوثائق: استعلام عن الوثائق المتعلقة بـ Dodo Payments API وSDK لفهم العمليات والمعلمات المتاحة
- أداة تنفيذ الكود: كتابة كود TypeScript ضد SDK الذي يتم تنفيذه في بيئة آمنة معزولة بدون الوصول إلى الويب أو نظام الملفات
التثبيت
اختر طريقة التثبيت التي تناسب سير عملك.خادم MCP عن بُعد (موصى به)
الوصول إلى خادم MCP المستضاف دون أي إعداد أو تثبيت محلي. هذه هي أسرع طريقة للبدء.1
الوصول إلى الخادم عن بُعد
انتقل إلى https://mcp.dodopayments.com في متصفحك.
2
تكوين عميل MCP الخاص بك
انسخ تكوين JSON المقدم لعميلك المحدد. بالنسبة لـ Cursor أو Claude Desktop، أضف هذا إلى إعدادات MCP الخاصة بك:
3
المصادقة والتكوين
ستطلب منك عملية OAuth:
- إدخال مفتاح API الخاص بـ Dodo Payments
- اختيار بيئتك (اختبار أو مباشر)
- اختيار نوع عميل MCP الخاص بك
4
إكمال الإعداد
انقر على تسجيل الدخول والموافقة لتفويض الاتصال.
بمجرد الاتصال، يمكن لمساعدك الذكي التفاعل مع Dodo Payments API نيابة عنك.
حزمة NPM
قم بتثبيت وتشغيل خادم MCP محليًا باستخدام NPM.- NPX (بدون تثبيت)
- تكوين عميل MCP
Docker
قم بتشغيل خادم MCP في بيئة حاوية لنشر متسق.صور Docker متاحة على GitHub Container Registry.
تكوين العميل
قم بتكوين خادم Dodo Payments MCP في عميل الذكاء الاصطناعي المفضل لديك.- Cursor
- Claude Desktop
- Claude Code
- VS Code
- Cline (VS Code)
- Zed
- عملاء آخرون
قم بإعداد خادم Dodo Payments MCP في Cursor لتمكين الوصول التفاعلي إلى بيانات المدفوعات الخاصة بك.تثبيت بنقرة واحدةاستخدم الزر أدناه لتثبيت خادم MCP مباشرة في Cursor:[
](https://cursor.com/en-US/install-mcp?name=dodopayments-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRvZG9wYXltZW50cy1tY3AiXSwiZW52Ijp7IkRPRE9fUEFZTUVOVFNfQVBJX0tFWSI6IlNldCB5b3VyIERPRE9fUEFZTUVOVFNfQVBJX0tFWSBoZXJlLiIsIkRPRE9fUEFZTUVOVFNfV0VCSE9PS19LRVkiOiJTZXQgeW91ciBET0RPX1BBWU1FTlRTX1dFQkhPT0tfS0VZIGhlcmUuIn19)بعد النقر، قم بتعيين متغيرات البيئة الخاصة بك في إعدادات Cursor
mcp.json عبر إعدادات Cursor > الأدوات وMCP > خادم MCP جديد.التكوين اليدوي1
فتح إعدادات Cursor
انتقل إلى إعدادات Cursor > الميزات > بروتوكول سياق النموذج أو اضغط على
Cmd/Ctrl + Shift + P وابحث عن “إعدادات MCP”.2
تحرير التكوين
انقر على تحرير التكوين لفتح ملف
mcp_config.json.3
إضافة تكوين Dodo Payments
اختر أحد التكوينات التالية:الخادم عن بُعد (موصى به)NPX المحلي
4
حفظ وإعادة التشغيل
احفظ ملف التكوين وأعد تشغيل Cursor.
تحقق من الاتصال من خلال سؤال المساعد الذكي عن بيانات Dodo Payments الخاصة بك.
متغيرات البيئة
قم بتكوين سلوك خادم MCP باستخدام متغيرات البيئة.| المتغير | الوصف | مطلوب |
|---|---|---|
DODO_PAYMENTS_API_KEY | مفتاح API الخاص بـ Dodo Payments | نعم |
DODO_PAYMENTS_WEBHOOK_KEY | مفتاح توقيع webhook الخاص بك | لا |
DODO_PAYMENTS_ENVIRONMENT | تعيين إلى live_mode للإنتاج | لا |
التشغيل عن بُعد
قم بنشر خادم MCP كخادم HTTP عن بُعد للعملاء المستندين إلى الويب أو سير العمل الوكيلة.تكوين الخادم عن بُعد
بمجرد نشره، يمكن للعملاء الاتصال باستخدام عنوان URL للخادم:رؤوس التفويض
يقبل الخادم عن بُعد المصادقة عبر الرؤوس التالية:| الرأس | الوصف |
|---|---|
Authorization | مصادقة رمز Bearer |
x-dodo-payments-api-key | رأس مفتاح API مباشر |
قدرات العميل
تتمتع عملاء MCP المختلفة بمستويات متفاوتة من الدعم لمواصفات MCP. يمكن للخادم ضبط مخططات الأدوات تلقائيًا للتغلب على هذه القيود.إعدادات العميل المتاحة
| العميل | الوصف |
|---|---|
infer | اكتشاف العميل تلقائيًا (افتراضي) |
cursor | محرر Cursor |
claude | Claude AI على الويب أو سطح المكتب |
claude-code | واجهة سطر أوامر Claude Code |
openai-agents | منصة وكلاء OpenAI |
تكوين القدرات اليدوية
بالنسبة للعملاء غير المدرجين أعلاه، قم بتكوين القدرات يدويًا:top-level-unions- دعم لأنواع الاتحاد على المستوى الأعلىvalid-json- تحليل صحيح لوسائط سلسلة JSONrefs- دعم لمؤشرات $ref في المخططاتunions- دعم لأنواع الاتحاد (anyOf)formats- دعم للتحقق من التنسيقاتtool-name-length=N- الحد الأقصى لطول اسم الأداة
تصفية الأدوات
تحكم في العمليات التي يتم عرضها لوكيل الذكاء الاصطناعي الخاص بك لتحسين الأداء والحفاظ على الأمان.تصفية حسب نوع العملية
تقييد الوصول إلى عمليات القراءة فقط أو الكتابة.تصفية حسب المورد
تحديد الأدوات لموارد API معينة.تضمين أو استبعاد أدوات معينة
تعديل الأدوات الفردية المتاحة.دمج الفلاتر
تطبيق فلاتر متعددة في وقت واحد للتحكم الدقيق.تصفية معلمات استعلام URL (الخادم عن بُعد)
عند استخدام الخادم عن بُعد، قم بتطبيق الفلاتر عبر معلمات استعلام URL:وضع الأدوات الديناميكية
بالنسبة لـ APIs الكبيرة، يمكن أن يؤدي تحميل جميع الأدوات دفعة واحدة إلى إرباك نافذة سياق الذكاء الاصطناعي. يوفر وضع الأدوات الديناميكية بديلاً أكثر كفاءة.list_api_endpoints- يكتشف الطرق المتاحة مع تصفية اختياريةget_api_endpoint_schema- يحصل على مخطط مفصل لطريقة معينةinvoke_api_endpoint- ينفذ أي طريقة مع المعلمات المناسبة
تكون الأدوات الديناميكية مفعلة تلقائيًا لـ APIs التي تحتوي على أكثر من 50 طريقة. يمكنك تجاوز ذلك باستخدام
--tools=all لتضمين جميع الأدوات.الاستخدام المتقدم
التكامل البرمجي
قم ببناء خوادم MCP مخصصة أو قم بتمديد الخادم الحالي برمجيًا.تطوير أدوات مخصصة
قم بتمديد خادم MCP بأدواتك ومنطق الأعمال الخاص بك.أفضل ممارسات الأمان
احمِ بيانات اعتماد API الخاصة بك وحافظ على تكاملات آمنة.إدارة مفاتيح API
إدارة مفاتيح API
لا تقم أبدًا بالتزام بيانات الاعتماد في التحكم في الإصدارقم بتخزين مفاتيح API في متغيرات البيئة أو أنظمة إدارة الأسرار الآمنة.قم بتدوير المفاتيح بانتظامقم بإنشاء مفاتيح API جديدة بشكل دوري وألغِ صلاحية القديمة من خلال لوحة معلومات Dodo Payments الخاصة بك.استخدم مفاتيح الاختبار للتطويراستخدم دائمًا مفاتيح API في وضع الاختبار أثناء التطوير لتجنب التأثير على بيانات الإنتاج.
التحكم في الوصول
التحكم في الوصول
تطبيق تصفية الأدوات في الإنتاجقم بتقييد العمليات المعرضة فقط لما يحتاجه مساعد الذكاء الاصطناعي الخاص بك.تنفيذ المصادقة للخوادم عن بُعدعند النشر عن بُعد، تطلب دائمًا المصادقة عبر رأس
Authorization أو رأس x-dodo-payments-api-key.مراقبة استخدام APIتتبع نشاط خادم MCP من خلال لوحة معلومات Dodo Payments الخاصة بك وقم بإعداد تنبيهات للأنماط غير العادية.أمان الشبكة
أمان الشبكة
استخدم HTTPS للخوادم عن بُعدقم دائمًا بنشر خوادم MCP عن بُعد خلف نقاط نهاية HTTPS.تنفيذ تحديد المعدلاحمِ من إساءة الاستخدام من خلال تنفيذ حدود المعدل على كل من خادم MCP ومستويات API.تقييد الوصول إلى الشبكةقم بتكوين قواعد جدار الحماية لتقييد العملاء الذين يمكنهم الاتصال بخادم MCP الخاص بك.
استكشاف الأخطاء وإصلاحها
مشكلات الاتصال
مشكلات الاتصال
تحقق من مفتاح API الخاص بكتأكد من تعيين مفتاح API الخاص بك بشكل صحيح وأن لديه الأذونات اللازمة.تحقق من اتصال الشبكة الخاص بكتحقق من أنك تستطيع الوصول إلى نقاط نهاية Dodo Payments API.راجع سجلات العميلقم بتمكين تسجيل مفصل في عميل MCP الخاص بك لتشخيص مشكلات الاتصال.
أخطاء المصادقة
أخطاء المصادقة
تأكيد بيئة مفتاح APIتأكد من أنك تستخدم مفاتيح الاختبار مع نقاط نهاية الاختبار ومفاتيح مباشرة مع نقاط نهاية الإنتاج.تحقق من متغير البيئةتحقق من أن
DODO_PAYMENTS_ENVIRONMENT تم تعيينه بشكل صحيح (live_mode للإنتاج).إعادة إنشاء بيانات الاعتمادإذا استمرت المشكلات، قم بإنشاء مفتاح API جديد من خلال لوحة المعلومات الخاصة بك.فشل تنفيذ الأداة
فشل تنفيذ الأداة
تحقق من معلمات الإدخالتأكد من أن المساعد الذكي يقدم معلمات بتنسيق صحيح لكل أداة.راجع رسائل الخطأتحقق من استجابة الخطأ من API للحصول على إرشادات محددة حول ما حدث خطأ.اختبر مع API مباشرةتحقق من أن العملية تعمل عند استدعاء Dodo Payments API مباشرة عبر curl أو Postman.
مشكلات توافق العميل
مشكلات توافق العميل
جرّب إعداد عميل مختلفإذا لم تعمل الأدوات بشكل صحيح، حاول تحديد عميلك بشكل صريح:تحقق من دعم القدراتبعض العملاء لا يدعمون جميع ميزات مخطط JSON. استخدم
--describe-capabilities لفهم ما هو مدعوم.