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

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

Dodo Payments API MCP server — وصول مباشر إلى payments وsubscriptions وcustomers وproducts وrefunds وlicenses وusage. تتم المصادقة عبر browser OAuth (ولا حاجة إلى مفاتيح محلية).
Dodo Knowledge MCP server — بحث دلالي في جميع وثائق Dodo Payments. لا حاجة إلى credentials.
سبع عشرة مهارة لـ agent — أوراق مرجعية مختصرة يحمّلها agent عند الطلب من أجل checkout وsubscriptions وwebhooks وusage-based billing وcredit-based billing وlicense keys وproduct catalog وdiscounts وlocalized pricing وmobile checkout وrefunds وdisputes وcustomer management وframework adapters وBillingSDK وBetter Auth وtesting وgo-live وأفضل الممارسات.

تثبيت Plugin

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

Claude Code

ثبّت من marketplace:

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

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

Dodo Agent Plugin on GitHub

الكود المصدري وخيارات الإعدادات وتعليمات التطوير المحلي

Codex CLI

سجّل marketplace، ثم ثبّت من Codex TUI.

codex plugin marketplace add dodopayments/dodo-agent-plugin

Install from the Codex TUI

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

codex

اكتب /plugins، ثم بدّل إلى marketplace الخاص بـ Dodo Payments، واختر plugin dodopayments، ثم اختر Install plugin.

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

codex plugin marketplace upgrade dodopayments

للتثبيت من shell بدلاً من TUI، شغّل codex plugin add dodopayments@dodopayments بعد تسجيل marketplace. لا يحتوي Codex CLI على subcommand باسم codex plugin install. راجع وثائق Codex plugins الرسمية.

Cursor

انسخ repo إلى دليل plugins المحلي في Cursor:

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

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

OpenCode

ثبّت حزمة plugin في مشروعك، ثم أضفها ومسار المهارات الخاص بها إلى 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

انسخ repo وسجّله:

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

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

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

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

Kiro

يقرأ Kiro manifest الخاص بـ 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 على primitive للمهارات، لذلك لا يتوفر سوى خادمي MCP. يغطي dodo-knowledge جزءاً كبيراً مما توفره المهارات، ويظل محدّثاً تلقائياً.

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

أعد تشغيل Gemini CLI. يُعد gemini-extension.json في جذر repo هو manifest.

هل تستخدم agent مختلفاً؟ يغطي دليلا MCP Server وAgent Skills كلاً من Claude Desktop وWindsurf وCline وZed وأي عميل متوافق مع MCP.

ما ستحصل عليه

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

خوادم MCP

Server	Purpose	Auth
`dodopayments-api`	وصول مباشر إلى API — payments وsubscriptions وcustomers وproducts وrefunds وlicenses وusage	OAuth (browser)
`dodo-knowledge`	بحث دلالي في جميع وثائق Dodo Payments	None

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

Agent Skills

Skill	Description
`dodo-best-practices`	إعداد SDK والبيئات ومفاتيح API وبنية checkout-to-webhook الأساسية
`framework-adapters`	معالجات المسارات الرسمية `@dodopayments/*` لـ Next.js وExpress وHono وAstro وRemix وSvelteKit وNuxt وFastify وTanStack وBun وConvex
`testing-and-go-live`	Test mode وtest payment methods واختبار webhooks وقائمة التحقق من إطلاق الإنتاج
`checkout-integration`	Checkout Sessions وروابط الدفع وcheckout المتراكب أو المضمّن
`subscription-integration`	دورة حياة subscription وtrials وتغييرات الخطط وproration والرسوم عند الطلب
`mobile-checkout`	checkout داخل التطبيق لـ React Native وFlutter وiOS وAndroid
`webhook-integration`	استقبال webhooks والتحقق منها باستخدام مواصفة Standard Webhooks
`credit-based-billing`	استحقاقات الائتمان والأرصدة وledger وrollover وoverage والخصم القائم على meter
`usage-based-billing`	Meters واستيعاب الأحداث وتجميعها والتسعير لكل وحدة
`license-keys`	تفعيل license key والتحقق منه وإدارة instances
`product-catalog-management`	Products والتسعير والإضافات والمجموعات والصور وتسليم المنتجات الرقمية
`discounts-and-promotions`	Discount codes وقواعد الأهلية والتجميع وحدود دورة subscription
`localized-pricing`	localized pricing وadaptive currency وتكافؤ القوة الشرائية
`customer-management`	Customers وself-service portal وطرق الدفع المحفوظة والمحافظ
`refunds-and-disputes`	إصدار refunds والتعامل مع disputes وchargebacks وتسوية الوصول
`billing-sdk`	مكونات BillingSDK React لجداول الأسعار وواجهة الفوترة
`better-auth-integration`	plugin `@dodopayments/better-auth` لمزامنة customers وcheckout والوصول إلى portal

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

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

بعد تفعيل plugin، جرّب ما يلي:

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

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

دعم العملاء

Agents مع تثبيت Plugin

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

Agent	Install	Skills	MCP Servers
Claude Code	أمر marketplace	17	2
Codex CLI	أمر marketplace	17	2
Cursor	git clone	17	2
VS Code / GitHub Copilot	git clone	17	2
Kiro	git clone	17	2
OpenCode	npm	17	2
Gemini CLI	git clone	0	2

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

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

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

Agent	MCP Servers	Skills
Claude Desktop	دليل MCP Server	غير مدعوم
Windsurf	دليل MCP Server	Skills CLI
Cline / Zed / others	دليل MCP Server	Skills CLI

وثائق مصممة لـ Agents

تتوفر كل صفحة من وثائق Dodo Payments بتنسيق مُحسّن للاستهلاك بواسطة AI:

فهرس الوثائق الكامل: docs.dodopayments.com/llms.txt — فهرس الوثائق الكامل لإدخاله في السياق
Markdown عادي: أضف .md إلى أي URL للوثائق للحصول على إصدار Markdown الخام (مثلاً، /api-reference/introduction.md)
مستودع المصدر: github.com/dodopayments/dodo-docs — انسخه للفهرسة دون اتصال

ما يستطيع Agent لديك فعله

بعد تثبيت plugin، يستطيع coding agent لديك تنفيذ ما يلي:

إنشاء checkout sessions وروابط الدفع — المدفوعات لمرة واحدة وsubscriptions
إعداد subscription وusage-based billing من البداية إلى النهاية — Subscriptions وUsage-based billing وCredit-based billing
إنشاء handlers متوافقة مع Standard Webhooks مع التحقق من التوقيع — Webhooks
تركيب route handlers في framework الخاص بك باستخدام adapters الرسمية — Framework adaptors
ربط مكونات BillingSDK React بجداول الأسعار وإدارة subscription — BillingSDK
إنشاء تدفقات license key للمنتجات الرقمية — License keys
تنفيذ credit-based billing مع الاستحقاقات والأرصدة وrollover وoverage — Credits
إنشاء product catalog وإدارته مع الإضافات والمجموعات — Products وAdd-ons وProduct collections
إضافة discounts وlocalized pricing — Discount codes وLocalized pricing وAdaptive currency
إطلاق checkout داخل التطبيق على الأجهزة المحمولة لـ React Native وFlutter وiOS وAndroid — Mobile integration
معالجة refunds وdisputes وcustomer self-service — Refunds وDisputes وCustomer portal
اختبار التكامل والانتقال إلى الإنتاج بأمان — Test mode vs live mode

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

لا تُضمّن مفاتيح API الحية في commit. استخدم test mode أثناء التطوير.

استخدم test mode أولاً. أنشئ تكاملك واختبره باستخدام مفتاح API لـ test mode قبل الانتقال إلى الإنتاج. راجع Test Mode vs Live Mode.
OAuth هو الإعداد الافتراضي. يصادق Agent Plugin عبر browser OAuth (ولا يستخدم أسراراً محلية). استخدم وضع API-key فقط عند الحاجة.
راجع الكود الذي ينشئه agent. تحقق دائماً من أن handlers الخاصة بـ webhook تتضمن التحقق من التوقيع وفقاً لـ مواصفة Standard Webhooks.

الإعداد باستخدام API Key

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

Local API key mode — Claude Code

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

dodo_api_key — مفتاح API الخاص بـ test mode أو live mode
dodo_webhook_key — secret توقيع webhook الخاص بك
dodo_environment — test_mode أو live_mode

بعد ذلك، عدّل .mcp.json لتوجيه dodopayments-api إلى server المحلي بصيغة 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 — يتغلب إدخالك على remote server الافتراضي الخاص بـ plugin:

{
  "$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

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

API Reference

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

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

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

تثبيت Plugin

Dodo Agent Plugin on GitHub

ما ستحصل عليه

خوادم MCP

Agent Skills

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

دعم العملاء

Agents مع تثبيت Plugin

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

وثائق مصممة لـ Agents

ما يستطيع Agent لديك فعله

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

الإعداد باستخدام API Key

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

MCP Server

Agent Skills

API Reference

​تثبيت Plugin

Dodo Agent Plugin on GitHub

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

​خوادم MCP

​Agent Skills

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

​دعم العملاء

​Agents مع تثبيت Plugin

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

​وثائق مصممة لـ Agents

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

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

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

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

MCP Server

Agent Skills

API Reference

تثبيت Plugin

ما ستحصل عليه

خوادم MCP

Agent Skills

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

دعم العملاء

Agents مع تثبيت Plugin

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

وثائق مصممة لـ Agents

ما يستطيع Agent لديك فعله

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

الإعداد باستخدام API Key

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