MCP Server

Overview

The Model Context Protocol (MCP) is an open standard that enables AI applications to securely connect to external data sources and APIs. The Dodo Payments MCP Server provides AI assistants like Claude, Cursor, and other MCP-compatible clients with structured access to your payment infrastructure. يستخدم خادم MCP الخاص بـ Dodo Payments بنية وضع الكود. بدلًا من الكشف عن مئات الأدوات الفردية لكل نقطة نهاية في واجهة البرمجة، يتيح وضع الكود لوكلاء الذكاء الاصطناعي كتابة وتنفيذ كود TypeScript باستخدام مجموعة تطوير البرامج الخاصة بـ Dodo Payments في بيئة معزولة.

Key capabilities

Payment Operations: Create, retrieve, and manage payments and refunds
Subscription Management: Handle recurring billing, upgrades, and cancellations
Customer Administration: Manage customer data and portal access
Product Catalog: Create and update products, pricing, and discounts
License Management: Activate, validate, and manage software licenses
Usage-Based Billing: Track and bill for metered usage

How Code Mode Works

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

أداة البحث في الوثائق: تستعلم عن التوثيق الخاص بواجهة برمجة تطبيقات Dodo Payments وSDK لفهم العمليات والمعاملات المتاحة.
أداة تنفيذ الكود: تكتب كود TypeScript ضد SDK ويتم تنفيذه في بيئة رملية آمنة.

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

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

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

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

Cursor
Claude Desktop
Windsurf
Claude Code

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

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

أضف إلى تكوين Claude Desktop الخاص بك:

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

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

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": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}

شغّل في الطرفية الخاصة بك:

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

يتطلب Node.js 18 أو أعلى. يستخدم الخادم البعيد OAuth للمصادقة — سيُطلب منك إدخال مفتاح واجهة برمجة التطبيقات الخاص بك واختيار البيئة عند الاتصال لأول مرة.

Dodo Knowledge MCP

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

بني باستخدام ContextMCP.ai: يستخدم Dodo Knowledge MCP محرك ContextMCP لتمكين بحث دلالي سريع عبر توثيقنا باستخدام تضمينات المتجهات.

ما هو Dodo Knowledge MCP؟

Dodo Knowledge MCP هو خادم MCP بعيد يوفر:

بحث في الوثائق دلالي: العثور على الوثائق ذات الصلة باستخدام استعلامات باللغة الطبيعية.
إجابات سياقية: تحصل مساعدات الذكاء الاصطناعي على معلومات دقيقة ومحدثة حول Dodo Payments.
بدون إعداد: لا حاجة لمفاتيح API أو تثبيت محلي—فقط اتصل وابدأ في الاستعلام.

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

اتصل بـ 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"]
    }
  }
}

شغّل في الطرفية الخاصة بك:

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	البحث في الوثائق	”كيف أتعامل مع الويب هوك؟”، “ما طرق الدفع المدعومة؟“
Dodo Payments MCP	عمليات واجهة برمجة التطبيقات	إنشاء المدفوعات، إدارة الاشتراكات، معالجة الاستردادات

{
  "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/sse"]
    }
  }
}

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

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

إذا واجهت مشكلات في الاتصال:

مسح ذاكرة مصادقة MCP: rm -rf ~/.mcp-auth
إعادة تشغيل تطبيق العميل
فحص سجلات العميل لأية رسائل خطأ
التحقق من إصدار Node.js: يتطلب 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/sse"]
    }
  }
}

Authenticate and configure

سيطلب منك تدفق OAuth ما يلي:

إدخال مفتاح واجهة برمجة تطبيقات Dodo Payments الخاص بك
اختيار البيئة (اختبار أو مباشر)
اختيار نوع عميل MCP الخاص بك

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

Complete setup

انقر على تسجيل الدخول والموافقة للمصادقة على الاتصال.

بمجرد الاتصال، يمكن لمساعدك الذكاء الاصطناعي التفاعل مع واجهة برمجة تطبيقات Dodo Payments نيابةً عنك.

حزمة NPM

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

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="live_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": "live_mode"
      }
    }
  }
}

استخدم @latest للحصول دائمًا على أحدث إصدار، أو ثبّت على إصدار معين مثل @1.0.0 من أجل الاستقرار.

Docker

شغّل خادم MCP في بيئة حاوية لتحقيق نشر متسق.

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

# Run the container
docker run -e DODO_PAYMENTS_API_KEY="dodo_test_..." \
  -e DODO_PAYMENTS_WEBHOOK_KEY="your_webhook_key" \
  -e DODO_PAYMENTS_ENVIRONMENT="live_mode" \
  ghcr.io/dodopayments/mcp:latest

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

تكوين العميل

كوّن خادم MCP الخاص بـ Dodo Payments في عميل الذكاء الاصطناعي المفضل لديك.

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

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

Open Cursor settings

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

Edit configuration

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

Add Dodo Payments configuration

اختر إحدى التكوينات التالية:الخادم البعيد (موصى به)

{
  "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_...",
        "DODO_PAYMENTS_WEBHOOK_KEY": "your_webhook_key"
      }
    }
  }
}

Save and restart

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

تحقق من الاتصال بسؤال مساعد الذكاء الاصطناعي عن بيانات Dodo Payments الخاصة بك.

قم بإعداد خادم MCP الخاص بـ Dodo Payments في 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:الخادم البعيد (موصى به)

{
  "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_...",
        "DODO_PAYMENTS_WEBHOOK_KEY": "your_webhook_key"
      }
    }
  }
}

Restart Claude Desktop

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

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

قم بإعداد خادم MCP الخاص بـ Dodo Payments في 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 تلقائيًا بالتقاط متغيرات البيئة من الصدفة، لذا يمكنك أيضًا تصديرها قبل تشغيل الأمر.

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

Open MCP configuration

افتح لوحة الأوامر (Cmd/Ctrl + Shift + P) وابحث عن “MCP: فتح تكوين المستخدم”.

Add server configuration

أضف خادم MCP الخاص بـ Dodo Payments:

{
  "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 > “إعادة تحميل النافذة”) لتنشيط خادم MCP.

قم بإعداد خادم MCP الخاص بـ Dodo Payments في 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

أضف تكوين خادم MCP الخاص بـ Dodo Payments:

{
  "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 > “إعادة تحميل النافذة”) لتفعيل اتصال خادم MCP.

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

Open Zed settings

انتقل إلى الإعدادات > المساعد > بروتوكول سياق النموذج.

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 متاحًا الآن في مساعد Zed الذكي.

قم بإعداد خادم MCP الخاص بـ Dodo Payments في العملاء المتوافقين مع MCP الآخرين.الخادم البعيد (موصى به)

{
  "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_...",
        "DODO_PAYMENTS_WEBHOOK_KEY": "your_webhook_key"
      }
    }
  }
}

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

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

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

المتغير	الوصف	مطلوب
`DODO_PAYMENTS_API_KEY`	مفتاح واجهة برمجة تطبيقات Dodo Payments الخاص بك	نعم
`DODO_PAYMENTS_WEBHOOK_KEY`	مفتاح توقيع الويب هوك الخاص بك	لا
`DODO_PAYMENTS_ENVIRONMENT`	عين على `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`	مصادقة رمز الحامل
`x-dodo-payments-api-key`	رأس مفتاح API مباشر

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

يوفر وضع الكود أمانًا جوهريًا من خلال تنفيذ الكود في بيئة رملية وحقن مفاتيح 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 الخاصة بك.استخدم مفاتيح اختبار أثناء التطويراستخدم دائمًا مفاتيح وضع الاختبار أثناء التطوير لتجنب التأثير على بيانات الإنتاج.

Access Control

نفّذ المصادقة للخوادم البعيدةعند النشر عن بُعد، اطلب دائمًا المصادقة عبر الرأس Authorization أو الرأس x-dodo-payments-api-key.راقب استخدام APIتتبع نشاط خادم MCP من خلال لوحة تحكم Dodo Payments الخاصة بك وأنشئ تنبيهات للأنماط غير المعتادة.

Network Security

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

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

Connection issues

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

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

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

Authentication errors

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

Tool execution failures

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

لماذا وضع الكود

غالبًا ما تعاني تطبيقات MCP التقليدية من “تكاثر الأدوات”، حيث تُعرَض كل نقطة نهاية من واجهة البرمجة كأداة منفصلة. يعد وضع الكود نهجًا متفوقًا لعدة أسباب:

نماذج اللغة الكبيرة أفضل في كتابة الكود من استدعاء الأدوات

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

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

القضاء على تضخم نافذة السياق

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

تقليل الكمون عبر التنظيم البرنامجي

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

أكثر أمانًا بطبيعتها

يوفر وضع الكود فوائد أمان جوهرية:

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

قابلية التوسع لأي حجم من واجهات البرمجة

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

لمزيد من التفاصيل حول فوائد هذه البنية، اطلع على مدونات الهندسة من Anthropic وCloudflare، ودوكومنتيشن Programmatic Tool Calling من Claude.

الموارد

API Reference

استكشف التوثيق الكامل لواجهة برمجة تطبيقات Dodo Payments

MCP Protocol

تعرّف أكثر على معيار بروتوكول سياق النموذج

GitHub Repository

عرض كود مصدر خادم MCP والمساهمة فيه

NPM Package

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

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Overview

Key capabilities

How Code Mode Works

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

Dodo Knowledge MCP

ما هو Dodo Knowledge MCP؟

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

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

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

Knowledge MCP Server

التثبيت

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

حزمة NPM

Docker

تكوين العميل

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

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

تكوين الخادم البعيد

رؤوس التفويض

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

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

لماذا وضع الكود

نماذج اللغة الكبيرة أفضل في كتابة الكود من استدعاء الأدوات

القضاء على تضخم نافذة السياق

تقليل الكمون عبر التنظيم البرنامجي

أكثر أمانًا بطبيعتها

قابلية التوسع لأي حجم من واجهات البرمجة

الموارد

API Reference

MCP Protocol

GitHub Repository

NPM Package

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

​Overview

​Key capabilities

​How Code Mode Works

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

​Dodo Knowledge MCP

​ما هو Dodo Knowledge MCP؟

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

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

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

Knowledge MCP Server

​التثبيت

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

​حزمة NPM

​Docker

​تكوين العميل

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

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

​تكوين الخادم البعيد

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

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

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

​لماذا وضع الكود

​نماذج اللغة الكبيرة أفضل في كتابة الكود من استدعاء الأدوات

​القضاء على تضخم نافذة السياق

​تقليل الكمون عبر التنظيم البرنامجي

​أكثر أمانًا بطبيعتها

​قابلية التوسع لأي حجم من واجهات البرمجة

​الموارد

API Reference

MCP Protocol

GitHub Repository

NPM Package

Overview

Key capabilities

How Code Mode Works

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

Dodo Knowledge MCP

ما هو Dodo Knowledge MCP؟

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

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

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

التثبيت

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

حزمة NPM

Docker

تكوين العميل

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

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

تكوين الخادم البعيد

رؤوس التفويض

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

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

لماذا وضع الكود

نماذج اللغة الكبيرة أفضل في كتابة الكود من استدعاء الأدوات

القضاء على تضخم نافذة السياق

تقليل الكمون عبر التنظيم البرنامجي

أكثر أمانًا بطبيعتها

قابلية التوسع لأي حجم من واجهات البرمجة

الموارد