الانتقال إلى المحتوى الرئيسي

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 لوكيل الذكاء الاصطناعي الخاص بك أداتين فقط:
  1. أداة البحث في الوثائق: تستعلم عن التوثيق الخاص بواجهة برمجة تطبيقات Dodo Payments وSDK لفهم العمليات والمعاملات المتاحة.
  2. أداة تنفيذ الكود: تكتب كود TypeScript ضد SDK ويتم تنفيذه في بيئة رملية آمنة.
تتيح هذه البنية للوكالات تنفيذ عمليات معقدة متعددة الخطوات في استدعاء واحد. على سبيل المثال، يمكن للوكيل سرد كل الاشتراكات النشطة، تصفيتها بناءً على معايير محددة، وتطبيق خصم على كل منها—كل ذلك داخل نص واحد.
باستخدام وضع الكود، يمكن للوكلاء ربط استدعاءات API متعددة، ومعالجة المنطق الشرطي، وإجراء الحسابات دون الحاجة إلى جولات متعددة مع نموذج اللغة الكبير.

الإعداد السريع

اتصل بخادم MCP الخاص بـ Dodo Payments في عميل الذكاء الاصطناعي الخاص بك:
يتطلب 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/mcp.json:
{
  "mcpServers": {
    "dodo-knowledge": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://knowledge.dodopayments.com/mcp"]
    }
  }
}
يتطلب Node.js 18 أو أعلى. تتولى الحزمة mcp-remote الاتصال بالخادم البعيد MCP.

استخدام كلا خادمي MCP معًا

لأفضل تجربة تطوير مدعومة بالذكاء الاصطناعي، نوصي باستخدام خادمي MCP معًا:
خادمالغرضحالة الاستخدام
Dodo Knowledge MCPبحث في الوثائق”كيف يمكنني التعامل مع الويب هوكس؟”، “ما طرق الدفع المدعومة؟“
Dodo Payments MCPعمليات APIإنشاء مدفوعات، إدارة الاشتراكات، معالجة الاسترداد
{
  "mcpServers": {
    "dodo-knowledge": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://knowledge.dodopayments.com/mcp"]
    },
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
مع تكوين كلا الخادمين، يمكن لمساعد الذكاء الاصطناعي البحث في الوثائق لفهم كيفية تنفيذ ميزة، ثم تنفيذ مكالمات API الفعلية — جميعها في محادثة واحدة.

استكشاف الأخطاء في Knowledge MCP

إذا واجهت مشاكل في الاتصال:
  1. مسح ذاكرة التخزين المؤقت للمصادقة الخاصة بـ MCP: rm -rf ~/.mcp-auth
  2. أعد تشغيل تطبيق العميل الخاص بك
  3. تحقق من سجلات العميل للرسائل الخطأ
  4. تحقق من إصدار Node.js: يتطلب Node.js 18+

Knowledge MCP Server

الوصول إلى صفحة إعدادات Dodo Knowledge MCP

التثبيت

اختر طريقة التثبيت التي تناسب سير العمل الخاص بك.

خادم MCP عن بعد (موصى به)

الوصول إلى الخادم المستضاف بدون أي إعداد محلي أو تثبيت. هذه هي أسرع طريقة لبدء الاستخدام.
1

Access the remote server

انتقل إلى https://mcp.dodopayments.com في متصفحك.
2

Configure your MCP client

انسخ تكوين JSON المقدم للعميل الخاص بك. لكل من Cursor أو Claude Desktop، أضفه إلى إعدادات MCP الخاصة بك:
{
  "mcpServers": {
    "dodopayments_api": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
3

Authenticate and configure

ستطلب منك عملية تدفق OAuth أن:
  • تدخل مفتاح API الخاص بك لـ Dodo Payments
  • تختار بيئتك (اختبار أو مباشر)
  • تختار نوع عميل MCP الخاص بك
احتفظ بمفتاح API الخاص بك آمنًا. استخدم مفاتيح وضع الاختبار أثناء التطوير.
4

Complete setup

انقر على تسجيل الدخول والموافقة لأجل تأكيد الاتصال.
بمجرد الاتصال، يمكن لمساعد الذكاء الاصطناعي الخاص بك التفاعل مع Dodo Payments API بالنيابة عنك.

حزمة NPM

قم بتثبيت وتشغيل خادم MCP محليًا باستخدام NPM.
# Set your environment variables
export DODO_PAYMENTS_API_KEY="dodo_test_..."
export DODO_PAYMENTS_WEBHOOK_KEY="your_webhook_key"
export DODO_PAYMENTS_ENVIRONMENT="live_mode"

# Run the latest version
npx -y dodopayments-mcp@latest
استخدم @latest دائمًا لسحب أحدث إصدار، أو قم بتثبيت إصدار محدد مثل @1.0.0 للاستقرار.

Docker

قم بتشغيل خادم MCP في بيئة مخصصة للتوزيع المتسق.
# Pull the latest image
docker pull ghcr.io/dodopayments/mcp:latest

# Run the container
docker run -e DODO_PAYMENTS_API_KEY="dodo_test_..." \
  -e DODO_PAYMENTS_WEBHOOK_KEY="your_webhook_key" \
  -e DODO_PAYMENTS_ENVIRONMENT="live_mode" \
  ghcr.io/dodopayments/mcp:latest
صور Docker متاحة على GitHub Container Registry.

إعدادات العميل

قم بتكوين خادم Dodo Payments MCP في عميل الذكاء الاصطناعي المفضل لديك.
قم بإعداد خادم Dodo Payments MCP في Cursor لتمكين الوصول المحادثي إلى بيانات المدفوعات الخاصة بك.التثبيت بنقرة واحدةاستخدم الزر أدناه لتثبيت خادم MCP مباشرةً في Cursor:[Add to Cursor](https://cursor.com/en-US/install-mcp?name=dodopayments-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRvZG9wYXltZW50cy1tY3AiXSwiZW52Ijp7IkRPRE9fUEFZTUVOVFNfQVBJX0tFWSI6IlNldCB5b3VyIERPRE9fUEFZTUVOVFNfQVBJX0tFWSBoZXJlLiIsIkRPRE9fUEFZTUVOVFNfV0VCSE9PS19LRVkiOiJTZXQgeW91ciBET0RPX1BBWU1FTlRTX1dFQkhPT0tfS0VZIGhlcmUuIn19)بعد الضغط، قم بتعيين متغيرات البيئة في mcp.json عبر إعدادات Cursor > أدوات & MCP > خادم MCP جديد.التكوين اليدوي
1

Open Cursor settings

انتقل إلى إعدادات Cursor > الخصائص > بروتوكول سياق النموذج أو اضغط Cmd/Ctrl + Shift + P وابحث عن “إعدادات MCP”.
2

Edit configuration

انقر على تحرير التكوين لفتح ملف mcp_config.json.
3

Add Dodo Payments configuration

اختر أحد التكوينات التالية:الخادم البعيد (موصى به)
{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
NPX محلي
{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "dodopayments-mcp@latest"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "dodo_test_...",
        "DODO_PAYMENTS_WEBHOOK_KEY": "your_webhook_key"
      }
    }
  }
}
4

Save and restart

احفظ ملف التكوين وأعد تشغيل Cursor.
تحقق من الاتصال عن طريق سؤال مساعد الذكاء الاصطناعي حول بيانات Dodo Payments الخاصة بك.

متغيرات البيئة

قم بتكوين سلوك خادم MCP باستخدام متغيرات البيئة.
المتغيرالوصفمطلوب
DODO_PAYMENTS_API_KEYمفتاح API الخاص بك لـ Dodo Paymentsنعم
DODO_PAYMENTS_WEBHOOK_KEYمفتاح توقيع الويب هوك الخاص بكلا
DODO_PAYMENTS_ENVIRONMENTاضبط على live_mode للإنتاجلا

التشغيل عن بُعد

قم بنشر خادم MCP كخادم HTTP بعيد للعمليات القائمة على الويب أو تدفقات العمل الوكيلة.
# Start as remote server
npx -y dodopayments-mcp --transport=http

# Specify a custom port
npx -y dodopayments-mcp --transport=http --port=3000

تكوين الخادم البعيد

بعد النشر، يمكن للعملاء الاتصال باستخدام عنوان URL للخادم:
{
  "mcpServers": {
    "dodopayments_api": {
      "url": "http://localhost:3000",
      "headers": {
        "Authorization": "Bearer your_api_key"
      }
    }
  }
}

رؤوس التحقق

يقبل الخادم البعيد المصادقة عبر الرؤوس التالية:
الرأسالوصف
Authorizationمصادقة رمز Bearer
x-dodo-payments-api-keyرأس مفتاح API المباشر

ممارسات الأمان المثلى

يوفر Code Mode أمانًا داخليًا من خلال تنفيذ الكود في بيئة معزولة وحقن مفاتيح API على جانب الخادم. اتبع هذه الممارسات المثلى الإضافية لحماية بيانات اعتمادك.
لا تلتزم مطلقًا ببيانات الاعتماد في التحكم في الإصدارقم بتخزين مفاتيح API في متغيرات البيئة أو أنظمة إدارة الأسرار الآمنة.
# Use environment variables
export DODO_PAYMENTS_API_KEY="dodo_test_..."

# Use a .env file (add to .gitignore)
echo "DODO_PAYMENTS_API_KEY=dodo_test_..." > .env
قم بتدوير المفاتيح بانتظامقم بإنشاء مفاتيح API جديدة دوريًا وألغِ المفاتيح القديمة عبر لوحة معلومات Dodo Payments الخاصة بك.استخدم مفاتيح الاختبار للتطويراستخدم دائمًا مفاتيح وضع الاختبار أثناء التطوير لتجنب التأثير على بيانات الإنتاج.
نفذ المصادقة للخوادم البعيدةعند النشر عن بُعد، يجب دائمًا المطالبة بالمصادقة عبر الرأس Authorization أو الرأس x-dodo-payments-api-key.مراقبة استخدام APIتتبع نشاط خادم MCP عبر لوحة معلومات Dodo Payments الخاصة بك وقم بإعداد تنبيهات لأنماط غير عادية.
استخدم HTTPS للخوادم البعيدةقم دائمًا بنشر خوادم MCP البعيدة خلف نقاط نهاية HTTPS.تنفيذ القيود الزمنيةاحمَ ضد الإساءة من خلال تنفيذ قيود السرعة على كل من خادم MCP ومستويات API.تقييد الوصول إلى الشبكةقم بتكوين قواعد الجدار الناري لتحديد العملاء الذين يمكنهم الاتصال بخادم MCP الخاص بك.

استكشاف الأخطاء وإصلاحها

تحقق من صحة مفتاح API الخاص بكتأكد من أن مفتاح API الخاص بك مضبوط بشكل صحيح ولديه الأذونات اللازمة.
# Test your API key
curl -H "Authorization: Bearer dodo_test_..." \
  https://test.dodopayments.com/payments
تحقق من اتصال الشبكة الخاص بكتأكد من إمكان وصولك إلى نقاط نهاية Dodo Payments API.راجع سجلات العميلقم بتمكين تسجيل الأحداث المفصل في عميل MCP الخاص بك لتشخيص مشاكل الاتصال.
تحقق من بيئة مفتاح APIتأكد من أنك تستخدم مفاتيح الاختبار مع نقاط نهاية الاختبار والمفاتيح المباشرة مع نقاط نهاية الإنتاج.تحقق من متغير البيئةتأكد من تعيين DODO_PAYMENTS_ENVIRONMENT بشكل صحيح (live_mode للإنتاج).إعادة توليد بيانات الاعتمادإذا استمرت المشاكل، قم بإنشاء مفتاح API جديد عبر لوحة التحكم الخاصة بك.
التحقق من صحة معلمات المدخلاتتأكد من أن مساعد الذكاء الاصطناعي يوفر المعلمات بصيغة صحيحة لكل أداة.مراجعة رسائل الخطأتحقق من استجابة الخطأ من 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
Last modified on May 4, 2026