مجموعات أدوات Didit MCP ووضع القراءة فقط

تتيح مجموعات الأدوات لاتصال Didit MCP تحميل قائمة قصيرة من الأدوات بدلاً من الكتالوج كاملاً، ويوفّر وضع القراءة فقط اتصالاً لا يمكنه تغيير البيانات مطلقاً. وكلاهما معامل في عنوان URL للخادم:

https://mcp.didit.me/mcp?toolsets=core
https://mcp.didit.me/mcp?read_only=true

من دون معامل، يسرد الخادم كل أداة يُسمح لدورك باستخدامها، لذلك لا يتغير شيء في الاتصال الذي لديك بالفعل.

لماذا نحمّل أدوات أقل

يرسل عميلك تعريف كل أداة مدرجة إلى النموذج قبل سؤالك الأول. بالنسبة إلى كتالوج Didit الكامل، يعني ذلك عشرات الآلاف من token في كل طلب: تقريباً من 50,000 إلى 115,000، بحسب أداة الترميز (tokenizer) الخاصة بالنموذج. وبعض العملاء يحدّون أيضاً عدد الأدوات التي يقبلونها.

ما يحمّله الاتصال	عدد الأدوات المدرجة	نسبة تلك الـtoken
الكل (بدون معامل)	كل أداة يُسمح لدورك باستخدامها	جميعها
القائمة المختصرة `core`	حوالي 30	حوالي عُشر
القائمة المختصرة، للقراءة فقط	حوالي 20	أقل من عُشر

المقايضة هي خطوة إضافية واحدة. الأداة التي تقع خارج القائمة لا تضيع، لكن النموذج يحتاج إلى العثور عليها باستخدام بحث الأدوات قبل أن يتمكن من تشغيلها، والنموذج الذي يرى كل الأدوات يختار الأداة الصحيحة بمعدل أعلى قليلاً من نموذج يضطر إلى البحث. حمّل كل الأدوات عندما تمتد المحادثة عبر مجالات كثيرة ولا تهم تكلفة السياق. حمّل core، مع مجموعات الأدوات التي تستخدمها أكثر من غيرها، عندما تكون تكلفة السياق مهمة.

اختيار مجموعات الأدوات

أضِف toolsets إلى عنوان URL للخادم مع قائمة مفصولة بفواصل:

https://mcp.didit.me/mcp?toolsets=core
https://mcp.didit.me/mcp?toolsets=core,workflows
https://mcp.didit.me/mcp?toolsets=core,transactions,cases

core هي القائمة المختصرة التي تبدأ منها معظم الأعمال. تشمل المؤسسات والتطبيقات، وجلسات التحقق (إنشاؤها والبحث فيها والبت فيها وشرحها ومحاكاتها في البيئة التجريبية وقراءة عمليات تسليم webhook)، والبحث عن سير العمل، والتحليلات والرصيد، ومفتاح API الخاص بتطبيقك وwebhooks، والبحث عن الحالات والمستخدمين والشركات والمعاملات، والبحث في المستندات.

core: القائمة المختصرة الموضحة أعلاه.
account: المؤسسات والتطبيقات ومفاتيح API والأعضاء والأدوار.
billing: الخطة ورصيد الاعتمادات وطرق الدفع والإيصالات وبيانات الفوترة.
sessions: جلسات التحقق (الإنشاء والبحث والبت والمراجعة والمشاركة والاستيراد وملفات PDF وعمليات تسليم webhook).
workflows: سير عمل التحقق والاستبيانات (البناء والتحرير والتحقق من الصحة والنشر).
lists: القوائم المخصصة وقائمة الحظر وقائمة السماح.
vendors: الأشخاص والشركات التي تتحقق منها (مستخدمو الموردين وشركاتهم).
transactions: مراقبة المعاملات (المعاملات وفحص المحافظ والقواعد مع الاختبار الرجعي).
cases: إدارة الحالات (الإنشاء والتعيين والتصعيد والحل).
investigator: Investigator (قائمة مراجعته والتقارير والقرارات وأسئلة السياسات والأداء).
webhooks: وجهات webhook والتنبيهات.
reports: التحليلات والتصدير وسجل التدقيق.
branding: العلامة البيضاء لتخصيص تدفق التحقق.
verification: واجهات API للتحقق المستقلة (وثيقة الهوية والوجه وAML وإثبات العنوان والهاتف والبريد الإلكتروني وفحوصات قواعد البيانات وفحوصات الشركات).
travel_rule: Travel Rule (الإعدادات ودليل VASP والشبكات وعناوين المحافظ والتحويلات والرسائل).
marketplace: سوق المزوّدين (الكتالوج واتصالاتك وطلبات التكامل).
networks: شبكات الاحتيال (الجلسات والمستخدمون والشركات المرتبطة التي تتشارك جهازًا أو مستندًا أو وسيلة اتصال).
compliance: مساعد الامتثال (ملفك التنظيمي ومتطلباته وسير العمل المُنشأ منها).
docs: البحث في مستندات Didit.
all: كل الأدوات التي يحق لدورك استخدامها. وهذا هو الخيار الافتراضي.

يسرد مرجع الأدوات كل أداة مع نوعها وإذن الدور الذي تحتاجه. كيف يعمل الاختيار:

مجموعات الأدوات اختيارية. عنوان URL دون toolsets يعرض كل شيء.
تسمية مجموعات بعينها تعرض تلك المجموعات فقط. تعرض ?toolsets=cases أدوات الحالات، إضافةً إلى didit_context_get الذي يحصل عليه كل اتصال. أضِف core للإبقاء على القائمة المختصرة أيضًا.
مجموعة الأدوات تحدد ما يُعرض، لا ما يحق لك تشغيله. تعمل الأداة خارج اختيارك حين يستدعيها النموذج باسمها، بالأذونات نفسها التي يطبّقها دورك دائمًا.
الاسم الذي لا يعرفه الخادم يُتجاهل. يبقى الاتصال يعمل، ويُخبر الخادم النموذج بالاسم الذي تجاهله والأسماء الصحيحة.
دورك ما زال ساريًا. لا تمنح مجموعة الأدوات أي إذن: راجع الأدوار والأذونات.

الاتصال في وضع القراءة فقط

أضف read_only=true إلى عنوان URL الخاص بالخادم:

https://mcp.didit.me/mcp?read_only=true
https://mcp.didit.me/mcp?toolsets=core,reports&read_only=true

لا يعرض الاتصال في وضع القراءة فقط سوى الأدوات التي تقرأ البيانات، ويرفض الخادم أي استدعاء من شأنه إنشاء شيء أو تعديله أو حذفه. يتم الرفض على الخادم لكل استدعاء، لذا يبقى ساريًا حتى لو كان عميلك ما زال يحتفظ بأداة من اتصال سابق. استخدم هذا الوضع لإعداد التقارير، أو لاستكشاف الحساب، أو لوكيل لا تريد له أن يتصرف من تلقاء نفسه. لإتاحة التغييرات مرة أخرى، اتصل من دون read_only.

الوصول إلى الأدوات التي لم تحمّلها

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

didit_tool_search (قراءة): يعثر على الأدوات حسب ما تريد تنفيذه (“تصدير الجلسات إلى CSV”)، أو يسرد مجموعة أدوات واحدة. يوضّح كل نتيجة ما تفعله الأداة ومعاملاتها، وما إذا كانت تقرأ البيانات أو تكتب فيها أو كانت مدمّرة.
didit_tool_describe (قراءة): يعيد الوصف الكامل ومخطط المدخلات لما يصل إلى خمس أدوات.
didit_tool_call_read (قراءة): يشغّل أداة للقراءة فقط ليست في القائمة. ويرفض أي أداة تغيّر البيانات.
didit_tool_call_write (مدمّرة): يشغّل أداة تنشئ البيانات أو تغيّرها أو تحذفها، وليست في القائمة. لا تُتاح على اتصال للقراءة فقط.

يخضع الاستدعاء عبر didit_tool_call_read أو didit_tool_call_write للفحص نفسه المطبّق على الاستدعاء المباشر: صلاحيات دورك، ووضع القراءة فقط، وكل شرط confirm: true. فُصلت الأداتان عن بعضهما حتى يسألك عميلك قبل أي تغيير، ويسمح بتمرير عمليات الاستعلام. مع تحميل core، يسير طلب مثل “دعوة عضو جديد إلى مؤسستي” على النحو التالي:

يستدعي النموذج didit_tool_search بالعبارة invite a teammate، فيحصل على didit_org_invite_member موسومة بأنها أداة كتابة.
يستدعي didit_tool_call_write ويمرر didit_org_invite_member بوصفها name، مع معاملات تلك الأداة نفسها.
يطلب منك عميلك الموافقة على الاستدعاء، كما يفعل مع أي أداة تغيّر البيانات.

عندما تُحمَّل كل الأدوات، لا يبقى شيء لاكتشافه، ولذلك لا تُدرج هذه الأدوات الأربع في القائمة.

الإعداد في العميل الذي تستخدمه

اتبع الخطوات نفسها الواردة في دليل التثبيت، مع إضافة المعاملات إلى عنوان URL.

claude mcp add --transport http didit "https://mcp.didit.me/mcp?toolsets=core"

احتفظ بعلامتي الاقتباس، وإلا فستفسّر الصدفة البرمجية الحرفين ? و& بنفسها.

codex mcp add didit --url "https://mcp.didit.me/mcp?toolsets=core"

في ~/.cursor/mcp.json:

{
  "mcpServers": {
    "didit": {
      "url": "https://mcp.didit.me/mcp?toolsets=core"
    }
  }
}

في .vscode/mcp.json:

{
  "servers": {
    "didit": {
      "type": "http",
      "url": "https://mcp.didit.me/mcp?toolsets=core"
    }
  }
}

افتح Settings، ثم Connectors، ثم Add custom connector، والصق عنوان URL مع معاملاته:

https://mcp.didit.me/mcp?toolsets=core

يقبل الخادم المحلي خيارات سطر الأوامر أو متغيرات البيئة:

npx -y @didit-protocol/mcp-server --toolsets=core,workflows --read-only

DIDIT_TOOLSETS=core,workflows DIDIT_READ_ONLY=true npx -y @didit-protocol/mcp-server

إذا كان عميلك يتيح لك ضبط الرؤوس دون تعديل عنوان URL، فأرسل بدلاً من ذلك X-MCP-Toolsets: core,workflows وX-MCP-Readonly: true. تتغلب القيمة الواردة في عنوان URL على الرأس فيما يخص مجموعات الأدوات، ويُفعَّل وضع القراءة فقط إذا طلبه أيٌّ منهما.

تستخدم إضافة ChatGPT كتالوجها الخاص الثابت والمختصر على https://mcp.didit.me/mcp/chatgpt. لا تنطبق مجموعات الأدوات ووضع القراءة فقط عليه. راجع الربط بـ ChatGPT.

التعليمات والمطالبات والبحث في الوثائق

يساعد الخادم النموذج على البدء من المكان الصحيح:

التعليمات. عند الاتصال، يطلب الخادم من النموذج أن يبدأ بالاستدعاء didit_context_get، ويشرح كيفية تحديد organization_id وapplication_id، وأن يبني داخل تطبيق في البيئة التجريبية، وما مجموعات الأدوات التي حمّلها هذا الاتصال.
المطالبات. يعرض العملاء الذين يدعمون مطالبات MCP خمس نقاط بداية: integrate_didit وreview_queue وexplain_session وbuild_workflow وverification_report. وفي Claude Code تظهر هذه المطالبات كأوامر تبدأ بشرطة مائلة.
البحث في الوثائق. يبحث didit_docs_search في هذه الوثائق ويعيد الأقسام المطابقة مع روابطها، بحيث تُجاب الأسئلة حول طريقة عمل Didit استنادًا إلى الصفحات الحالية.

التحقق مما حمّله الاتصال

اطلب من عميلك:

Which Didit toolsets does this connection load, and is it read-only?

يجيب النموذج اعتماداً على تعليمات الخادم. للتحقق من أن الخادم يدعم مجموعات الأدوات قبل الاعتماد عليها، اقرأ endpoint الخاص بحالة التشغيل:

curl https://mcp.didit.me/healthz

تسرد الإجابة toolsets وread_only ضمن features.

الخطوات التالية

التثبيت

اتصل بـ Claude وChatGPT وCursor وVS Code وCodex أو بأي عميل MCP.

مرجع الأدوات

كل أداة ونوعها وإذن الدور الذي تحتاجه.

المصادقة

سجّل الدخول باستخدام Didit، وتعرّف على النطاقات وأذونات الأدوار.

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

مطالبات تعمل منذ اليوم الأول.

الأدلة

المصادقة

Model Context Protocol (MCP)

SDKs الويب

SDKs الأصلية

SDKs الخادم

التكاملات

مجموعات أدوات Didit MCP ووضع القراءة فقط

لماذا نحمّل أدوات أقل

اختيار مجموعات الأدوات

الاتصال في وضع القراءة فقط

الوصول إلى الأدوات التي لم تحمّلها

الإعداد في العميل الذي تستخدمه

التعليمات والمطالبات والبحث في الوثائق

التحقق مما حمّله الاتصال

الخطوات التالية

التثبيت

مرجع الأدوات

المصادقة

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

​لماذا نحمّل أدوات أقل

​اختيار مجموعات الأدوات

​الاتصال في وضع القراءة فقط

​الوصول إلى الأدوات التي لم تحمّلها

​الإعداد في العميل الذي تستخدمه

​التعليمات والمطالبات والبحث في الوثائق

​التحقق مما حمّله الاتصال

​الخطوات التالية

التثبيت

مرجع الأدوات

المصادقة

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

لماذا نحمّل أدوات أقل

اختيار مجموعات الأدوات

الاتصال في وضع القراءة فقط

الوصول إلى الأدوات التي لم تحمّلها

الإعداد في العميل الذي تستخدمه

التعليمات والمطالبات والبحث في الوثائق

التحقق مما حمّله الاتصال

الخطوات التالية