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

ثبّت Dodo Agent Plugin لمنح coding agent لديك خادمي MCP وسبع عشرة مهارة لبناء تكاملات Dodo Payments. بعد تثبيته، صِف ما تريد بناءه، وسيخطط agent لديك للتكامل ويكتبه. يعمل plugin مع Claude Code وCodex CLI وCursor وVS Code / GitHub Copilot وKiro وOpenCode. يحصل Gemini CLI على خادمي MCP فقط.

تثبيت الإضافة

اختر وكيل البرمجة أدناه. يضيف كل تثبيت خادمي MCP معًا. تضيف جميع الوكلاء باستثناء Gemini CLI المهارات السبع عشرة أيضًا. يحتاج OpenCode إلى إعداد إضافي واحد لتحميلها، كما هو موضح في القسم الخاص به.

Claude Code

ثبّت من السوق:

claude plugins marketplace add dodopayments/dodo-agent-plugin
claude plugins install dodopayments@dodopayments

يستخدم خادم API MCP مصادقة OAuth عبر المتصفح افتراضيًا — ولا يحتاج إلى مفاتيح وقت التثبيت. في المرة الأولى التي يستدعي فيها وكيلك أداة من Dodo، سيُطلب منك تسجيل الدخول.

Dodo Agent Plugin on GitHub

شفرة المصدر وخيارات الإعدادات وتعليمات التطوير المحلي

Codex CLI

سجّل السوق، ثم ثبّت من واجهة Codex النصية.

codex plugin marketplace add dodopayments/dodo-agent-plugin

Install from the Codex TUI

افتح Codex وشغّل /plugins:

codex

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

يُسجّل خادما MCP والمهارات السبع عشرة تلقائيًا.إذا لم تظهر الإضافة ضمن /plugins، فحدّثها:

codex plugin marketplace upgrade dodopayments

لتثبيت الإضافة من الصدفة بدلًا من واجهة TUI، شغّل codex plugin add dodopayments@dodopayments بعد تسجيل السوق. لا يحتوي Codex CLI على أمر فرعي codex plugin install. راجع وثائق إضافات Codex الرسمية.

Cursor

استنسخ المستودع إلى دليل الإضافات المحلي في Cursor:

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

أعد تشغيل Cursor. تحمّل الإضافة المهارات من skills/ وخوادم MCP من .mcp.json.تتعرف الإصدارات الحديثة من Cursor على Agent Plugins 1.0.0 مباشرةً وتقبل .claude-plugin/marketplace.json كمصدر للسوق. ويُحتفظ بالملف .cursor-plugin/plugin.json المُنشأ للإصدارات الأقدم.إذا ثبّت إصدارًا أقدم من 0.5.0، فاحذف الدليل وأعد الاستنساخ — إذ تُوزَّع المهارات الآن كملفات فعلية، لا كروابط رمزية.

OpenCode

ثبّت حزمة الإضافة في مشروعك، ثم أضفها ومسار مهاراتها إلى opencode.json:

npm install --save-dev @dodopayments/opencode-plugin

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

أعد تشغيل OpenCode. يُسجّل خادما MCP تلقائيًا. تحتاج المهارات إلى إدخال skills.paths الإضافي لأن OpenCode لا يفحص الحزم المثبتة بحثًا عن المهارات.تُحل المسارات النسبية بالنسبة إلى دليل المشروع، لذا يجب أن تكون الحزمة موجودة في node_modules الخاص بذلك المشروع. ويعمل المسار المطلق أيضًا، كما يلغي الحاجة إلى التثبيت المحلي.تحقق من تحميل المهارات:

opencode run "List every skill available to you by name."

من المفترض أن ترى المهارات السبع عشرة كلها. يُتجاهل مسار المهارات غير الموجود بصمت، لذا تحقّق بدلًا من الافتراض.

VS Code / GitHub Copilot

استنسخ المستودع وسجّله:

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

افتح عرض Chat، وانتقل إلى Plugins، وأضف المجلد المستنسخ. أو سجّله في settings.json:

{
  "chat.pluginLocations": { "~/dodo-agent-plugin": true }
}

المفتاح هو المسار، والقيمة تفعّله. تعمل المسارات المطلقة و~/ أيضًا؛ وتُحل المسارات النسبية بالنسبة إلى مجلد مساحة العمل. تُقرأ الإعدادات مباشرةً، لذا تلتقطها النافذة قيد التشغيل دون إعادة تشغيل.تم وضع علامة تجريبية على chat.pluginLocations، وهو إعداد مقيّد، لذا يجب الوثوق بمساحة العمل. ودعم إضافات الوكلاء ميزة معاينة يحكمها chat.plugins.enabled، وهي مفعّلة افتراضيًا.

Kiro

يقرأ Kiro بيان Agent Plugins أصليًا.

Clone the repository

git clone https://github.com/dodopayments/dodo-agent-plugin.git

Open the Powers panel

في Kiro، افتح لوحة Powers (أيقونة Ghosty ذات صاعقة البرق).

Import the folder

اختر Add Custom Power → Import power from a folder، وحدد الدليل المستنسخ (الذي يحتوي على plugin.json)، ثم انقر Install.

تُحمّل المهارات من skills/، وخوادم MCP من mcp.json. يدير Kiro خوادم MCP داخليًا — ولا تُكتب في ~/.kiro/settings/mcp.json. ويمكن لـ Kiro أيضًا تثبيت Power مباشرةً من عنوان URL في GitHub؛ راجع وثائق تثبيت Kiro.

Gemini CLI (MCP only)

لا يحتوي Gemini CLI على بدائية agent-skill، لذا لا يتوفر سوى خادمي MCP. يغطي dodo-knowledge جزءًا كبيرًا مما توفره المهارات، ويظل محدّثًا تلقائيًا.

git clone https://github.com/dodopayments/dodo-agent-plugin.git \
  ~/.gemini/extensions/dodopayments

أعد تشغيل Gemini CLI. يمثّل gemini-extension.json في جذر المستودع البيان.

هل تستخدم وكيلًا مختلفًا؟ يغطي دليلا خادم MCP ومهارات الوكلاء Claude Desktop وWindsurf وCline وZed وأي عميل متوافق مع MCP.

ما تحصل عليه

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

خوادم MCP

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

يتحدث الخادمان باستخدام Streamable HTTP. يعلن mcp.json الأساسي عنهما أصليًا، ويستخدمه العملاء المطابقون للمواصفة مثل Codex CLI وKiro. وتربط وثيقة التوافق المُنشأة .mcp.json بينهما عبر mcp-remote للعملاء الذين لا يستطيعون الاتصال بـ Streamable HTTP مباشرةً.

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

المهارة	الوصف
`dodo-best-practices`	إعداد SDK والبيئات ومفاتيح API وبنية الدفع القياسية من إتمام الشراء إلى webhook
`framework-adapters`	معالجات المسارات الرسمية `@dodopayments/*` لـ Next.js وExpress وHono وAstro وRemix وSvelteKit وNuxt وFastify وTanStack وBun وConvex
`testing-and-go-live`	وضع الاختبار وطرق الدفع الاختبارية واختبار webhook وقائمة التحقق من الإطلاق إلى الإنتاج
`checkout-integration`	Checkout Sessions وروابط الدفع وواجهة الدفع المنبثقة أو المضمّنة
`subscription-integration`	دورة حياة الاشتراك والفترات التجريبية وتغييرات الخطط والتوزيع النسبي والرسوم عند الطلب
`mobile-checkout`	الدفع داخل التطبيق لـ React Native وFlutter وiOS وAndroid
`webhook-integration`	تلقي webhooks والتحقق منها باستخدام مواصفة Standard Webhooks
`credit-based-billing`	استحقاقات الأرصدة والأرصدة والدفتر والترحيل والتجاوز والخصم المستند إلى العداد
`usage-based-billing`	العدادات واستيعاب الأحداث وتجميعها والتسعير لكل وحدة
`license-keys`	تفعيل مفاتيح الترخيص والتحقق منها وإدارة المثيلات
`product-catalog-management`	المنتجات والتسعير والإضافات والمجموعات والصور وتسليم المنتجات الرقمية
`discounts-and-promotions`	رموز الخصم وقواعد الأهلية والتكديس والحدود الخاصة بدورة الاشتراك
`localized-pricing`	التسعير المحلي وAdaptive Currency وتعادل القوة الشرائية
`customer-management`	العملاء وبوابة الخدمة الذاتية وطرق الدفع المحفوظة والمحافظ
`refunds-and-disputes`	إصدار رد الأموال ومعالجة النزاعات وعمليات رد المدفوعات وتسوية الوصول
`billing-sdk`	مكونات BillingSDK React لجداول الأسعار وواجهة الفوترة
`better-auth-integration`	إضافة `@dodopayments/better-auth` لمزامنة العملاء والدفع والوصول إلى البوابة

تُحمّل المهارات تلقائيًا — يختار وكيلك المهارة المناسبة عند اكتشاف مهمة ذات صلة. راجع مهارات الوكلاء للاطلاع على القائمة الكاملة والتثبيت الفردي.

جرّب هذا الطلب أولًا

بعد تفعيل الإضافة، جرّب ما يلي:

Set up Dodo Payments webhook handlers in my Next.js app for payment.succeeded and subscription.active events.

سيحمّل وكيلك مهارة webhook-integration، ويستخدم MCP الخاص بـ dodo-knowledge لجلب أحدث هياكل payload، ويكتب معالجًا للتحقق من التوقيع وفقًا لمواصفة Standard Webhooks.

دعم العملاء

تتبع الإضافة مواصفة Agent Plugins 1.0.0. تحمّلها العملاء ذوو الدعم الأصلي مباشرةً؛ بينما يستخدم الآخرون بيانات توافق مُنشأة.

الوكلاء الذين يدعمون تثبيت الإضافات

يؤدي تثبيت واحد إلى إعداد خادمي MCP، إضافةً إلى المهارات في كل عميل يحتوي على بدائية للمهارات.

الوكيل	التثبيت	المهارات	خوادم MCP
Claude Code	أمر السوق	17	2
Codex CLI	أمر السوق	17	2
Cursor	استنساخ git	17	2
VS Code / GitHub Copilot	استنساخ git	17	2
Kiro	استنساخ git	17	2
OpenCode	npm	17	2
Gemini CLI	استنساخ git	0	2

يحتاج OpenCode إلى إدخال skills.paths إضافي قبل تحميل مهاراته السبع عشرة. لا يحتوي Gemini CLI على بدائية agent-skill، لذا لا تتوفر المهارات عن قصد.

عملاء آخرون متوافقون مع MCP

لا يملكون تثبيت Agent Plugin. اضبط خادمي MCP يدويًا، وأضف المهارات عبر Skills CLI حيثما كان ذلك مدعومًا.

الوكيل	خوادم MCP	المهارات
Claude Desktop	دليل خادم MCP	غير مدعومة
Windsurf	دليل خادم MCP	Skills CLI
Cline / Zed / غيرهما	دليل خادم MCP	Skills 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
إنشاء تدفقات مفاتيح الترخيص للمنتجات الرقمية — مفاتيح الترخيص
تنفيذ الفوترة القائمة على الأرصدة مع الاستحقاقات والأرصدة والترحيل والتجاوز — الأرصدة
إنشاء كتالوج منتجاتك وإدارته مع الإضافات والمجموعات — المنتجات، الإضافات، مجموعات المنتجات
إضافة الخصومات والتسعير المحلي — رموز الخصم، التسعير المحلي، Adaptive Currency
إطلاق الدفع داخل التطبيق على الأجهزة المحمولة لـ React Native وFlutter وiOS وAndroid — تكامل الأجهزة المحمولة
معالجة رد الأموال والنزاعات والخدمة الذاتية للعملاء — رد الأموال، النزاعات، بوابة العملاء
اختبار التكامل والانتقال إلى الإنتاج بأمان — وضع الاختبار مقابل الوضع المباشر

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

لا تضع مفاتيح API المباشرة في المستودع. استخدم وضع الاختبار أثناء التطوير.

استخدم وضع الاختبار أولًا. أنشئ تكاملك واختبره باستخدام مفتاح API لوضع الاختبار قبل الانتقال إلى الإنتاج. راجع وضع الاختبار مقابل الوضع المباشر.
OAuth هو الإعداد الافتراضي. تصادق Agent Plugin عبر OAuth في المتصفح (من دون أسرار محلية). استخدم وضع مفتاح API فقط عند الحاجة إليه.
راجع الشفرة التي ينشئها الوكيل. تحقق دائمًا من أن معالجات webhook تتضمن التحقق من التوقيع وفقًا لـ مواصفة Standard Webhooks.

الإعداد باستخدام مفتاح API

تستخدم Agent Plugin خادم MCP البعيد مع OAuth عبر المتصفح افتراضيًا. لاستخدام مفتاح API محلي بدلًا من ذلك، مثلًا في CI أو على خادم بلا واجهة، انتقل إلى وضع stdio.

Local API key mode — Claude Code

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

dodo_api_key — مفتاح API لوضع الاختبار أو الوضع المباشر
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": "YOUR_TEST_MODE_API_KEY",
        "DODO_PAYMENTS_WEBHOOK_KEY": "whsec_...",
        "DODO_PAYMENTS_ENVIRONMENT": "test_mode"
      },
      "enabled": true
    }
  }
}

أعد تشغيل OpenCode لتطبيق التغييرات.

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

MCP Server

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

Agent Skills

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

API Reference

مرجع OpenAPI الكامل لجميع نقاط نهاية Dodo Payments

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

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

تثبيت الإضافة

Dodo Agent Plugin on GitHub

ما تحصل عليه

خوادم MCP

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

جرّب هذا الطلب أولًا

دعم العملاء

الوكلاء الذين يدعمون تثبيت الإضافات

عملاء آخرون متوافقون مع MCP

وثائق مصممة للوكلاء

ما يستطيع وكيلك فعله

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

الإعداد باستخدام مفتاح API

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

MCP Server

Agent Skills

API Reference

​تثبيت الإضافة

Dodo Agent Plugin on GitHub

​ما تحصل عليه

​خوادم MCP

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

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

​دعم العملاء

​الوكلاء الذين يدعمون تثبيت الإضافات

​عملاء آخرون متوافقون مع MCP

​وثائق مصممة للوكلاء

​ما يستطيع وكيلك فعله

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

​الإعداد باستخدام مفتاح API

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

MCP Server

Agent Skills

API Reference

تثبيت الإضافة

ما تحصل عليه

خوادم MCP

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

جرّب هذا الطلب أولًا

دعم العملاء

الوكلاء الذين يدعمون تثبيت الإضافات

عملاء آخرون متوافقون مع MCP

وثائق مصممة للوكلاء

ما يستطيع وكيلك فعله

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

الإعداد باستخدام مفتاح API

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