الأتمتة
مرجع أدوات MCP
هذه هي الأدوات التي يكشفها خادم MCP، في شكليه المحلّي والمُستضاف. كلٌّ يوكّل عملية API إدارة واحدة، فالصلاحية التي تحتاجها أداة هي الصلاحية التي تحتاجها تلك العملية؛ على رمز الوكيل حملها. الكتالوج والأوصاف تأتي من الخادم نفسه؛ ولمخطّط الطلب والاستجابة الدقيق للعملية خلف أداة، انظر مرجع الـ API التفاعلي.
تعمل أداة فقط إن كان الرمز خلفها مسموحًا له بأداء العملية الأساسية. يستخدم عمود الصلاحية هذه القيم، التي تقابل نموذج الصلاحيات والنطاق للفريق:
| القيمة | تعني |
|---|
| Account | أي رمز صالح على الحساب. أدوات سكّ الرموز والمقاعد تتطلّب إضافةً اعتمادًا رئيسيًّا للحساب (جلسة لوحة تحكّم أو رمز الوصول الشخصي)؛ لا يستطيع رمز فريق سكّ رموز أو مقاعد. |
| 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) |
