البناء باستخدام وكلاء الترميز بالذكاء الاصطناعي

يعمل مكون دودة الربط على توصيل خادمَي 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 CLI

يقوم Codex بتثبيت المكونات الإضافية على مرحلتين: تسجيل السوق من صدفتك، ثم تثبيت المكون الإضافي من داخل واجهة Codex TUI.

codex plugin marketplace add dodopayments/dodo-agent-plugin

Install from the Codex TUI

افتح Codex وشغّل الأمر المائل /plugins:

codex

ثم اكتب /plugins، وقم بالتبديل إلى سوق Dodo Payments، واختر المكون الإضافي dodopayments، واختر Install plugin.

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

لا تحتوي Codex CLI على أمر فرعي codex plugin install — يحدث تثبيت المكونات الإضافية دائمًا من خلال التدفق /plugins في الواجهة النصية TUI. راجع المستندات الرسمية لمكونات Codex الإضافية.

إذا قمت بإضافة السوق سابقًا ولم يظهر المكون الإضافي تحت /plugins، قم بتحديثه:

codex plugin marketplace upgrade dodopayments

Cursor

التثبيت اليدوي — استنساخ المخزن إلى دليل المكونات الإضافية المحلي الخاص بـ Cursor:

git clone https://github.com/dodopayments/dodo-agent-plugin.git ~/.cursor/plugins/local/dodo-agent-plugin

أعد تشغيل Cursor. يقوم المكون الإضافي بتحميل المهارات من .claude/skills/ (عبر طبقة توافق Claude Code) وخوادم MCP من .mcp.json.

دعم سوق Cursor قادم. في الوقت الحالي، استخدم التثبيت اليدوي أعلاه.

OpenCode

توزع OpenCode عبر npm. أضف المكون الإضافي إلى opencode.json الخاص بك:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@dodopayments/opencode-plugin"]
}

أعد تشغيل OpenCode. يتم تسجيل كل من خوادم MCP (dodopayments-api، dodo-knowledge) تلقائيًا عبر خطاف تكوين المكون الإضافي، ويتم اكتشاف المهارات الثمانية تلقائيًا من الحزمة المثبتة. لا حاجة إلى كتلة mcp يدوية.

تستخدم عميل مختلف؟ تغطي أدلة خادم MCP ومهارات الوكيل Cursor، Claude Desktop، VS Code، Windsurf، Cline، Zed، وأي عميل متوافق مع MCP.

ما ستحصل عليه

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

خوادم MCP

الخادم	الغرض	التحقق
`dodopayments-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 الخاص بـ dodo-knowledge لاستخراج أحدث أشكال الحمولة، وكتابة معالج بعمليات تحقق التوقيع وفقًا لمواصفات Standard Webhooks.

عوامل أخرى مدعومة

يغطي المكون الإضافي للوكيل Claude Code، Codex CLI، Cursor، وOpenCode. إذا كنت تستخدم وكيلًا مختلفًا، قم بالاتصال بـ Dodo Payments عبر خوادم MCP وCLI للمهارات:

الوكيل	أسرع مسار	يدعم أيضًا
Claude Code	المكون الإضافي للوكيل (أمر واحد)	خادم MCP، مهارات فردية
Codex CLI	المكون الإضافي للوكيل (أمر واحد)	خادم MCP
Cursor	المكون الإضافي للوكيل (git clone)	تكوين خادم 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 — استنسخ للفهرسة غير المتصلة.

ما يمكن لوكيلك أن يفعله

مع تثبيت المكون الإضافي، يمكن لوكيل التشفير الخاص بك أن:

إنشاء جلسات دفع وروابط دفع — مدفوعات مرة واحدة واشتراكات
إعداد الفوترة القائمة على الاشتراك والاستخدام بشكل كامل — اشتراكات، الفوترة القائمة على الاستخدام، الفوترة القائمة على الاعتمادات
توليد معالجات متوافقة مع Standard Webhooks مع تحقق من التوقيعات — Webhooks
ربط مكونات BillingSDK React لجدول الأسعار وإدارة الاشتراك — BillingSDK
كتابة تدفقات مفاتيح التراخيص للمنتجات الرقمية — مفاتيح التراخيص
تنفيذ الفوترة القائمة على الاعتمادات مع الاستحقاقات، الأرصدة، الترحيل، والاستخدام الزائد — الاعتمادات

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

لا تُضمِّن أبدًا مفاتيح API الإنتاجية. استخدم وضع الاختبار أثناء التطوير. يستخدم المكون الإضافي للوكيل OAuth عبر المتصفح بشكل افتراضي — لا تتحول إلى مفاتيح API المحلية إلا إذا كانت سير عملك تتطلبها.

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

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

بشكل افتراضي، يستخدم المكون الإضافي للوكيل خادم MCP البعيد مع OAuth للمتصفح — لا توجد أسرار محلية مطلوبة. إذا كانت سير عملك تتطلب مفتاح API محلي (مثل بيئات CI، الخوادم دون واجهة)، يمكنك التبديل إلى وضع stdio.

Local API key mode — Claude Code

افتح /plugins في Claude Code، حدد Dodo Payments، واختر Configure options. املأ الآتي:

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 لتطبيق التغييرات على جلستك الحالية.

Local API key mode — OpenCode

أعلن عن 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

Documentation Index

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

Dodo Agent Plugin on GitHub

​ما ستحصل عليه

​خوادم MCP

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

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

​عوامل أخرى مدعومة

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

​ما يمكن لوكيلك أن يفعله

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

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

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

MCP Server

Agent Skills

Sentra IDE Assistant

API Reference

تثبيت المكون

ما ستحصل عليه

خوادم MCP

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

جرب هذه المطالبة أولاً

عوامل أخرى مدعومة

وثائق مبنية للعوامل

ما يمكن لوكيلك أن يفعله

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

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

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