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

نظرة عامة

بروتوكول سياق النموذج (MCP) هو معيار مفتوح يمكّن تطبيقات الذكاء الاصطناعي من الاتصال بشكل آمن بمصادر البيانات الخارجية وواجهات برمجة التطبيقات. يوفر خادم مدفوعات دودي للمساعدين الذكيين مثل كلود، وكورسر، وغيرهم من العملاء المتوافقين مع MCP وصولاً منظمًا إلى بنية الدفع الخاصة بك.

القدرات الرئيسية

  • عمليات الدفع: إنشاء واسترجاع وإدارة المدفوعات والمبالغ المستردة
  • إدارة الاشتراكات: التعامل مع الفواتير المتكررة، والترقيات، والإلغاءات
  • إدارة العملاء: إدارة بيانات العملاء والوصول إلى البوابة
  • كتالوج المنتجات: إنشاء وتحديث المنتجات والأسعار والخصومات
  • إدارة التراخيص: تفعيل والتحقق وإدارة تراخيص البرمجيات
  • الفوترة بناءً على الاستخدام: تتبع والفوترة للاستخدام المقاس

التثبيت

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

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

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

الوصول إلى الخادم عن بُعد

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

تكوين عميل MCP الخاص بك

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

المصادقة والتكوين

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

إكمال الإعداد

انقر على تسجيل الدخول والموافقة لتفويض الاتصال.
بمجرد الاتصال، يمكن لمساعدك الذكي التفاعل مع واجهة برمجة تطبيقات مدفوعات دودي نيابة عنك.

حزمة NPM

قم بتثبيت وتشغيل خادم MCP محليًا باستخدام NPM.
# Set your API key
export DODO_PAYMENTS_API_KEY="dodo_test_..."

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

دوكر

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

# Run the container
docker run -e DODO_PAYMENTS_API_KEY="dodo_test_..." \
  -p 3000:3000 \
  ghcr.io/dodopayments/mcp:latest
تتوفر صور دوكر على GitHub Container Registry.

تكوين العميل

قم بتكوين خادم MCP لمدفوعات دودي في عميل الذكاء الاصطناعي المفضل لديك.
قم بإعداد خادم MCP لمدفوعات دودي في كورسر لتمكين الوصول التفاعلي إلى بيانات مدفوعاتك.
1

فتح إعدادات كورسر

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

تحرير التكوين

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

إضافة تكوين مدفوعات دودي

اختر أحد التكوينات التالية:الخادم عن بُعد (موصى به)
{
  "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_..."
      }
    }
  }
}
4

حفظ وإعادة التشغيل

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

تصفية الأدوات

تحكم في العمليات التي يتم عرضها لمساعدك الذكي لتحسين الأداء والحفاظ على الأمان.

تصفية حسب نوع العملية

تقييد الوصول إلى عمليات القراءة فقط أو الكتابة.
# Only expose read operations (GET requests)
npx dodopayments-mcp --operation=read

# Only expose write operations (POST, PUT, DELETE)
npx dodopayments-mcp --operation=write
استخدم --operation=read أثناء التطوير لمنع التعديلات غير المقصودة على بياناتك.

تصفية حسب المورد

تحديد الأدوات لموارد واجهة برمجة التطبيقات المحددة.
# Only expose payment-related tools
npx dodopayments-mcp --resource=payments

# Expose multiple resources
npx dodopayments-mcp --resource=payments --resource=customers

تضمين أو استبعاد أدوات محددة

ضبط أي الأدوات الفردية متاحة.
# Include only specific tools
npx dodopayments-mcp --tool=create_payments --tool=list_payments

# Exclude specific tools
npx dodopayments-mcp --no-tool=delete_products

# List all available tools
npx dodopayments-mcp --list

دمج الفلاتر

تطبيق فلاتر متعددة في وقت واحد للتحكم الدقيق.
# Only payment and subscription read operations
npx dodopayments-mcp --operation=read --resource=payments --resource=subscriptions

الاستخدام المتقدم

التكامل البرمجي

بناء خوادم MCP مخصصة أو توسيع الخادم الحالي برمجيًا.
import { server, endpoints, init } from "dodopayments-mcp/server";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

// Initialize with all default endpoints
init({ server, endpoints });

// Start the server
const transport = new StdioServerTransport();
await server.connect(transport);

تطوير أدوات مخصصة

توسيع خادم MCP بأدواتك ومنطق الأعمال الخاص بك.
import { server, init } from "dodopayments-mcp/server";
import createPayments from "dodopayments-mcp/tools/payments/create-payments";
import { zodToJsonSchema } from "zod-to-json-schema";
import { z } from "zod";

// Define a custom tool
const customTool = {
  tool: {
    name: 'calculate_payment_total',
    description: 'Calculate payment total with tax and fees',
    inputSchema: zodToJsonSchema(
      z.object({
        amount: z.number().describe('Base amount in cents'),
        tax_rate: z.number().describe('Tax rate as decimal'),
      })
    ),
  },
  handler: async (client, args) => {
    const total = args.amount * (1 + args.tax_rate);
    return {
      content: [{
        type: 'text',
        text: JSON.stringify({ total, currency: 'usd' }),
      }],
    };
  },
};

// Initialize with custom tools
init({ 
  server, 
  endpoints: [createPayments, customTool] 
});

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

حماية بيانات اعتماد واجهة برمجة التطبيقات الخاصة بك والحفاظ على تكاملات آمنة.
لا تقم أبدًا بالتزام بيانات الاعتماد في التحكم في الإصدارقم بتخزين مفاتيح واجهة برمجة التطبيقات في متغيرات البيئة أو أنظمة إدارة الأسرار الآمنة.
# 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
قم بتدوير المفاتيح بانتظامقم بإنشاء مفاتيح واجهة برمجة التطبيقات جديدة بشكل دوري وألغِ صلاحية القديمة من خلال لوحة معلومات مدفوعات دودي الخاصة بك.استخدم مفاتيح الاختبار للتطويراستخدم دائمًا مفاتيح واجهة برمجة التطبيقات في وضع الاختبار أثناء التطوير لتجنب التأثير على بيانات الإنتاج.
تطبيق تصفية الأدوات في الإنتاجتقييد العمليات المعروضة فقط لما يحتاجه مساعدك الذكي.
# Production: read-only access
npx dodopayments-mcp --operation=read

# Development: full access
npx dodopayments-mcp
تنفيذ المصادقة لنقاط النهاية المخصصةتحقق من الطلبات وفرض التفويض في معالجات الأدوات المخصصة الخاصة بك.مراقبة استخدام واجهة برمجة التطبيقاتتتبع نشاط خادم MCP من خلال لوحة معلومات مدفوعات دودي الخاصة بك وقم بإعداد تنبيهات للأنماط غير العادية.
استخدم HTTPS للخوادم عن بُعدقم دائمًا بنشر خوادم MCP عن بُعد خلف نقاط نهاية HTTPS.تنفيذ تحديد المعدلحماية ضد الإساءة من خلال تنفيذ حدود المعدل على كل من خادم MCP وواجهات برمجة التطبيقات.تقييد الوصول إلى الشبكةقم بتكوين قواعد جدار الحماية لتحديد العملاء الذين يمكنهم الاتصال بخادم MCP الخاص بك.

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

تحقق من مفتاح واجهة برمجة التطبيقات الخاص بكتأكد من تعيين مفتاح واجهة برمجة التطبيقات الخاص بك بشكل صحيح وأن لديه الأذونات اللازمة.
# Test your API key
curl -H "Authorization: Bearer dodo_test_..." \
  https://api.dodopayments.com/payments
تحقق من اتصال الشبكة الخاص بكتحقق من أنك تستطيع الوصول إلى نقاط نهاية واجهة برمجة تطبيقات مدفوعات دودي.راجع سجلات العميلقم بتمكين تسجيل مفصل في عميل MCP الخاص بك لتشخيص مشكلات الاتصال.
تأكيد بيئة مفتاح واجهة برمجة التطبيقاتتأكد من أنك تستخدم مفاتيح الاختبار مع نقاط نهاية الاختبار ومفاتيح مباشرة مع نقاط نهاية الإنتاج.تحقق من أذونات المفتاحتحقق من أن مفتاح واجهة برمجة التطبيقات الخاص بك لديه الأذونات للعمليات التي تحاول تنفيذها.إعادة إنشاء بيانات الاعتمادإذا استمرت المشكلات، قم بإنشاء مفتاح واجهة برمجة تطبيقات جديد من خلال لوحة المعلومات الخاصة بك.
تحقق من معلمات الإدخالتأكد من أن المساعد الذكي يقدم معلمات بتنسيق صحيح لكل أداة.راجع رسائل الخطأتحقق من استجابة الخطأ من واجهة برمجة التطبيقات للحصول على إرشادات محددة حول ما حدث خطأ.اختبر مباشرة مع واجهة برمجة التطبيقاتتحقق مما إذا كانت العملية تعمل عند استدعاء واجهة برمجة تطبيقات مدفوعات دودي مباشرة عبر curl أو Postman.

الموارد