طلب الوصول إلى API
MCP

وثائق ADITUS داخل مساعد البرمجة الخاص بك.

خادم MCP عام للقراءة فقط يغطي مرجع API ودليل Micro Frontend. بلا حساب ولا مفتاح: فعّله من أحد الأدلة دون أي إعداد، أو أضف عنوان URL واحدًا، ليرجع Claude أو Cursor أو Copilot أو ChatGPT إلى العقد الحقيقي بدل التخمين.

https://developers.aditus.com/api/mcp

متاح في …

الخادم منشور في هذه الأدلة. فعّله هناك بنقرة واحدة دون ملف إعداد.

  • Claude

    فعّله مباشرة كموصّل في Claude: نقرة واحدة دون أي مقتطف.

    فتح في Claude

  • Official MCP Registry

    إدخال الخادم الرسمي (com.aditus.developers/developer-portal) الذي تستورده العملاء الداعمة للسجل.

    فتح القائمة

  • Glama

    صفحة الموصّل مع نظرة عامة على الأدوات ومفتّش داخل المتصفح.

    فتح القائمة

  • Smithery

    قائمة تتضمن أوامر التثبيت للعديد من العملاء وساحة تجريب مستضافة.

    فتح القائمة

الإعداد اليدوي

مطلوب فقط إذا كان عميلك لا يدعم الأدلة. Streamable HTTP بلا مصادقة ولا حالة جلسة. اختر عميلك:

Claude Code: نفّذ هذا الأمر مرة واحدة في الطرفية، وبعدها يتوفر الخادم في كل جلسة.

Claude Code
claude mcp add --transport http aditus-docs https://developers.aditus.com/api/mcp

Cursor: ضع هذا المحتوى في ‎.cursor/mcp.json داخل مجلد المشروع (أو في ‎~/.cursor/mcp.json لجميع المشاريع).

Cursor · .cursor/mcp.json
{
  "mcpServers": {
    "aditus-docs": {
      "url": "https://developers.aditus.com/api/mcp"
    }
  }
}

VS Code مع Copilot: ضع هذا المحتوى في ‎.vscode/mcp.json داخل مجلد المشروع، أو أضفه إلى إعدادات المستخدم عبر “MCP: Add Server”.

VS Code / Copilot · .vscode/mcp.json
{
  "servers": {
    "aditus-docs": {
      "type": "http",
      "url": "https://developers.aditus.com/api/mcp"
    }
  }
}

Claude Desktop: افتح الإعدادات ← المطوّر ← تعديل الإعدادات، والصق هذا في claude_desktop_config.json ثم أعد تشغيل التطبيق.

Claude Desktop · claude_desktop_config.json
{
  "mcpServers": {
    "aditus-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://developers.aditus.com/api/mcp"]
    }
  }
}

ChatGPT: في الإعدادات ← الموصّلات، أضف موصّلًا مخصصًا بعنوان نقطة النهاية أعلاه؛ لا حاجة لأي مقتطف. لتجربة الخادم دون أي عميل نفّذ هذا في الطرفية:

curl
curl -s https://developers.aditus.com/api/mcp \
  -H 'Accept: application/json, text/event-stream' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"search_docs","arguments":{"query":"create cart"}}}'

العملاء الذين يقرأون بطاقات الخوادم يجدون الخادم نفسه على /.well-known/mcp/server-card.json.

الأدوات

خمس أدوات للقراءة فقط. يأتي المحتوى من لقطة المجموعة المنقّحة نفسها التي يعتمد عليها مرجع API ومرايا Markdown تحت ‎/ai، لذا تتطابق الثلاثة دائمًا.

Toolالوسائطيعيد
search_docsquery, limit?بحث نصي كامل مرتّب حسب الصلة في الوحدات ونقاط النهاية والأدلة.
list_modules–جميع وحدات API مع الاتجاه وعدد نقاط النهاية والروابط، إضافة إلى الأدلة.
list_endpointsmoduleجميع نقاط نهاية وحدة واحدة مع الطريقة والمسار وملخص قصير.
get_endpointendpointالعقد الكامل: المعاملات والترويسات وجسم الطلب وأمثلة الاستجابات.
get_guideguide, section?Markdown لأدلة Micro Frontend (دليل الوكلاء، التوثيق الكامل، النظرة العامة) أو Guidelines أو Webhooks، كاملًا أو قسمًا واحدًا.

أمثلة على الطلبات

ثلاثة أسئلة نموذجية وما يحدث بعد طرحها.

  1. “كيف أنشئ سلة وأضيف تذكرة عبر ADITUS Shop API؟”

    يستدعي المساعد search_docs("create cart add item") ثم get_endpoint لنقطتي النهاية المطابقتين، ويجيب بترتيب الطلبات والترويسات والحقول الإلزامية مع مثال على الاستجابة.

  2. “كيف أتحقق من توقيع webhook من ADITUS؟”

    يستدعي المساعد get_guide("webhooks", "signature") ويعيد اسم الترويسة الدقيق وخوارزمية التوقيع ومقتطف تحقق بلغتك، مع الإشارة إلى قسم الدليل.

  3. “ما واجهات ADITUS المتاحة للتحكم في الدخول، وأي نقطة نهاية تقرأ سجل مسح التذكرة؟”

    يستدعي المساعد list_modules ويختار وحدة الدخول، ثم يستدعي list_endpoints لها ثم get_endpoint لنقطة نهاية سجل المسح، ويجيب بنظرة عامة على الوحدة ومعاملات نقطة النهاية وحقول استجابتها.

البيانات والخصوصية

بلا حساب ولا مفتاح، ولا تصل محادثتك إلى الخادم أبدًا: يرسل مساعدك اسم الأداة ووسائطها فقط (مصطلح البحث أو الوحدة أو نقطة النهاية أو معرّف الدليل). لأغراض التشغيل يُسجَّل كل طلب مع طريقة JSON-RPC واسم الأداة وهذه الوسائط (كل منها مقتطع إلى 200 حرف) وحالة HTTP وسبب الخطأ أو الرفض وعدد النتائج والمدة واسم العميل وإصداره وإصدار البروتوكول من initialize وuser-agent الخاص بالعميل وتجزئة قصيرة مفتاحية (HMAC) لعنوان IP؛ ولا يُخزَّن العنوان نفسه أبدًا. تُحذف سجلات الطلبات بعد 90 يومًا (تنظيف عند بدء التشغيل وكل ست ساعات) وتبقى لدى ADITUS ولا تُشارك مع أطراف ثالثة. تأتي الإجابات حصريًا من الوثائق العامة. للاستفسار: اتصل بنا · سياسة الخصوصية