نظرة عامة
بروتوكول سياق النموذج (MCP) هو معيار مفتوح يمكّن تطبيقات الذكاء الاصطناعي من الاتصال بشكل آمن بمصادر البيانات الخارجية وواجهات برمجة التطبيقات. يوفر خادم مدفوعات دودي للمساعدين الذكيين مثل كلود، وكورسر، وغيرهم من العملاء المتوافقين مع MCP وصولاً منظمًا إلى بنية الدفع الخاصة بك. خادم Dodo Payments MCP مبني باستخدام Stainless ويستخدم بنية وضع الكود، التي تمكن وكلاء الذكاء الاصطناعي من كتابة وتنفيذ كود TypeScript ضد Dodo Payments SDK في بيئة معزولة.القدرات الرئيسية
- عمليات الدفع: إنشاء واسترجاع وإدارة المدفوعات والمبالغ المستردة
- إدارة الاشتراكات: التعامل مع الفوترة المتكررة، والترقيات، والإلغاءات
- إدارة العملاء: إدارة بيانات العملاء والوصول إلى البوابة
- كتالوج المنتجات: إنشاء وتحديث المنتجات والأسعار والخصومات
- إدارة التراخيص: تفعيل والتحقق وإدارة تراخيص البرمجيات
- الفوترة بناءً على الاستخدام: تتبع والفوترة للاستخدام المقاس
كيف يعمل وضع الكود
يستخدم خادم Dodo Payments MCP وضع الكود، مما يوفر لوكيل الذكاء الاصطناعي لديك أداتين قويتين:- أداة بحث الوثائق: استعلام عن الوثائق المتعلقة بـ Dodo Payments API وSDK لفهم العمليات والمعلمات المتاحة
- أداة تنفيذ الكود: كتابة كود TypeScript ضد SDK الذي يتم تنفيذه في بيئة آمنة معزولة بدون الوصول إلى الويب أو نظام الملفات
دليلك إلى دودي MCP
بالإضافة إلى خادم دودي للدفع MCP (لتنفيذ عمليات API)، نقدم دليل دودي MCP - خادم بحث دلالي يمنح مساعدي الذكاء الاصطناعي الوصول الفوري إلى وثائق دودي للدفع وقاعدة المعرفة.مبني باستخدام ContextMCP.ai: يتم تشغيل دليل دودي MCP بواسطة ContextMCP، مما يتيح بحثًا دلاليًا سريعًا عبر وثائقنا باستخدام تضمينات المتجهات.
ما هو دليل دودي MCP؟
دليل دودي MCP هو خادم MCP عن بُعد يوفر:- بحث دلالي في الوثائق: ابحث عن الوثائق ذات الصلة باستخدام استفسارات باللغة الطبيعية
- إجابات سياقية: يحصل مساعدو الذكاء الاصطناعي على معلومات دقيقة ومحدثة حول دودي للدفع
- عدم الحاجة للإعداد: لا حاجة لمفاتيح API أو تثبيت محلي - فقط اتصل وابدأ في الاستفسار
إعداد سريع
اتصل بدليل دودي MCP في عميل الذكاء الاصطناعي الخاص بك:- Cursor
- Claude Desktop
- Windsurf
- Claude Code
أضف إلى
~/.cursor/mcp.json:يتطلب Node.js 18 أو أعلى. حزمة
mcp-remote تتعامل مع الاتصال بخادم MCP البعيد.استخدام كلا خادمي MCP معًا
لأفضل تجربة تطوير مدعومة بالذكاء الاصطناعي، نوصي باستخدام كلا خادمي MCP:| الخادم | الغرض | حالة الاستخدام |
|---|---|---|
| دليل دودي MCP | بحث الوثائق | ”كيف أتعامل مع webhooks؟”، “ما طرق الدفع المدعومة؟“ |
| دودي للدفع MCP | عمليات API | إنشاء المدفوعات، إدارة الاشتراكات، التعامل مع المبالغ المستردة |
استكشاف أخطاء دليل MCP
إذا واجهت مشاكل في الاتصال:- مسح ذاكرة التخزين المؤقت لمصادقة MCP:
rm -rf ~/.mcp-auth - إعادة تشغيل تطبيق العميل الخاص بك
- تحقق من سجلات العميل للرسائل الخطأ
- تحقق من إصدار Node.js: يتطلب Node.js 18+
خادم دليل MCP
الوصول إلى صفحة تكوين دليل دودي MCP
التثبيت
اختر طريقة التثبيت التي تناسب سير العمل الخاص بك.خادم MCP عن بُعد (موصى به)
الوصول إلى خادم MCP المستضاف دون أي إعداد أو تثبيت محلي. هذه هي أسرع طريقة للبدء.الوصول إلى الخادم عن بُعد
انتقل إلى https://mcp.dodopayments.com في متصفحك.
تكوين عميل MCP الخاص بك
انسخ تكوين JSON المقدم لعميلك المحدد. بالنسبة لـ Cursor أو Claude Desktop، أضف هذا إلى إعدادات MCP الخاصة بك:
المصادقة والتكوين
ستطلب منك عملية OAuth:
- إدخال مفتاح API لدودي للدفع
- اختيار بيئتك (اختبار أو مباشر)
- اختيار نوع عميل MCP الخاص بك
حزمة NPM
قم بتثبيت وتشغيل خادم MCP محليًا باستخدام NPM.- NPX (بدون تثبيت)
- تكوين عميل MCP
دوكر
قم بتشغيل خادم MCP في بيئة محوسبة لضمان نشر متسق.صور دوكر متاحة على GitHub Container Registry.
تكوين العميل
قم بتكوين خادم دودي للدفع MCP في عميل الذكاء الاصطناعي المفضل لديك.- Cursor
- Claude Desktop
- Claude Code
- VS Code
- Cline (VS Code)
- Zed
- عملاء آخرون
قم بإعداد خادم دودي للدفع MCP في Cursor لتمكين الوصول التفاعلي إلى بيانات المدفوعات الخاصة بك.تثبيت بنقرة واحدةاستخدم الزر أدناه لتثبيت خادم MCP مباشرة في Cursor:[
](https://cursor.com/en-US/install-mcp?name=dodopayments-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRvZG9wYXltZW50cy1tY3AiXSwiZW52Ijp7IkRPRE9fUEFZTUVOVFNfQVBJX0tFWSI6IlNldCB5b3VyIERPRE9fUEFZTUVOVFNfQVBJX0tFWSBoZXJlLiIsIkRPRE9fUEFZTUVOVFNfV0VCSE9PS19LRVkiOiJTZXQgeW91ciBET0RPX1BBWU1FTlRTX1dFQkhPT0tfS0VZIGhlcmUuIn19)بعد النقر، قم بتعيين متغيرات البيئة الخاصة بك في
mcp.json عبر إعدادات Cursor > الأدوات و MCP > خادم MCP جديد.التكوين اليدويفتح إعدادات Cursor
انتقل إلى إعدادات Cursor > الميزات > بروتوكول سياق النموذج أو اضغط على
Cmd/Ctrl + Shift + P وابحث عن “إعدادات MCP”.متغيرات البيئة
قم بتكوين سلوك خادم MCP باستخدام متغيرات البيئة.| المتغير | الوصف | مطلوب |
|---|---|---|
DODO_PAYMENTS_API_KEY | مفتاح API لمدفوعات Dodo الخاصة بك | نعم |
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 CLI |
openai-agents | منصة وكلاء OpenAI |
تكوين القدرات اليدوي
بالنسبة للعملاء غير المدرجين أعلاه، قم بتكوين القدرات يدويًا:top-level-unions- دعم لأنواع الاتحاد على المستوى الأعلىvalid-json- تصحيح تحليل وسيط JSONrefs- دعم لمؤشرات $ref في المخططاتunions- دعم لأنواع الاتحاد (anyOf)formats- دعم للتحقق من التنسيقاتtool-name-length=N- الحد الأقصى لطول اسم الأداة
تصفية الأدوات
تحكم في العمليات التي يتم عرضها لمساعد الذكاء الاصطناعي الخاص بك لتحسين الأداء والحفاظ على الأمان.تصفية حسب نوع العملية
تقييد الوصول إلى عمليات القراءة فقط أو الكتابة.تصفية حسب المورد
تحديد الأدوات لموارد API معينة.تضمين أو استبعاد أدوات معينة
تعديل الأدوات الفردية المتاحة.دمج الفلاتر
تطبيق فلاتر متعددة في وقت واحد للتحكم الدقيق.تصفية معلمات استعلام URL (الخادم عن بُعد)
عند استخدام الخادم عن بُعد، قم بتطبيق الفلاتر عبر معلمات استعلام URL:وضع الأدوات الديناميكية
بالنسبة لواجهات برمجة التطبيقات الكبيرة، يمكن أن يؤدي تحميل جميع الأدوات دفعة واحدة إلى إرباك نافذة سياق الذكاء الاصطناعي. يوفر وضع الأدوات الديناميكية بديلاً أكثر كفاءة.list_api_endpoints- يكتشف الطرق المتاحة مع تصفية اختياريةget_api_endpoint_schema- يحصل على مخطط تفصيلي لطريقة معينةinvoke_api_endpoint- ينفذ أي طريقة مع المعلمات المناسبة
تكون الأدوات الديناميكية مفعلة تلقائيًا لواجهات برمجة التطبيقات التي تحتوي على أكثر من 50 طريقة. يمكنك تجاوز ذلك باستخدام
--tools=all لتضمين جميع الأدوات.الاستخدام المتقدم
التكامل البرمجي
قم ببناء خوادم MCP مخصصة أو قم بتمديد الخادم الحالي برمجيًا.تطوير أدوات مخصصة
قم بتمديد خادم MCP بأدواتك ومنطق الأعمال الخاصة بك.أفضل ممارسات الأمان
احمِ بيانات اعتماد API الخاصة بك وحافظ على تكاملات آمنة.إدارة مفاتيح API
إدارة مفاتيح API
لا تقم أبدًا بالتزام بيانات الاعتماد في التحكم في الإصدارقم بتخزين مفاتيح API في متغيرات البيئة أو أنظمة إدارة الأسرار الآمنة.قم بتدوير المفاتيح بانتظامقم بإنشاء مفاتيح API جديدة بشكل دوري وألغِ صلاحية القديمة من خلال لوحة معلومات دودي للدفع الخاصة بك.استخدم مفاتيح الاختبار للتطويراستخدم دائمًا مفاتيح API في وضع الاختبار أثناء التطوير لتجنب التأثير على بيانات الإنتاج.
التحكم في الوصول
التحكم في الوصول
تطبيق تصفية الأدوات في الإنتاجقم بتقييد العمليات المعرضة فقط لما يحتاجه مساعد الذكاء الاصطناعي الخاص بك.تنفيذ المصادقة للخوادم عن بُعدعند النشر عن بُعد، يتطلب دائمًا المصادقة عبر رأس
Authorization أو رأس x-dodo-payments-api-key.مراقبة استخدام APIتتبع نشاط خادم MCP من خلال لوحة معلومات دودي للدفع الخاصة بك وقم بإعداد تنبيهات للأنماط غير العادية.أمان الشبكة
أمان الشبكة
استخدم HTTPS للخوادم عن بُعدقم دائمًا بنشر خوادم MCP عن بُعد خلف نقاط نهاية HTTPS.تنفيذ تحديد المعدلاحمِ من إساءة الاستخدام من خلال تنفيذ حدود المعدل على كل من خادم MCP وواجهات برمجة التطبيقات.تقييد الوصول إلى الشبكةقم بتكوين قواعد جدار الحماية لتقييد العملاء الذين يمكنهم الاتصال بخادم MCP الخاص بك.
استكشاف الأخطاء وإصلاحها
مشاكل الاتصال
مشاكل الاتصال
تحقق من مفتاح API الخاص بكتأكد من تعيين مفتاح API الخاص بك بشكل صحيح وأن لديه الأذونات اللازمة.تحقق من اتصال الشبكة الخاص بكتحقق من أنك تستطيع الوصول إلى نقاط نهاية واجهة برمجة التطبيقات لدودي للدفع.راجع سجلات العميلقم بتمكين تسجيل الدخول التفصيلي في عميل MCP الخاص بك لتشخيص مشاكل الاتصال.
أخطاء المصادقة
أخطاء المصادقة
تأكيد بيئة مفتاح APIتأكد من أنك تستخدم مفاتيح الاختبار مع نقاط نهاية الاختبار ومفاتيح مباشرة مع نقاط نهاية الإنتاج.تحقق من متغير البيئةتحقق من أن
DODO_PAYMENTS_ENVIRONMENT تم تعيينه بشكل صحيح (live_mode للإنتاج).إعادة إنشاء بيانات الاعتمادإذا استمرت المشاكل، قم بإنشاء مفتاح API جديد من خلال لوحة المعلومات الخاصة بك.فشل تنفيذ الأداة
فشل تنفيذ الأداة
تحقق من معلمات الإدخالتأكد من أن مساعد الذكاء الاصطناعي يقدم معلمات بتنسيق صحيح لكل أداة.راجع رسائل الخطأتحقق من استجابة الخطأ من واجهة برمجة التطبيقات للحصول على إرشادات محددة حول ما حدث خطأ.اختبر مع واجهة برمجة التطبيقات مباشرةتحقق من أن العملية تعمل عند استدعاء واجهة برمجة التطبيقات لدودي للدفع مباشرة عبر curl أو Postman.
مشاكل توافق العميل
مشاكل توافق العميل
جرب إعداد عميل مختلفإذا لم تعمل الأدوات بشكل صحيح، جرب تحديد عميلك بشكل صريح:تحقق من دعم القدراتبعض العملاء لا يدعمون جميع ميزات مخطط JSON. استخدم
--describe-capabilities لفهم ما هو مدعوم.