Dodo Payments MCP Server

Overview

Model Context Protocol (MCP) هو معيار مفتوح يتيح لتطبيقات الذكاء الاصطناعي الاتصال بمصادر البيانات وواجهات API الخارجية. يتيح Dodo Payments MCP Server لمساعدي الذكاء الاصطناعي مثل Claude وCursor وغيرهما من العملاء المتوافقين مع MCP الوصول إلى بنية المدفوعات الخاصة بك. يستخدم Dodo Payments MCP Server بنية Code Mode. وبدلاً من إتاحة مئات الأدوات الفردية لكل نقطة نهاية في API، يتيح Code Mode لوكلاء الذكاء الاصطناعي كتابة وتنفيذ TypeScript code باستخدام Dodo Payments SDK في بيئة sandbox معزولة.

الإمكانات الرئيسية

عمليات الدفع — إنشاء المدفوعات والمبالغ المستردة واستردادها وإدارتها
إدارة الاشتراكات — التعامل مع الفوترة المتكررة والترقيات والإلغاءات
إدارة العملاء — إدارة بيانات العملاء والوصول إلى البوابة
كتالوج المنتجات — إنشاء المنتجات والأسعار والخصومات وتحديثها
إدارة التراخيص — تنشيط تراخيص البرامج والتحقق منها وإدارتها
الفوترة المستندة إلى الاستخدام — تتبع الاستخدام المقاس وإصدار الفواتير عنه

How Code Mode Works

يوفر Dodo Payments MCP Server لوكيل الذكاء الاصطناعي أداتين:

أداة البحث في المستندات — تستعلم عن المستندات المتعلقة بـ Dodo Payments API وSDK لفهم العمليات والمعلمات المتاحة.
أداة تنفيذ التعليمات البرمجية — تكتب TypeScript code باستخدام SDK، ثم تنفذه في بيئة sandbox آمنة.

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

يمكن للوكلاء تسلسل استدعاءات API متعددة، والتعامل مع المنطق الشرطي، وإجراء العمليات الحسابية دون العودة ذهاباً وإياباً إلى LLM.

الإعداد السريع

اتصل بخادم MCP الخاص بـ Dodo Payments في عميل الذكاء الاصطناعي الخاص بك:

Agent Plugin (recommended)
Cursor
Claude Desktop
Windsurf
Claude Code

يُثبّت Dodo Agent Plugin كلاً من خوادم MCP وجميع المهارات السبع عشرة في خطوة واحدة لـ Claude Code وCodex CLI وCursor وVS Code / GitHub Copilot وKiro وOpenCode (يحتاج OpenCode إلى إعداد إضافي واحد هو skills.paths). يحصل Gemini CLI على خادمي MCP فقط، لأنه لا يتضمن آلية للمهارات الخاصة بالوكلاء. راجع دليل وكلاء البرمجة بالذكاء الاصطناعي لمعرفة أوامر التثبيت الخاصة بكل وكيل.إذا لم يكن وكيلك في تلك القائمة، استخدم علامات التبويب أدناه لتكوين خادم MCP مباشرةً.

أضف إلى ~/.cursor/mcp.json:

{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/mcp"]
    }
  }
}

أضف إلى إعدادات Claude Desktop الخاصة بك:

{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/mcp"]
    }
  }
}

مواقع ملفات التكوين:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
ويندوز: %APPDATA%\Claude\claude_desktop_config.json
لينكس: ~/.config/Claude/claude_desktop_config.json

أضف إلى ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/mcp"]
    }
  }
}

قم بتشغيل في الطرفية الخاصة بك:

claude mcp add dodopayments -- npx -y mcp-remote@latest https://mcp.dodopayments.com/mcp

يتطلب Node.js 18 أو إصداراً أحدث. يستخدم الخادم البعيد OAuth للمصادقة. عند الاتصال لأول مرة، سيُطلب منك إدخال API key واختيار بيئتك.

Dodo Knowledge MCP

بالإضافة إلى Dodo Payments MCP Server (لتنفيذ عمليات API)، نوفر Dodo Knowledge MCP—وهو خادم بحث دلالي يتيح لمساعدي الذكاء الاصطناعي الوصول الفوري إلى مستندات Dodo Payments.

تم إنشاؤه باستخدام ContextMCP.ai: يتم تشغيل Dodo Knowledge MCP بواسطة ContextMCP، مما يمكّن البحث الدلالي السريع عبر الوثائق لدينا باستخدام تضمينات المتجهات.

ما هو Dodo Knowledge MCP؟

Dodo Knowledge MCP هو خادم MCP بعيد يوفر بحثاً دلالياً في المستندات. اعثر على المستندات ذات الصلة باستخدام استعلامات باللغة الطبيعية، واحصل على معلومات دقيقة ومحدثة حول Dodo Payments، واتصل دون الحاجة إلى API keys أو تثبيت محلي.

إعداد سريع

اتصل بـ Dodo Knowledge MCP من عميل الذكاء الاصطناعي لديك:

Cursor
Claude Desktop
Windsurf
Claude Code

أضفه إلى ~/.cursor/mcp.json:

{
  "mcpServers": {
    "dodo-knowledge": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://knowledge.dodopayments.com/mcp"]
    }
  }
}

أضفه إلى إعدادات Claude Desktop:

{
  "mcpServers": {
    "dodo-knowledge": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://knowledge.dodopayments.com/mcp"]
    }
  }
}

مواقع ملفات الإعداد:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

أضفه إلى ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "dodo-knowledge": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://knowledge.dodopayments.com/mcp"]
    }
  }
}

شغّله في terminal:

claude mcp add dodo-knowledge -- npx -y mcp-remote@latest https://knowledge.dodopayments.com/mcp

يتطلب Node.js 18 أو إصداراً أحدث. تتولى حزمة mcp-remote الاتصال بخادم MCP البعيد.

استخدام خادمي MCP معاً

للحصول على أفضل تجربة تطوير بمساعدة الذكاء الاصطناعي، استخدم خادمي MCP معاً:

الخادم	الغرض	حالة الاستخدام
Dodo Knowledge MCP	البحث في المستندات	”كيف أتعامل مع webhooks؟”، “ما طرق الدفع المدعومة؟“
Dodo Payments MCP	عمليات API	إنشاء المدفوعات وإدارة الاشتراكات ومعالجة المبالغ المستردة

{
  "mcpServers": {
    "dodo-knowledge": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://knowledge.dodopayments.com/mcp"]
    },
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/mcp"]
    }
  }
}

بعد إعداد الخادمين، يمكن لوكيلك البحث في المستندات لفهم إحدى الميزات، ثم تنفيذ استدعاءات API لتطبيقها، وكل ذلك في محادثة واحدة.

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

إذا واجهت مشكلات في الاتصال، فامسح ذاكرة التخزين المؤقت للمصادقة في MCP باستخدام rm -rf ~/.mcp-auth، ثم أعد تشغيل تطبيق العميل، وتحقق من سجلات العميل بحثاً عن رسائل الخطأ، وتأكد من إصدار Node.js (يتطلب 18 أو أحدث).

Knowledge MCP Server

الوصول إلى صفحة إعداد Dodo Knowledge MCP

التثبيت

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

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

يمكنك الوصول إلى خادم MCP المستضاف دون إعداد أو تثبيت محلي.

Access the remote server

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

Configure your MCP client

انسخ إعداد JSON المقدم للعميل الخاص بك. بالنسبة إلى Cursor أو Claude Desktop، أضف هذا إلى إعدادات MCP لديك:

{
  "mcpServers": {
    "dodopayments_api": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/mcp"]
    }
  }
}

Authenticate and configure

ستطلب منك عملية OAuth ما يلي:

إدخال Dodo Payments API key الخاص بك
اختيار بيئتك (test أو live)
اختيار نوع عميل MCP الخاص بك

احتفظ بـ API key في مكان آمن. استخدم مفاتيح وضع الاختبار أثناء التطوير.

Complete setup

انقر على Login and Approve لتفويض الاتصال.

بعد الاتصال، يمكن لمساعد الذكاء الاصطناعي التفاعل مع Dodo Payments API نيابةً عنك.

حزمة NPM

ثبّت خادم MCP وشغّله محلياً.

يشغّل الخادم المحلي التعليمات البرمجية الخاصة بك في بيئة sandbox من Deno. ثبّت Deno 2.8 أو إصداراً أقدم، وتأكد من وجود deno في PATH؛ إذ يفشل تشغيل البيئة sandbox في Deno 2.9 والإصدارات الأحدث. يعمل تنفيذ التعليمات البرمجية محلياً على macOS وLinux فقط. في Windows، استخدم الخادم البعيد أو شغّل الخادم المحلي ضمن WSL2.

NPX (No Installation)
MCP Client Configuration

# Set your environment variables
export DODO_PAYMENTS_API_KEY="dodo_test_..."
export DODO_PAYMENTS_WEBHOOK_KEY="your_webhook_key"
export DODO_PAYMENTS_ENVIRONMENT="test_mode"

# Run the latest version
npx -y dodopayments-mcp@latest

{
  "mcpServers": {
    "dodopayments_api": {
      "command": "npx",
      "args": ["-y", "dodopayments-mcp@latest"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "dodo_test_...",
        "DODO_PAYMENTS_WEBHOOK_KEY": "your_webhook_key",
        "DODO_PAYMENTS_ENVIRONMENT": "test_mode"
      }
    }
  }
}

استخدم @latest لسحب أحدث إصدار دائماً، أو ثبّت إصداراً محدداً مثل @2.51.0 لضمان الاستقرار.

Docker

شغّل خادم MCP داخل container.

# Pull the latest image
docker pull ghcr.io/dodopayments/mcp:latest

# Run the container (-i keeps stdin open for the stdio transport)
docker run -i -e DODO_PAYMENTS_API_KEY="dodo_test_..." \
  -e DODO_PAYMENTS_WEBHOOK_KEY="your_webhook_key" \
  -e DODO_PAYMENTS_ENVIRONMENT="test_mode" \
  ghcr.io/dodopayments/mcp:latest

تتوفّر صور Docker على GitHub Container Registry.

إعداد العميل

قم بإعداد خادم Dodo Payments MCP في عميل AI المفضّل لديك.

قم بإعداد خادم Dodo Payments MCP في Cursor لتمكين الوصول الحواري إلى بيانات المدفوعات الخاصة بك.التثبيت بنقرة واحدةاستخدم الزر أدناه لتثبيت خادم MCP مباشرةً في Cursor:[ إضافة إلى Cursor

](https://cursor.com/en-US/install-mcp?name=dodopayments-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRvZG9wYXltZW50cy1tY3AiXSwiZW52Ijp7IkRPRE9fUEFZTUVOVFNfQVBJX0tFWSI6IlNldCB5b3VyIERPRE9fUEFZTUVOVFNfQVBJX0tFWSBoZXJlLiIsIkRPRE9fUEFZTUVOVFNfV0VCSE9PS19LRVkiOiJTZXQgeW91ciBET0RPX1BBWU1FTlRTX1dFQkhPT0tfS0VZIGhlcmUuIn19)بعد النقر، اضبط متغيرات البيئة في mcp.json الخاص بـ Cursor عبر إعدادات Cursor > Tools & MCP > New MCP Server.الإعداد اليدوي

Open Cursor settings

انتقل إلى إعدادات Cursor > Tools & MCP أو اضغط على Cmd/Ctrl + Shift + P وابحث عن “MCP Settings”.

Edit configuration

انقر على New MCP Server لفتح ملف mcp.json.

Add Dodo Payments configuration

اختر أحد الإعدادات التالية:Remote Server (Recommended)

{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/mcp"]
    }
  }
}

Local NPX

{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "dodopayments-mcp@latest"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "dodo_test_...",
        "DODO_PAYMENTS_WEBHOOK_KEY": "your_webhook_key"
      }
    }
  }
}

Save and restart

احفظ ملف الإعداد وأعد تشغيل Cursor.

تحقّق من الاتصال عبر سؤال مساعد AI عن بيانات Dodo Payments الخاصة بك.

قم بإعداد خادم Dodo Payments MCP في Claude Desktop لتمكين الوصول الحواري إلى بيانات المدفوعات الخاصة بك.

Locate configuration file

ابحث عن ملف إعداد Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Edit configuration

افتح الملف في محرر نصوص وأضف إعداد Dodo Payments:Remote Server (Recommended)

{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/mcp"]
    }
  }
}

Local NPX

{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "dodopayments-mcp@latest"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "dodo_test_...",
        "DODO_PAYMENTS_WEBHOOK_KEY": "your_webhook_key"
      }
    }
  }
}

Restart Claude Desktop

أغلق Claude Desktop وأعد فتحه لتطبيق التغييرات.

ابحث عن أيقونة 🔌 في Claude Desktop للتأكد من اتصال خادم MCP.

قم بإعداد خادم Dodo Payments MCP في Claude Code CLI.شغّل الأمر التالي في الطرفية:

claude mcp add --transport stdio dodopayments_api \
  --env DODO_PAYMENTS_API_KEY="dodo_test_..." \
  DODO_PAYMENTS_WEBHOOK_KEY="your_webhook_key" \
  -- npx -y dodopayments-mcp

سيُخزَّن الإعداد في ملف .claude.json الموجود في الدليل الرئيسي الخاص بك.

يقرأ Claude Code متغيرات البيئة تلقائيًا من shell، لذا يمكنك أيضًا تصديرها قبل تشغيل الأمر.

قم بإعداد خادم Dodo Payments MCP في VS Code.التثبيت بنقرة واحدةفتح VS Codeبعد النقر، اضبط متغيرات البيئة في mcp.json الخاص بـ VS Code عبر لوحة الأوامر > MCP: Open User Configuration.الإعداد اليدوي

Open MCP configuration

افتح لوحة الأوامر (Cmd/Ctrl + Shift + P) وابحث عن “MCP: Open User Configuration”.

Add server configuration

أضف خادم Dodo Payments MCP:

{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "dodopayments-mcp@latest"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "dodo_test_...",
        "DODO_PAYMENTS_WEBHOOK_KEY": "your_webhook_key"
      }
    }
  }
}

Reload window

أعد تحميل VS Code (Cmd/Ctrl + Shift + P > “Reload Window”) لتفعيل خادم MCP.

قم بإعداد خادم Dodo Payments MCP في Cline (VS Code) لتمكين الوصول الحواري إلى بيانات المدفوعات الخاصة بك.

Open Cline settings

حدّد موقع ملف إعداد Cline:

macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

Configure MCP server

أضف إعداد خادم Dodo Payments MCP:

{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "dodopayments-mcp@latest"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "dodo_test_...",
        "DODO_PAYMENTS_WEBHOOK_KEY": "your_webhook_key"
      }
    }
  }
}

Reload VS Code

أعد تحميل نافذة VS Code (Cmd/Ctrl + Shift + P > “Reload Window”) لتفعيل اتصال خادم MCP.

قم بإعداد خادم Dodo Payments MCP في Zed لتمكين الوصول الحواري إلى بيانات المدفوعات الخاصة بك.

Open Zed settings

انتقل إلى Settings > Assistant > Model Context Protocol.

Add server configuration

أضف الإعداد التالي:

{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "dodopayments-mcp@latest"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "dodo_test_...",
        "DODO_PAYMENTS_WEBHOOK_KEY": "your_webhook_key"
      }
    }
  }
}

Save and verify

احفظ الإعداد. يجب أن يصبح خادم MCP متاحًا الآن في مساعد AI الخاص بـ Zed.

قم بإعداد خادم Dodo Payments MCP في عملاء MCP المتوافقين الآخرين.Remote Server (Recommended)

{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/mcp"]
    }
  }
}

Local NPX

{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "dodopayments-mcp@latest"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "dodo_test_...",
        "DODO_PAYMENTS_WEBHOOK_KEY": "your_webhook_key"
      }
    }
  }
}

تفضّل بزيارة modelcontextprotocol.io/clients للاطلاع على قائمة كاملة بعملاء MCP المتوافقين وطرق إعدادهم.

متغيرات البيئة

اضبط سلوك خادم MCP باستخدام متغيرات البيئة.

المتغير	الوصف	مطلوب
`DODO_PAYMENTS_API_KEY`	مفتاح API الخاص بـ Dodo Payments	نعم
`DODO_PAYMENTS_WEBHOOK_KEY`	مفتاح توقيع webhook الخاص بك	لا
`DODO_PAYMENTS_ENVIRONMENT`	`live_mode` أو `test_mode`؛ القيمة الافتراضية هي `live_mode`	لا

التشغيل عن بُعد

انشر خادم MCP كخادم HTTP بعيد للعملاء المستندين إلى الويب أو مسارات العمل القائمة على الوكلاء.

# Start as remote server
npx -y dodopayments-mcp --transport=http

# Specify a custom port
npx -y dodopayments-mcp --transport=http --port=3000

إعداد الخادم البعيد

بعد النشر، يمكن للعملاء الاتصال باستخدام عنوان URL للخادم:

{
  "mcpServers": {
    "dodopayments_api": {
      "url": "http://localhost:3000",
      "headers": {
        "Authorization": "Bearer your_api_key"
      }
    }
  }
}

ترويسات التفويض

يقبل الخادم البعيد المصادقة عبر الترويسات التالية:

الترويسة	الغرض
`Authorization`	مصادقة باستخدام Bearer token
`x-dodo-payments-api-key`	ترويسة API key مباشرة

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

يوفّر Code Mode أمانًا مدمجًا من خلال تنفيذ التعليمات البرمجية في بيئة معزولة وحقن مفاتيح API من جهة الخادم. اتبع أفضل الممارسات التالية لحماية بيانات اعتمادك.

API Key Management

لا ترفع بيانات الاعتماد إلى نظام التحكم في الإصدارات. خزّن مفاتيح API في متغيرات البيئة أو أنظمة آمنة لإدارة الأسرار:

# 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

دوّر المفاتيح بانتظام عبر إنشاء مفاتيح API جديدة دوريًا وإلغاء المفاتيح القديمة من خلال لوحة تحكم Dodo Payments. استخدم دائمًا مفاتيح API الخاصة بوضع الاختبار أثناء التطوير لتجنب التأثير في بيانات الإنتاج.

Access Control

عند النشر عن بُعد، اطلب دائمًا المصادقة عبر ترويسة Authorization أو ترويسة x-dodo-payments-api-key.

Network Security

انشر دائمًا خوادم MCP البعيدة خلف نقاط نهاية HTTPS. احمِ الخادم من إساءة الاستخدام عبر تطبيق حدود لمعدل الطلبات على مستوى خادم MCP وAPI. اضبط قواعد جدار الحماية لتحديد العملاء الذين يمكنهم الاتصال بخادم MCP.

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

Connection issues

تحقّق من ضبط مفتاح API بشكل صحيح ومن امتلاكه للأذونات اللازمة:

# Test your API key
curl -H "Authorization: Bearer dodo_test_..." \
  https://test.dodopayments.com/payments

تحقّق من إمكانية الوصول إلى نقاط نهاية Dodo Payments API. فعّل التسجيل المطوّل في عميل MCP لتشخيص مشكلات الاتصال.

Authentication errors

تأكّد من استخدام مفاتيح الاختبار مع نقاط نهاية الاختبار، والمفاتيح المباشرة مع نقاط نهاية الإنتاج. تحقّق من ضبط DODO_PAYMENTS_ENVIRONMENT بشكل صحيح (live_mode للإنتاج). إذا استمرت المشكلات، فأنشئ مفتاح API جديدًا من خلال لوحة التحكم.

Tool execution failures

تأكّد من أن مساعد AI يقدّم معلمات منسّقة بشكل صحيح لكل أداة. تحقّق من استجابة الخطأ الصادرة عن API للحصول على إرشادات محددة حول المشكلة. تحقّق من نجاح العملية عند استدعاء Dodo Payments API مباشرةً عبر curl أو Postman.

لماذا Code Mode

تعاني تطبيقات MCP التقليدية من “تضخم الأدوات”، حيث يتم عرض كل نقطة نهاية API كأداة منفصلة. ويُعد Code Mode أفضل لعدة أسباب:

تتفوّق LLMs في كتابة التعليمات البرمجية على استدعاء الأدوات

تُدرَّب LLMs على ملايين الأسطر من التعليمات البرمجية الواقعية، لذا تكتب النصوص البرمجية بشكل جيد طبيعيًا. وغالبًا ما يعتمد استدعاء الأدوات على أمثلة اصطناعية.

“إن جعل LLM ينفّذ المهام عبر استدعاء الأدوات يشبه إخضاع Shakespeare لدورة مدتها شهر في اللغة المندرينية ثم مطالبته بكتابة مسرحية بها.” — Cloudflare

يزيل تضخم نافذة السياق

في الأساليب التقليدية، تستهلك كل مواصفة أداة رموزًا قبل بدء المحادثة. وقد يؤدي عرض أكثر من 50 أداة إلى استهلاك 55K–100K+ من الرموز. ووجدت Anthropic أن مواصفات الأدوات قد تستهلك ما يصل إلى 134K رمزًا قبل التحسين. يحمّل Code Mode مواصفتَي أداتين فقط (~1K رمز). ويبحث الوكيل في الوثائق عند الحاجة. حافظت أداة Tool Search Tool من Anthropic على 95% من نافذة السياق، ما خفّض الحمل من 77K إلى 8.7K من الرموز.

يقلّل زمن الاستجابة عبر التنسيق البرمجي

يتطلب استدعاء الأدوات التقليدي جولة استدلال كاملة للنموذج لكل عملية. إذا تطلبت مهمة ما 20 استدعاءً لـ API، فهذا يعني 20 جولة ذهابًا وإيابًا. أما في Code Mode، فيكتب الوكيل نصًا برمجيًا واحدًا ينفّذ جميع الاستدعاءات ويعيد النتيجة النهائية فقط. لاحظت Anthropic انخفاضًا بنسبة 37% في عدد الرموز وتحسّنًا في الدقة (إذ تحسّن استرجاع المعرفة من 25.6% إلى 28.5%) باستخدام هذا الأسلوب.

أمان أكبر من خلال التصميم

يوفّر Code Mode مزايا أمان مدمجة:

لا توجد مفاتيح API في المعلمات — يتم حقن مفاتيح API من جهة الخادم ولا تظهر مطلقًا في معلمات الأدوات المرسلة إلى LLM.
بيئة معزولة — تعمل التعليمات البرمجية في بيئة آمنة لا تصل إلى الشبكة أو نظام ملفات المضيف.
SDK مضبوط — لا تتوفر للوكيل إلا أساليب SDK المصرّح بها.

يتوسع مع أي حجم لـ API

مع نمو API، يتدهور أداء MCP التقليدي بسبب ضرورة تحميل المزيد من الأدوات. بينما يظل Code Mode ثابتًا باستخدام أداتين بغض النظر عن حجم سطح API. وقد قلّصت Cloudflare أكثر من 2,500 نقطة نهاية API إلى أداتين ونحو 1,000 رمز من السياق.

لمزيد من التفاصيل، راجع مدونات الهندسة من Anthropic وCloudflare، ووثائق Programmatic Tool Calling من Claude.

الموارد

API Reference

استكشف وثائق Dodo Payments API الكاملة

MCP Protocol

تعرّف على المزيد حول معيار Model Context Protocol

GitHub Repository

اطّلع على التعليمات البرمجية المصدرية لخادم MCP وساهم فيها

NPM Package

ثبّت خادم MCP من NPM

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Overview

الإمكانات الرئيسية

How Code Mode Works

الإعداد السريع

Dodo Knowledge MCP

ما هو Dodo Knowledge MCP؟

إعداد سريع

استخدام خادمي MCP معاً

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

Knowledge MCP Server

التثبيت

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

حزمة NPM

Docker

إعداد العميل

متغيرات البيئة

التشغيل عن بُعد

إعداد الخادم البعيد

ترويسات التفويض

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

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

لماذا Code Mode

تتفوّق LLMs في كتابة التعليمات البرمجية على استدعاء الأدوات

يزيل تضخم نافذة السياق

يقلّل زمن الاستجابة عبر التنسيق البرمجي

أمان أكبر من خلال التصميم

يتوسع مع أي حجم لـ API

الموارد

API Reference

MCP Protocol

GitHub Repository

NPM Package

​Overview

​الإمكانات الرئيسية

​How Code Mode Works

​الإعداد السريع

​Dodo Knowledge MCP

​ما هو Dodo Knowledge MCP؟

​إعداد سريع

​استخدام خادمي MCP معاً

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

Knowledge MCP Server

​التثبيت

​خادم MCP بعيد (موصى به)

​حزمة NPM

​Docker

​إعداد العميل

​متغيرات البيئة

​التشغيل عن بُعد

​إعداد الخادم البعيد

​ترويسات التفويض

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

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

​لماذا Code Mode

​تتفوّق LLMs في كتابة التعليمات البرمجية على استدعاء الأدوات

​يزيل تضخم نافذة السياق

​يقلّل زمن الاستجابة عبر التنسيق البرمجي

​أمان أكبر من خلال التصميم

​يتوسع مع أي حجم لـ API

​الموارد

API Reference

MCP Protocol

GitHub Repository

NPM Package

Overview

الإمكانات الرئيسية

How Code Mode Works

الإعداد السريع

Dodo Knowledge MCP

ما هو Dodo Knowledge MCP؟

إعداد سريع

استخدام خادمي MCP معاً

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

التثبيت

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

حزمة NPM

Docker

إعداد العميل

متغيرات البيئة

التشغيل عن بُعد

إعداد الخادم البعيد

ترويسات التفويض

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

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

لماذا Code Mode

تتفوّق LLMs في كتابة التعليمات البرمجية على استدعاء الأدوات

يزيل تضخم نافذة السياق

يقلّل زمن الاستجابة عبر التنسيق البرمجي

أمان أكبر من خلال التصميم

يتوسع مع أي حجم لـ API

الموارد