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

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.

يعمل مكون دودة الربط على توصيل خادمَي MCP وثماني مهارات تكامل في وكيل الترميز بالذكاء الاصطناعي الخاص بك في عملية تثبيت واحدة. يعمل مع Claude Code وCodex CLI وCursor وOpenCode — وتعمل خوادم MCP وواجهة الأوامر CLI للمهارات مع أي عميل متوافق مع MCP.
ثلاث أساسيات، مكوّن واحد. يجمع مكون الوكيل كل ما تحتاجه:
  • خادم API MCP — الوصول المباشر إلى المدفوعات، الاشتراكات، العملاء، المنتجات، الاستردادات، التراخيص، والاستخدام. يتحقق عبر OAuth المتصفح (لا حاجة لمفاتيح محلية).
  • خادم المعرفة MCP — البحث الدلالي عبر جميع وثائق Dodo Payments. لا حاجة إلى بيانات اعتماد.
  • ثماني مهارات وكيل — أوراق الغش التي يقوم وكيلك بتحميلها عند الطلب للخروج، الاشتراكات، webhooks، الفوترة المعتمدة على الاستخدام، الفوترة المعتمدة على الرصيد، مفاتيح الترخيص، BillingSDK، وأفضل الممارسات.

​
تثبيت المكون

اختر وكيل الترميز الخاص بك أدناه. يتم إضافة خادمي MCP وجميع المهارات الثمانية تلقائيًا.

Claude Code

التثبيت من السوق:
claude plugins marketplace add dodopayments/dodo-agent-plugin
claude plugins install dodopayments@dodopayments
يستخدم خادم API MCP بشكل افتراضي OAuth عبر المتصفح — لا حاجة إلى مفاتيح عند وقت التثبيت. في المرة الأولى التي يتصل فيها وكيلك بأداة من دودة الربط، سيُطلب منك تسجيل الدخول.

Dodo Agent Plugin on GitHub

الشيفرة المصدرية، خيارات التكوين، وتعليمات التطوير المحلي
يجري Codex قراءة .claude-plugin/marketplace.json بشكل اصلي، لذلك يعمل نفس مستودع المكون:
codex plugin marketplace add dodopayments/dodo-agent-plugin
codex plugin install dodopayments@dodopayments
يتم تسجيل خادمي MCP وجميع المهارات الثمانية تلقائيًا.
التثبيت اليدوي — نسخ المستودع في دليل المكونات المحلي لـ Cursor:
git clone https://github.com/dodopayments/dodo-agent-plugin.git ~/.cursor/plugins/local/dodo-agent-plugin
أعد تشغيل Cursor. يقوم المكون بتحميل المهارات من .claude/skills/ (عبر طبقة توافق Claude Code لـ Cursor) وخوادم MCP من .mcp.json.
دعم سوق Cursor قادم. حاليًا، استخدم التثبيت اليدوي أعلاه.
يقوم OpenCode بالتوزيع عبر npm. أضف المكون إلى opencode.json:
{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@dodopayments/opencode-plugin"]
}
أعد تشغيل OpenCode. يتم تسجيل خادمي MCP (dodopayments-api, dodo-knowledge) تلقائيًا عبر ربط التكوين الخاص بالمكون، ويتم اكتشاف المهارات الثمانية تلقائيًا من الحزمة المثبتة. لا حاجة إلى كتلة mcp يدويًا.
تستخدم وكيلًا مختلفًا؟ تغطي أدلة MCP Server وAgent Skills Cursor وClaude Desktop وVS Code وWindsurf وCline وZed وأي عميل متوافق مع MCP.

​
ما تحصل عليه

بمجرد تثبيت المكون، يكون لدى وكيلك وصول إلى خادمي MCP وثماني مهارات.

​
خوادم MCP

الخادمالغرضالتوثيق
dodopayments-apiالوصول المباشر إلى API — المدفوعات، الاشتراكات، العملاء، المنتجات، الاستردادات، التراخيص، الاستخدامOAuth (المتصفح)
dodo-knowledgeالبحث الدلالي عبر جميع وثائق Dodo Paymentsلا شيء
يتم توصيل كلا الخادمين عبر mcp-remote بحيث يمكن تشغيلهما في أي عميل متوافق مع MCP.

​
مهارات الوكيل

المهارةالوصف
best-practicesدليل شامل لتكامل Dodo Payments مع أفضل الممارسات
checkout-integrationإنشاء جلسات الخروج وتدفقات الدفع
subscription-integrationتنفيذ تدفقات فوترة الاشتراكات
webhook-integrationإعداد ومعالجة webhooks لأحداث الدفع
usage-based-billingتنفيذ الفوترة باستخدام الأحداث والعدادات
credit-based-billingاستحقاقات الرصيد، الأرصدة، وخصم الائتمان مُقاسًا
license-keysإدارة مفاتيح الترخيص للمنتجات الرقمية
billing-sdkاستخدام مكونات BillingSDK React
تتحمل المهارات تلقائيًا — يختار وكيلك المهارة الصحيحة عندما يكتشف مهمة ذات صلة. راجع وثائق مهارات الوكيل للحصول على القائمة الكاملة والتثبيت الفردي.

​
جرب هذا الموجه أولاً

بمجرد تنشيط المكون، جرب: 
Set up Dodo Payments webhook handlers in my Next.js app for payment.succeeded and subscription.active events.
سيقوم وكيلك بتحميل مهارة webhook-integration، استخدام MCP لتنزيل أحدث أشكال الحمولة، وكتابة معالج مع التحقق من التوقيع وفقًا لمواصفات Standard Webhooks.

​
وكلاء آخرون مدعومون

يغطي مكون الوكيل Claude Code وCodex CLI وCursor وOpenCode. إذا كنت تستخدم وكيلًا مختلفًا، فاتصل بـ Dodo Payments من خلال خوادم MCP وواجهة الأوامر CLI للمهارات:
الوكيلأسرع طريقيدعم أيضًا
Claude Codeمكون الوكيل (أمر واحد)خادم MCP، المهارات الفردية
Codex CLIمكون الوكيل (أمر واحد)خادم MCP
Cursorمكون الوكيل (نسخ git)تكوين خادم MCP، واجهة الأوامر CLI للمهارات
OpenCodeمكون الوكيل (npm)تكوين خادم MCP، واجهة الأوامر CLI للمهارات
GitHub Copilot (VS Code)دليل خادم MCPواجهة الأوامر CLI للمهارات
Claude Desktopدليل خادم MCP—
Windsurfدليل خادم MCPواجهة الأوامر CLI للمهارات
Cline / Zed / آخروندليل خادم MCPواجهة الأوامر CLI للمهارات

​
وثائق مبنية للوكلاء

كل صفحة من صفحات وثائق Dodo Payments متاحة بتنسيق مُحسَّن لاستهلاك الذكاء الصناعي:
  • كامل فهرس الوثائق: docs.dodopayments.com/llms.txt — يخدم فهرس الوثائق الكامل لابتلاع السياق.
  • تنسيق markdown الخام: أضف .md لأي عنوان URL للوثائق للحصول على نسخة markdown الخام (مثل، /api-reference/introduction.md).
  • المستودع المصدر: github.com/dodopayments/dodo-docs — نسخ للتحميل دون اتصال.

​
ما يمكن لوكيلك القيام به

مع تثبيت المكون، يمكن لوكيل الترميز الخاص بك:

​
الأمان وأفضل الممارسات

لا تقم أبدًا بوضع مفاتيح API الخاصة بالإنتاج. استخدم وضع الاختبار أثناء التطوير. يستخدم مكون الوكيل بشكل افتراضي OAuth المتصفح — قم بالتبديل فقط إلى مفاتيح API المحلية إذا تطلبت سير العمل لديك ذلك.
  • استخدم وضع الاختبار أولاً. قلل من تكاملاتك باستخدام مفاتيح dodo_test_... قبل التفعيل. راجع وضع الاختبار مقابل الوضع المباشر.
  • OAuth هو الافتراضي. يتحقق مكون الوكيل عبر OAuth المتصفح (لا أسرار محلية). استخدم وضع API-key فقط إذا احتجت لذلك — راجع قسم الإعدادات أدناه.
  • راجع الكود الذي يولده الوكيل. تحقق دائمًا من أن عملية معالجة webhooks تتضمن التحقق من التوقيع وفقًا لـ مواصفات Standard Webhooks.

​
التكوين باستخدام مفتاح API

بشكل افتراضي، يستخدم مكون الوكيل الخادم MCP البعيد مع OAuth المتصفح — لا حاجة إلى بيانات اعتماد محلية. إذا كان سير العمل لديك يتطلب مفتاح API محلي (مثل بيئات CI، الخوادم غير الرئيسية)، يمكنك التحول إلى وضع stdio.
افتح /plugins في Claude Code، حدد Dodo Payments، واختر تكوين الخيارات. املأ:
  • dodo_api_key — المفتاح الخاص بك dodo_test_... أو dodo_live_...
  • dodo_webhook_key — سر توقيع webhook الخاص بك
  • dodo_environment — test_mode أو live_mode
ثم قم بتحرير .mcp.json لتوجيه dodopayments-api إلى الخادم المحلي stdio:
{
  "mcpServers": {
    "dodopayments-api": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "dodopayments-mcp@latest"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "${user_config.dodo_api_key}",
        "DODO_PAYMENTS_WEBHOOK_KEY": "${user_config.dodo_webhook_key}",
        "DODO_PAYMENTS_ENVIRONMENT": "${user_config.dodo_environment}"
      }
    }
  }
}
قم بتشغيل /reload-plugins لتطبيق التغييرات على جلستك الحالية.
أعلن dodopayments-api بنفسك في opencode.json — يحل إدخالك محل خادم المكون البعيد الافتراضي:
{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@dodopayments/opencode-plugin"],
  "mcp": {
    "dodopayments-api": {
      "type": "local",
      "command": ["npx", "-y", "dodopayments-mcp@latest"],
      "environment": {
        "DODO_PAYMENTS_API_KEY": "dodo_test_...",
        "DODO_PAYMENTS_WEBHOOK_KEY": "whsec_...",
        "DODO_PAYMENTS_ENVIRONMENT": "test_mode"
      },
      "enabled": true
    }
  }
}
أعد تشغيل OpenCode للتطبيق.

​
الخطوات التالية

MCP Server

المرجع الكامل لكلا خادمي MCP — جميع العملاء المدعومين، التكوين، والأدوات المتاحة

Agent Skills

تثبيت المهارات الفردية، المرجع المهاري، وتعليمات الإعداد لكل وكيل

Sentra IDE Assistant

مساعد الفوترة المدعوم بالذكاء الاصطناعي لـ VS Code وCursor وWindsurf — اسأل، وابني، وخطط في محررك

API Reference

المرجع الكامل لـ OpenAPI لجميع نقاط النهاية لـ Dodo Payments
Last modified on May 4, 2026