---
type: reference
title: مرجع أدوات MCP
summary: كل أداة MCP في Caputchin، وما تفعله، والصلاحية التي يجب أن يحملها رمزها، مجمّعة حسب المجال.
---

هذه هي الأدوات التي يكشفها [خادم MCP](/docs/automation/mcp)، في شكليه المحلّي والمُستضاف. كلٌّ يوكّل عملية [API إدارة](/docs/automation/management-api) واحدة، فالصلاحية التي تحتاجها أداة هي الصلاحية التي تحتاجها تلك العملية؛ على [رمز](/docs/automation/management-api#mint-an-access-token) الوكيل حملها. الكتالوج والأوصاف تأتي من الخادم نفسه؛ ولمخطّط الطلب والاستجابة الدقيق للعملية خلف أداة، انظر [مرجع الـ API التفاعلي](/docs/api-reference).

## كيف تعمل الصلاحيات هنا

تعمل أداة فقط إن كان الرمز خلفها مسموحًا له بأداء العملية الأساسية. يستخدم عمود **الصلاحية** هذه القيم، التي تقابل نموذج [الصلاحيات والنطاق](/docs/troops/permissions) للفريق:

| القيمة | تعني |
|---|---|
| **Account** | أي رمز صالح على الحساب. أدوات سكّ الرموز والمقاعد تتطلّب إضافةً اعتمادًا رئيسيًّا للحساب (جلسة لوحة تحكّم أو [رمز الوصول الشخصي](/docs/account-management/personal-access-token))؛ لا يستطيع رمز فريق سكّ رموز أو مقاعد. |
| **read** | صلاحية `read`. الأدوات المحصورة بموقع تتطلّب أيضًا أن يكون مفتاح الموقع في نطاق الرمز. |
| **create** | صلاحية `create` على الفريق (إنشاء مفتاح موقع فيه). |
| **edit** | صلاحية `edit`، محصورةً بمفتاح الموقع الذي تستهدفه الأداة. |
| **manage** | صلاحية `manage`: إدارة الفريق (الأعضاء، والرموز، وإعدادات الفريق). |

بعض الأدوات تحتاج أيضًا مستوى باقة، مذكورًا في الوصف: تبييض العلامة **Apex**، وتخصيص لغة اللعبة ومظهرها **Alpha فما فوق**، وسجلات التدقيق **Apex**.

## الحساب والصحّة

| الأداة | تفعل | الصلاحية |
|---|---|---|
| `caputchin_ping` | فحص صحّة؛ تعيد معرّف الحساب المحلول حين يكون الرمز صالحًا. | Account |
| `caputchin_get_account` | الحساب المصادَق عليه (المعرّف، البريد، الباقة). | Account |
| `caputchin_me_billing` | ملخّص الفوترة (الباقة، الحالة، الدورة). | Account |
| `caputchin_get_seats` | استخدام المقاعد للحساب (المستخدَم، الإجمالي، التفصيل). | Account |

## الرموز والمقاعد

| الأداة | تفعل | الصلاحية |
|---|---|---|
| `caputchin_list_tokens` | عدّ رموز الحساب؛ لا تعيد الأسرار أبدًا. | Account |
| `caputchin_create_token` | سكّ رمز (`type` فريق أو حساب)؛ القيمة تُعاد مرة واحدة. | Account (master) |
| `caputchin_rotate_token` | تدوير سرّ رمز؛ القيمة الجديدة تُعاد مرة واحدة. | Account (master) |
| `caputchin_revoke_token` | إلغاء رمز؛ ساري المفعول فورًا. | Account (master) |
| `caputchin_invite_seat_user` | دعوة مستخدم إلى فريق (مدرِك للمقاعد)؛ يستهلك مقعدًا إن كان جديدًا. | Account (master) |
| `caputchin_remove_seat_user` | إزالة مستخدم من كل فريق في الحساب. | Account (master) |
| `caputchin_mint_seat_pat` | سكّ وإرفاق رمز فريق بنداء واحد؛ القيمة تُعاد مرة واحدة. | Account (master) |
| `caputchin_attach_seat_pat` | إرفاق رمز فريق قائم بفريق آخر. | Account (master) |
| `caputchin_revoke_seat_pat` | إلغاء رمز فريق عبر الحساب. | Account (master) |

## الفرق

| الأداة | تفعل | الصلاحية |
|---|---|---|
| `caputchin_list_troops` | عدّ فرق الحساب. | Account |
| `caputchin_get_troop` | فريق واحد بالمعرّف. | read |
| `caputchin_create_troop` | إنشاء فريق مشترك. | Account |
| `caputchin_rename_troop` | إعادة تسمية فريق. | manage |
| `caputchin_delete_troop` | حذف فريق؛ يرفض إن كان ما زال يملك مفاتيح مواقع. | manage |
| `caputchin_list_troop_members` | أعضاء فريق بصلاحياتهم ونطاقهم. | read |
| `caputchin_add_troop_member` | إضافة مستخدم بالبريد بصلاحيات ونطاق؛ قد يستهلك مقعدًا. | manage |
| `caputchin_update_troop_member` | تغيير صلاحيات عضو أو نطاقه. | manage |
| `caputchin_remove_troop_member` | إزالة عضو؛ يحرّر مقعده إن كان آخر فريق له. | manage |
| `caputchin_list_troop_pats` | رموز الفريق المرفقة بفريق. | read |
| `caputchin_attach_troop_pat` | إرفاق رمز فريق بصلاحيات ونطاق؛ يستهلك مقعدًا. | manage |
| `caputchin_update_troop_pat` | تغيير صلاحيات رمز مرفق أو نطاقه. | manage |
| `caputchin_detach_troop_pat` | فصل رمز فريق؛ يحرّر مقعده. | manage |
| `caputchin_get_troop_security` | إعدادات أمان فريق (سقف فرض اللعبة إضافةً إلى افتراضيات وضع المعاينة وإعادة استخدام التحقّق). | read |
| `caputchin_update_troop_security` | ضبط سقف فرض اللعبة وافتراضيات وضع المعاينة وإعادة استخدام التحقّق على مستوى الفريق. | manage |

## مفاتيح المواقع

| الأداة | تفعل | الصلاحية |
|---|---|---|
| `caputchin_list_sites` | كل مفاتيح المواقع عبر فرق الحساب. | read |
| `caputchin_get_site` | مفتاح موقع واحد بالمعرّف. | read |
| `caputchin_create_site` | إنشاء مفتاح موقع (في فريق، أو Personal)؛ يعيد السرّ مرة واحدة. | create |
| `caputchin_update_site` | تحديث اسم مفتاح أو علم تعطيله. | edit |
| `caputchin_delete_site` | حذف مفتاح؛ يتعاقب على الجلسات والإعداد. لا رجعة فيه. | edit |
| `caputchin_rotate_site_secret` | تدوير السرّ؛ القديم يتوقّف فورًا؛ الجديد يُعاد مرة واحدة. | edit |
| `caputchin_get_site_cap_config` | إعداد proof-of-work لمفتاح. | read |
| `caputchin_update_site_cap_config` | تحديث إعداد proof-of-work. | edit |
| `caputchin_get_site_security` | إعدادات أمان مفتاح (بوّابة اشتراط اللعبة، ووضع المعاينة، وإعادة استخدام التحقّق). | read |
| `caputchin_update_site_security` | تبديل بوّابة اشتراط اللعبة ووضع المعاينة وإعادة استخدام التحقّق لكل مفتاح. | edit |
| `caputchin_list_site_sessions` | جلسات التحقّق الأخيرة لمفتاح. | read |

## التحقّق المُستضاف

| الأداة | تفعل | الصلاحية |
|---|---|---|
| `caputchin_get_hosted_verification` | إعداد التحقّق المُستضاف لمفتاح. | read |
| `caputchin_set_hosted_verification` | ضبط علم التفعيل والوجهات. | edit |
| `caputchin_test_hosted_verification` | إطلاق تسليم اصطناعي إلى الوجهات المُعَدّة. | edit |

## الإحصاءات والتسليم وسجلات التدقيق

| الأداة | تفعل | الصلاحية |
|---|---|---|
| `caputchin_site_stats` | إحصاءات تحقّق الموقع عبر مدى. | read |
| `caputchin_site_stats_dashboard` | تجميع لوحة تحكّم إحصاءات الموقع. | read |
| `caputchin_site_stats_activity` | سلسلة نشاط إحصاءات الموقع. | read |
| `caputchin_site_stats_durations` | مئينات توقيت إحصاءات الموقع. | read |
| `caputchin_site_stats_rejections` | عدّات رفض الموقع. | read |
| `caputchin_troop_stats` | إجماليات إحصاءات الفريق مدى الحياة. | read |
| `caputchin_troop_stats_dashboard` | تجميع لوحة تحكّم إحصاءات الفريق. | read |
| `caputchin_troop_stats_activity` | سلسلة نشاط إحصاءات الفريق. | read |
| `caputchin_troop_stats_durations` | مئينات توقيت إحصاءات الفريق. | read |
| `caputchin_troop_stats_rejections` | عدّات رفض الفريق. | read |
| `caputchin_quick_stats_sites` | لقطة إحصاءات مدمجة لكل موقع عبر الحساب. | read |
| `caputchin_quick_stats_troops` | لقطة إحصاءات مدمجة لكل فريق عبر الحساب. | read |
| `caputchin_site_delivery_dashboard` | إحصاءات تسليم التحقّق المُستضاف لموقع. Apex. | read |
| `caputchin_troop_delivery_dashboard` | إحصاءات تسليم التحقّق المُستضاف لفريق. Apex. | read |
| `caputchin_account_audit_logs` | سجلّ تدقيق على مستوى الحساب. Apex. | Account |
| `caputchin_troop_audit_logs` | سجلّ تدقيق الفريق. Apex. | read |
| `caputchin_site_audit_logs` | سجلّ تدقيق مفتاح الموقع. Apex. | read |

## ألعاب المتجر

| الأداة | تفعل | الصلاحية |
|---|---|---|
| `caputchin_list_games` | عدّ ألعاب المتجر. | Account |
| `caputchin_search_games` | بحث ألعاب المتجر بالنصّ. | Account |
| `caputchin_get_game` | لعبة متجر واحدة بالمعرّف. | Account |

## تخصيص اللعبة

هذه تستهدف نطاقًا (مفتاح موقع أو فريقًا)، فتغيير محصور بموقع يحتاج `edit` على ذلك المفتاح وتغيير على مستوى الفريق يحتاج `manage`. تخصيص اللغة والمظهر **Alpha فما فوق**.

| الأداة | تفعل | الصلاحية |
|---|---|---|
| `caputchin_list_customized_games` | الألعاب المسجّلة (المثبّتة) لنطاق. | read |
| `caputchin_register_customized_game` | تسجيل (تثبيت) لعبة على نطاق؛ يثبّت لقطة. | edit (site) or manage (troop) |
| `caputchin_repin_customized_game` | إعادة تثبيت لعبة مسجّلة على أحدث نسخة. | edit (site) or manage (troop) |
| `caputchin_update_customized_game` | تحديث إعدادات لعبة مسجّلة (التحديث التلقائي). | edit (site) or manage (troop) |
| `caputchin_delete_customized_game` | إلغاء تثبيت لعبة مسجّلة من نطاق. | edit (site) or manage (troop) |
| `caputchin_list_game_presets` | تهيئات تخصيص لنطاق ولعبة. | read |
| `caputchin_set_game_preset` | إنشاء أو تحديث تهيئة لعبة. Alpha+. | edit (site) or manage (troop) |
| `caputchin_delete_game_preset` | حذف تهيئة لعبة. Alpha+. | edit (site) or manage (troop) |
| `caputchin_set_game_default` | ضبط تهيئة اللعبة الافتراضية لمحور. Alpha+. | edit (site) or manage (troop) |
| `caputchin_get_custom_game_schema` | مخطّط حقول لعبة مخصّصة لنطاق. | read |
| `caputchin_set_custom_game_schema` | ضبط مخطّط حقول لعبة مخصّصة. Alpha+. | edit (site) or manage (troop) |
| `caputchin_delete_custom_game_schema` | حذف مخطّط حقول لعبة مخصّصة. Alpha+. | edit (site) or manage (troop) |
| `caputchin_upload_custom_game_run` | رفع أداة التشغيل بلا واجهة للعبة مخصّصة. | edit (site) or manage (troop) |
| `caputchin_get_custom_game_run` | جلب مرجع أداة التشغيل المخزَّنة للعبة مخصّصة. | read |
| `caputchin_delete_custom_game_run` | حذف أداة تشغيل لعبة مخصّصة. | edit (site) or manage (troop) |

## العلامة البيضاء

تبييض غلاف الأداة ميزة **Apex**. كما في تخصيص اللعبة، تغيير محصور بموقع يحتاج `edit` وتغيير على مستوى الفريق يحتاج `manage`.

| الأداة | تفعل | الصلاحية |
|---|---|---|
| `caputchin_list_white_label_presets` | تهيئات العلامة البيضاء لنطاق. | read |
| `caputchin_set_white_label_preset` | إنشاء أو تحديث تهيئة علامة بيضاء. Apex. | edit (site) or manage (troop) |
| `caputchin_delete_white_label_preset` | حذف تهيئة علامة بيضاء. Apex. | edit (site) or manage (troop) |
| `caputchin_set_white_label_default` | ضبط تهيئة العلامة البيضاء الافتراضية لمحور. Apex. | edit (site) or manage (troop) |

## انظر أيضًا

- [استخدم خادم MCP](/docs/automation/mcp): ربط وكيل عبر أيّ ناقل.
- [الصلاحيات والنطاق](/docs/troops/permissions): نموذج read / create / edit / manage الذي يستخدمه الجدول أعلاه.
- [مرجع الـ API التفاعلي](/docs/api-reference): المخطّط الدقيق للعملية خلف كل أداة.