تمكين المساعدين الذكيين من التفاعل مع واجهة برمجة تطبيقات مدفوعات دودي من خلال بروتوكول سياق النموذج (MCP) لعمليات الدفع السلسة، وإدارة الاشتراكات، وتفاعلات العملاء.
بروتوكول سياق النموذج (MCP) هو معيار مفتوح يمكّن تطبيقات الذكاء الاصطناعي من الاتصال بشكل آمن بمصادر البيانات الخارجية وواجهات برمجة التطبيقات. يوفر خادم مدفوعات دودي للمساعدين الذكيين مثل كلود، وكورسر، وغيرهم من العملاء المتوافقين مع MCP وصولاً منظمًا إلى بنية الدفع الخاصة بك.
# Pull the latest imagedocker pull ghcr.io/dodopayments/mcp:latest# Run the containerdocker run -e DODO_PAYMENTS_API_KEY="dodo_test_..." \ -p 3000:3000 \ ghcr.io/dodopayments/mcp:latest
# Include only specific toolsnpx dodopayments-mcp --tool=create_payments --tool=list_payments# Exclude specific toolsnpx dodopayments-mcp --no-tool=delete_products# List all available toolsnpx dodopayments-mcp --list
بناء خوادم MCP مخصصة أو توسيع الخادم الحالي برمجيًا.
نسخ
import { server, endpoints, init } from "dodopayments-mcp/server";import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";// Initialize with all default endpointsinit({ server, endpoints });// Start the serverconst transport = new StdioServerTransport();await server.connect(transport);
حماية بيانات اعتماد واجهة برمجة التطبيقات الخاصة بك والحفاظ على تكاملات آمنة.
إدارة مفتاح واجهة برمجة التطبيقات
لا تقم أبدًا بالتزام بيانات الاعتماد في التحكم في الإصدارقم بتخزين مفاتيح واجهة برمجة التطبيقات في متغيرات البيئة أو أنظمة إدارة الأسرار الآمنة.
نسخ
# Use environment variablesexport DODO_PAYMENTS_API_KEY="dodo_test_..."# Use a .env file (add to .gitignore)echo "DODO_PAYMENTS_API_KEY=dodo_test_..." > .env
قم بتدوير المفاتيح بانتظامقم بإنشاء مفاتيح واجهة برمجة التطبيقات جديدة بشكل دوري وألغِ صلاحية القديمة من خلال لوحة معلومات مدفوعات دودي الخاصة بك.استخدم مفاتيح الاختبار للتطويراستخدم دائمًا مفاتيح واجهة برمجة التطبيقات في وضع الاختبار أثناء التطوير لتجنب التأثير على بيانات الإنتاج.
التحكم في الوصول
تطبيق تصفية الأدوات في الإنتاجتقييد العمليات المعروضة فقط لما يحتاجه مساعدك الذكي.
نسخ
# Production: read-only accessnpx dodopayments-mcp --operation=read# Development: full accessnpx dodopayments-mcp
تنفيذ المصادقة لنقاط النهاية المخصصةتحقق من الطلبات وفرض التفويض في معالجات الأدوات المخصصة الخاصة بك.مراقبة استخدام واجهة برمجة التطبيقاتتتبع نشاط خادم MCP من خلال لوحة معلومات مدفوعات دودي الخاصة بك وقم بإعداد تنبيهات للأنماط غير العادية.
أمان الشبكة
استخدم HTTPS للخوادم عن بُعدقم دائمًا بنشر خوادم MCP عن بُعد خلف نقاط نهاية HTTPS.تنفيذ تحديد المعدلحماية ضد الإساءة من خلال تنفيذ حدود المعدل على كل من خادم MCP وواجهات برمجة التطبيقات.تقييد الوصول إلى الشبكةقم بتكوين قواعد جدار الحماية لتحديد العملاء الذين يمكنهم الاتصال بخادم MCP الخاص بك.
تحقق من مفتاح واجهة برمجة التطبيقات الخاص بكتأكد من تعيين مفتاح واجهة برمجة التطبيقات الخاص بك بشكل صحيح وأن لديه الأذونات اللازمة.
نسخ
# Test your API keycurl -H "Authorization: Bearer dodo_test_..." \ https://api.dodopayments.com/payments
تحقق من اتصال الشبكة الخاص بكتحقق من أنك تستطيع الوصول إلى نقاط نهاية واجهة برمجة تطبيقات مدفوعات دودي.راجع سجلات العميلقم بتمكين تسجيل مفصل في عميل MCP الخاص بك لتشخيص مشكلات الاتصال.
أخطاء المصادقة
تأكيد بيئة مفتاح واجهة برمجة التطبيقاتتأكد من أنك تستخدم مفاتيح الاختبار مع نقاط نهاية الاختبار ومفاتيح مباشرة مع نقاط نهاية الإنتاج.تحقق من أذونات المفتاحتحقق من أن مفتاح واجهة برمجة التطبيقات الخاص بك لديه الأذونات للعمليات التي تحاول تنفيذها.إعادة إنشاء بيانات الاعتمادإذا استمرت المشكلات، قم بإنشاء مفتاح واجهة برمجة تطبيقات جديد من خلال لوحة المعلومات الخاصة بك.
فشل تنفيذ الأداة
تحقق من معلمات الإدخالتأكد من أن المساعد الذكي يقدم معلمات بتنسيق صحيح لكل أداة.راجع رسائل الخطأتحقق من استجابة الخطأ من واجهة برمجة التطبيقات للحصول على إرشادات محددة حول ما حدث خطأ.اختبر مباشرة مع واجهة برمجة التطبيقاتتحقق مما إذا كانت العملية تعمل عند استدعاء واجهة برمجة تطبيقات مدفوعات دودي مباشرة عبر curl أو Postman.