Documentation Index
Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
Use this file to discover all available pages before exploring further.
Overview
The Model Context Protocol (MCP) is an open standard that enables AI applications to securely connect to external data sources and APIs. The Dodo Payments MCP Server provides AI assistants like Claude, Cursor, and other MCP-compatible clients with structured access to your payment infrastructure. يستخدم خادم MCP الخاص بـ Dodo Payments بنية وضع الكود. بدلًا من الكشف عن مئات الأدوات الفردية لكل نقطة نهاية في واجهة البرمجة، يتيح وضع الكود لوكلاء الذكاء الاصطناعي كتابة وتنفيذ كود TypeScript باستخدام مجموعة تطوير البرامج الخاصة بـ Dodo Payments في بيئة معزولة.Key capabilities
- Payment Operations: Create, retrieve, and manage payments and refunds
- Subscription Management: Handle recurring billing, upgrades, and cancellations
- Customer Administration: Manage customer data and portal access
- Product Catalog: Create and update products, pricing, and discounts
- License Management: Activate, validate, and manage software licenses
- Usage-Based Billing: Track and bill for metered usage
How Code Mode Works
يوفر خادم MCP الخاص بـ Dodo Payments لوكيل الذكاء الاصطناعي الخاص بك أداتين فقط:- أداة البحث في الوثائق: تستعلم عن التوثيق الخاص بواجهة برمجة تطبيقات Dodo Payments وSDK لفهم العمليات والمعاملات المتاحة.
- أداة تنفيذ الكود: تكتب كود TypeScript ضد SDK ويتم تنفيذه في بيئة رملية آمنة.
الإعداد السريع
اتصل بخادم MCP الخاص بـ Dodo Payments في عميل الذكاء الاصطناعي الخاص بك:- Agent Plugin (recommended)
- Cursor
- Claude Desktop
- Windsurf
- Claude Code
يُثبِّت Dodo Agent Plugin كلاً من خوادم MCP وجميع المهارات الثمانية في خطوة واحدة لـ Claude Code وCodex CLI وCursor وOpenCode. انظر دليل وكلاء الذكاء الاصطناعي لأوامر التثبيت الخاصة بكل وكيل.إذا لم يكن وكيلك في تلك القائمة، استخدم علامات التبويب أدناه لتكوين خادم MCP مباشرةً.
يتطلب Node.js 18 أو أعلى. يستخدم الخادم عن بُعد OAuth للمصادقة — سيُطلب منك إدخال مفتاح API الخاص بك واختيار بيئتك في الاتصال الأول.
Dodo Knowledge MCP
بالإضافة إلى خادم Dodo Payments MCP (لتنفيذ عمليات API)، نقدم Dodo Knowledge MCP — خادم بحث دلالي يتيح لمساعدي الذكاء الاصطناعي الوصول الفوري إلى وثائق Dodo Payments وقاعدة المعرفة.تم إنشاؤه باستخدام ContextMCP.ai: يتم تشغيل Dodo Knowledge MCP بواسطة ContextMCP، مما يمكّن البحث الدلالي السريع عبر الوثائق لدينا باستخدام تضمينات المتجهات.
ما هو Dodo Knowledge MCP؟
Dodo Knowledge MCP هو خادم MCP بعيد يوفر:- بحث وثائقي دلالي: العثور على الوثائق ذات الصلة باستخدام استفسارات اللغة الطبيعية.
- إجابات سياقية: يحصل مساعدو الذكاء الاصطناعي على معلومات دقيقة ومحدثة حول Dodo Payments.
- بدون إعداد: لا حاجة إلى مفاتيح API أو تثبيت محلي — فقط قم بالاتصال وابدأ الاستفسار.
إعداد سريع
قم بالاتصال بـ Dodo Knowledge MCP في عميل الذكاء الاصطناعي الخاص بك:- Cursor
- Claude Desktop
- Windsurf
- Claude Code
أضف إلى
~/.cursor/mcp.json:يتطلب Node.js 18 أو أعلى. تتولى الحزمة
mcp-remote الاتصال بالخادم البعيد MCP.استخدام كلا خادمي MCP معًا
لأفضل تجربة تطوير مدعومة بالذكاء الاصطناعي، نوصي باستخدام خادمي MCP معًا:| خادم | الغرض | حالة الاستخدام |
|---|---|---|
| Dodo Knowledge MCP | بحث في الوثائق | ”كيف يمكنني التعامل مع الويب هوكس؟”، “ما طرق الدفع المدعومة؟“ |
| Dodo Payments MCP | عمليات API | إنشاء مدفوعات، إدارة الاشتراكات، معالجة الاسترداد |
استكشاف الأخطاء في Knowledge MCP
إذا واجهت مشاكل في الاتصال:- مسح ذاكرة التخزين المؤقت للمصادقة الخاصة بـ MCP:
rm -rf ~/.mcp-auth - أعد تشغيل تطبيق العميل الخاص بك
- تحقق من سجلات العميل للرسائل الخطأ
- تحقق من إصدار Node.js: يتطلب Node.js 18+
Knowledge MCP Server
الوصول إلى صفحة إعدادات Dodo Knowledge MCP
التثبيت
اختر طريقة التثبيت التي تناسب سير العمل الخاص بك.خادم MCP عن بعد (موصى به)
الوصول إلى الخادم المستضاف بدون أي إعداد محلي أو تثبيت. هذه هي أسرع طريقة لبدء الاستخدام.Access the remote server
انتقل إلى https://mcp.dodopayments.com في متصفحك.
Configure your MCP client
انسخ تكوين JSON المقدم للعميل الخاص بك. لكل من Cursor أو Claude Desktop، أضفه إلى إعدادات MCP الخاصة بك:
Authenticate and configure
ستطلب منك عملية تدفق OAuth أن:
- تدخل مفتاح API الخاص بك لـ Dodo Payments
- تختار بيئتك (اختبار أو مباشر)
- تختار نوع عميل MCP الخاص بك
حزمة NPM
قم بتثبيت وتشغيل خادم MCP محليًا باستخدام NPM.- NPX (No Installation)
- MCP Client Configuration
Docker
قم بتشغيل خادم MCP في بيئة مخصصة للتوزيع المتسق.صور Docker متاحة على GitHub Container Registry.
إعدادات العميل
قم بتكوين خادم Dodo Payments MCP في عميل الذكاء الاصطناعي المفضل لديك.- Cursor
- Claude Desktop
- Claude Code
- VS Code
- Cline (VS Code)
- Zed
- Other Clients
قم بإعداد خادم Dodo Payments MCP في Cursor لتمكين الوصول المحادثي إلى بيانات المدفوعات الخاصة بك.التثبيت بنقرة واحدةاستخدم الزر أدناه لتثبيت خادم MCP مباشرةً في Cursor:[
](https://cursor.com/en-US/install-mcp?name=dodopayments-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRvZG9wYXltZW50cy1tY3AiXSwiZW52Ijp7IkRPRE9fUEFZTUVOVFNfQVBJX0tFWSI6IlNldCB5b3VyIERPRE9fUEFZTUVOVFNfQVBJX0tFWSBoZXJlLiIsIkRPRE9fUEFZTUVOVFNfV0VCSE9PS19LRVkiOiJTZXQgeW91ciBET0RPX1BBWU1FTlRTX1dFQkhPT0tfS0VZIGhlcmUuIn19)بعد الضغط، قم بتعيين متغيرات البيئة في
mcp.json عبر إعدادات Cursor > أدوات & MCP > خادم MCP جديد.التكوين اليدويOpen Cursor settings
انتقل إلى إعدادات Cursor > الخصائص > بروتوكول سياق النموذج أو اضغط
Cmd/Ctrl + Shift + P وابحث عن “إعدادات MCP”.متغيرات البيئة
قم بتكوين سلوك خادم MCP باستخدام متغيرات البيئة.| المتغير | الوصف | مطلوب |
|---|---|---|
DODO_PAYMENTS_API_KEY | مفتاح API الخاص بك لـ Dodo Payments | نعم |
DODO_PAYMENTS_WEBHOOK_KEY | مفتاح توقيع الويب هوك الخاص بك | لا |
DODO_PAYMENTS_ENVIRONMENT | اضبط على live_mode للإنتاج | لا |
التشغيل عن بُعد
قم بنشر خادم MCP كخادم HTTP بعيد للعمليات القائمة على الويب أو تدفقات العمل الوكيلة.تكوين الخادم البعيد
بعد النشر، يمكن للعملاء الاتصال باستخدام عنوان URL للخادم:رؤوس التحقق
يقبل الخادم البعيد المصادقة عبر الرؤوس التالية:| الرأس | الوصف |
|---|---|
Authorization | مصادقة رمز Bearer |
x-dodo-payments-api-key | رأس مفتاح API المباشر |
ممارسات الأمان المثلى
يوفر Code Mode أمانًا داخليًا من خلال تنفيذ الكود في بيئة معزولة وحقن مفاتيح API على جانب الخادم. اتبع هذه الممارسات المثلى الإضافية لحماية بيانات اعتمادك.API Key Management
API Key Management
لا تلتزم مطلقًا ببيانات الاعتماد في التحكم في الإصدارقم بتخزين مفاتيح API في متغيرات البيئة أو أنظمة إدارة الأسرار الآمنة.قم بتدوير المفاتيح بانتظامقم بإنشاء مفاتيح API جديدة دوريًا وألغِ المفاتيح القديمة عبر لوحة معلومات Dodo Payments الخاصة بك.استخدم مفاتيح الاختبار للتطويراستخدم دائمًا مفاتيح وضع الاختبار أثناء التطوير لتجنب التأثير على بيانات الإنتاج.
Access Control
Access Control
نفذ المصادقة للخوادم البعيدةعند النشر عن بُعد، يجب دائمًا المطالبة بالمصادقة عبر الرأس
Authorization أو الرأس x-dodo-payments-api-key.مراقبة استخدام APIتتبع نشاط خادم MCP عبر لوحة معلومات Dodo Payments الخاصة بك وقم بإعداد تنبيهات لأنماط غير عادية.Network Security
Network Security
استخدم HTTPS للخوادم البعيدةقم دائمًا بنشر خوادم MCP البعيدة خلف نقاط نهاية HTTPS.تنفيذ القيود الزمنيةاحمَ ضد الإساءة من خلال تنفيذ قيود السرعة على كل من خادم MCP ومستويات API.تقييد الوصول إلى الشبكةقم بتكوين قواعد الجدار الناري لتحديد العملاء الذين يمكنهم الاتصال بخادم MCP الخاص بك.
استكشاف الأخطاء وإصلاحها
Connection issues
Connection issues
تحقق من صحة مفتاح API الخاص بكتأكد من أن مفتاح API الخاص بك مضبوط بشكل صحيح ولديه الأذونات اللازمة.تحقق من اتصال الشبكة الخاص بكتأكد من إمكان وصولك إلى نقاط نهاية Dodo Payments API.راجع سجلات العميلقم بتمكين تسجيل الأحداث المفصل في عميل MCP الخاص بك لتشخيص مشاكل الاتصال.
Authentication errors
Authentication errors
تحقق من بيئة مفتاح APIتأكد من أنك تستخدم مفاتيح الاختبار مع نقاط نهاية الاختبار والمفاتيح المباشرة مع نقاط نهاية الإنتاج.تحقق من متغير البيئةتأكد من تعيين
DODO_PAYMENTS_ENVIRONMENT بشكل صحيح (live_mode للإنتاج).إعادة توليد بيانات الاعتمادإذا استمرت المشاكل، قم بإنشاء مفتاح API جديد عبر لوحة التحكم الخاصة بك.Tool execution failures
Tool execution failures
التحقق من صحة معلمات المدخلاتتأكد من أن مساعد الذكاء الاصطناعي يوفر المعلمات بصيغة صحيحة لكل أداة.مراجعة رسائل الخطأتحقق من استجابة الخطأ من API للحصول على إرشادات محددة حول ما حدث بشكل خاطئ.الاختبار مع API مباشرةتأكد من عمل العملية عند الاتصال بـ Dodo Payments API مباشرة عبر curl أو Postman.
لماذا وضع الشيفرة
غالبًا ما تعاني تطبيقات MCP التقليدية من “تكاثر الأدوات” حيث يتم كشف كل نقطة نهاية API كأداة منفصلة. يعد وضع الشيفرة نهجًا متفوقًا لعدة أسباب:LLMs أفضل في كتابة الشيفرة من استدعاء الأدوات
تم تدريب LLMs على ملايين الأسطر من الشيفرة الفعلية، مما يجعلها تتمتع بمهارة طبيعية في كتابة البرامج. في المقابل، يعتمد استدعاء الأدوات غالبًا على أمثلة اصطناعية.“جعل LLM يؤدي مهامًا باستخدام استدعاء الأدوات يشبه وضع شكسبير في فصل دراسي لمدة شهر لدراسة الماندرين ثم طلب كتابته لمسرحية بها.” — Cloudflare
يقضي على تضخم نافذة السياق
في النهج التقليدي، يستهلك تعريف كل أداة الرموز قبل أن تبدأ المحادثة حتى. يمكن أن يؤدي كشف أكثر من 50 أداة بسهولة إلى استنزاف 55K–100K+ رمز. وجد Anthropic أن تعريفات الأدوات يمكن أن تستهلك حتى 134K رمز قبل التحسين. مع وضع الشيفرة، يتم تحميل تعريفي الأدوات فقط (~1K رمز). يقوم الوكيل بالبحث عن الوثائق المطلوبة حسب الطلب. حافظت أداة بحث الأدوات من Anthropic على 95% من نافذة السياق، مما قلل من التحميل من 77K إلى 8.7K رمز.يقلل من التأخير عبر التنظيم البرمجي
يتطلب استدعاء الأدوات التقليدي جولة كاملة للاستنتاج مع النموذج لكل عملية واحدة. إذا كانت المهمة تتطلب 20 مكالمة API، فهذا يعني 20 جولة متكررة. في وضع الشيفرة، يكتب الوكيل برنامجًا واحدًا ينفذ جميع المكالمات ويعود بالنتيجة النهائية فقط. لاحظ Anthropic انخفاضًا بنسبة 37% في الرموز وتحسينًا في الدقة (تحسن استرجاع المعرفة من 25.6% إلى 28.5%) باستخدام هذا النهج البرمجي.أكثر أمانًا بالتصميم
يوفر وضع الشيفرة فوائد أمان بطبيعة الحال:- لا مفاتيح API في المعلمات: يتم حقن مفاتيح API على جانب الخادم ولا يتم الكشف عنها في المعلمات المرسلة إلى نموذج اللغة الكبير.
- بيئة معزولة: يتم تشغيل الشيفرة في بيئة آمنة دون إمكانية الوصول إلى الشبكة أو نظام الملفات المحلي.
- SDK محكوم: لا يمكن للوكيل الوصول إلا إلى أساليب SDK المصرح بها.
يتكيف مع أي حجم API
عندما ينمو واجهة برمجة التطبيقات، تتدهور أداء MCP التقليدي لأنه يجب تحميل المزيد من الأدوات في السياق. يبقى وضع الشيفرة ثابتًا بأداة 2 بغض النظر عن حجم واجهة برمجة التطبيقات. نجحت Cloudflare في طي أكثر من 2500 نقطة نهاية API في أداة 2 وحوالي 1000 رمز من السياق.لمزيد من التفاصيل حول فوائد هذا الهيكل، ارجع إلى مدونات الهندسة من Anthropic وCloudflare، وبرنامج استدعاء الأدوات البرمجية من Claude.
الموارد
API Reference
استكشف وثائق Dodo Payments API الكاملة
MCP Protocol
تعلم المزيد عن معيار بروتوكول سياق النموذج
GitHub Repository
شاهد كود المصدر لخادم MCP وساهم
NPM Package
قم بتثبيت خادم MCP من NPM