> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

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

> حمّل أدوات Didit MCP التي تحتاجها فقط عبر المجموعات، واتصل في وضع القراءة فقط، واعثر على أي أداة عند الحاجة.

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

```text theme={null}
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 للخادم مع قائمة مفصولة بفواصل:

```text theme={null}
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`: كل الأدوات التي يحق لدورك استخدامها. وهذا هو الخيار الافتراضي.

يسرد [مرجع الأدوات](https://docs.didit.me/ar/integration/mcp/tools.md) كل أداة مع نوعها وإذن الدور الذي تحتاجه.

كيف يعمل الاختيار:

* **مجموعات الأدوات اختيارية.** عنوان URL دون `toolsets` يعرض كل شيء.
* **تسمية مجموعات بعينها تعرض تلك المجموعات فقط.** تعرض `?toolsets=cases` أدوات الحالات، إضافةً إلى `didit_context_get` الذي يحصل عليه كل اتصال. أضِف `core` للإبقاء على القائمة المختصرة أيضًا.
* **مجموعة الأدوات تحدد ما يُعرض، لا ما يحق لك تشغيله.** تعمل الأداة خارج اختيارك حين يستدعيها النموذج باسمها، بالأذونات نفسها التي يطبّقها دورك دائمًا.
* **الاسم الذي لا يعرفه الخادم يُتجاهل.** يبقى الاتصال يعمل، ويُخبر الخادم النموذج بالاسم الذي تجاهله والأسماء الصحيحة.
* **دورك ما زال ساريًا.** لا تمنح مجموعة الأدوات أي إذن: راجع [الأدوار والأذونات](https://docs.didit.me/ar/integration/mcp/authentication.md#الأدوار-والأذونات).

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

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

```text theme={null}
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`، يسير طلب مثل "دعوة عضو جديد إلى مؤسستي" على النحو التالي:

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

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

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

اتبع الخطوات نفسها الواردة في [دليل التثبيت](https://docs.didit.me/ar/integration/mcp/installation.md)، مع إضافة المعاملات إلى عنوان URL.

> [tab] Claude Code
>
> ```bash theme={null}
> claude mcp add --transport http didit "https://mcp.didit.me/mcp?toolsets=core"
> ```
>
> احتفظ بعلامتي الاقتباس، وإلا فستفسّر الصدفة البرمجية الحرفين `?` و`&` بنفسها.

> [tab] Codex
>
> ```bash theme={null}
> codex mcp add didit --url "https://mcp.didit.me/mcp?toolsets=core"
> ```

> [tab] Cursor
>
> في `~/.cursor/mcp.json`:
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "didit": {
>       "url": "https://mcp.didit.me/mcp?toolsets=core"
>     }
>   }
> }
> ```

> [tab] VS Code
>
> في `.vscode/mcp.json`:
>
> ```json theme={null}
> {
>   "servers": {
>     "didit": {
>       "type": "http",
>       "url": "https://mcp.didit.me/mcp?toolsets=core"
>     }
>   }
> }
> ```

> [tab] Claude على الويب وسطح المكتب
>
> افتح **Settings**، ثم **Connectors**، ثم **Add custom connector**، والصق عنوان URL مع معاملاته:
>
> ```text theme={null}
> https://mcp.didit.me/mcp?toolsets=core
> ```

> [tab] الخادم المحلي
>
> يقبل الخادم المحلي خيارات سطر الأوامر أو متغيرات البيئة:
>
> ```bash theme={null}
> npx -y @didit-protocol/mcp-server --toolsets=core,workflows --read-only
> ```
>
> ```bash theme={null}
> 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 على الرأس فيما يخص مجموعات الأدوات، ويُفعَّل وضع القراءة فقط إذا طلبه أيٌّ منهما.

> [!NOTE]
>
> تستخدم إضافة ChatGPT كتالوجها الخاص الثابت والمختصر على `https://mcp.didit.me/mcp/chatgpt`.
> لا تنطبق مجموعات الأدوات ووضع القراءة فقط عليه.
> راجع [الربط بـ ChatGPT](https://docs.didit.me/ar/integration/mcp/chatgpt.md).

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

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

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

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

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

```text theme={null}
Which Didit toolsets does this connection load, and is it read-only?
```

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

```bash theme={null}
curl https://mcp.didit.me/healthz
```

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

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

> [card] [التثبيت](https://docs.didit.me/ar/integration/mcp/installation.md)
>
> اتصل بـ Claude وChatGPT وCursor وVS Code وCodex أو بأي عميل MCP.

> [card] [مرجع الأدوات](https://docs.didit.me/ar/integration/mcp/tools.md)
>
> كل أداة ونوعها وإذن الدور الذي تحتاجه.

> [card] [المصادقة](https://docs.didit.me/ar/integration/mcp/authentication.md)
>
> سجّل الدخول باستخدام Didit، وتعرّف على النطاقات وأذونات الأدوار.

> [card] [أمثلة على المطالبات](https://docs.didit.me/ar/integration/mcp/examples.md)
>
> مطالبات تعمل منذ اليوم الأول.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.