MCP
الأدوات
كل أداة يقدّمها خادم MCP في Docshark، مع مجالها، وهل تقرأ أم تغيّر، ومن يستطيع استخدامها، وما تفعله.
لا يرى التطبيق إلا الأدوات التي يفتحها دورك ويسمح بها الربط. الأداة المُعلَّمة تغيير مُعلَّمة بوصفها تغييرًا في قائمة الأدوات (destructiveHint)، فتطلب التطبيقات التي تدعم ذلك موافقتك قبل تشغيلها. والأداة المُعلَّمة قراءة مُعلَّمة للقراءة فقط (readOnlyHint) ولا تغيّر شيئًا أبدًا.
كل أداة تعمل باسمك، في مساحة عمل الربط. ومساحة العمل ليست مُدخلًا أبدًا: لا يستطيع التطبيق توجيه أداة إلى مساحة عمل أخرى.
النظرة العامة والتحليلات
| الأداة | العنوان | النوع | من يستخدمها | ما تفعله |
|---|---|---|---|---|
get_workspace_overview | نظرة عامة على مساحة العمل | قراءة | أي عضو في Docshark | مساحة العمل في لمحة: حدود الخطة والاستخدام، وآخر المظاريف، والقوالب، وغرف البيانات، وروابط المشاركة، والإعدادات، وما يمكنك فعله. |
analyze_engagement | تحليل تفاعل القرّاء | قراءة | عرض التحليلات أو إرسال التوقيعات | من فتح رابط مشاركة أو مظروفًا أو غرفة بيانات، وإلى أين وصل في القراءة، وأين توقف. |
المكتبة
| الأداة | العنوان | النوع | من يستخدمها | ما تفعله |
|---|---|---|---|---|
search_library | البحث في المكتبة | قراءة | أي عضو في Docshark | يجد المستندات بالاسم. يعرض فقط ما يمكنك فتحه في Docshark: تبقى المجلدات الخاصة والمقيّدة مخفية تمامًا كما في صفحة المكتبة. حتى 50 نتيجة. |
upload_document | رفع مستند | تغيير | إدارة المستندات | يرفع ملفًا إلى المكتبة، للفريق أو بشكل خاص. يرسل التطبيق محتوى الملف؛ حتى 20 ميغابايت للملف. PDF وWord وPowerPoint وExcel والصور والنصوص. تنطبق حدود التخزين في الخطة. |
create_library_folder | إنشاء مجلد في المكتبة | تغيير | إدارة المستندات | ينشئ مجلدًا في ملفات الفريق أو ملفاتي، وداخل مجلد آخر إن أردت. |
create_library_share_link | إنشاء رابط مشاركة | تغيير | إدارة المستندات أو الروابط | يشارك مستندًا أو مجلدًا برابط: انتهاء الصلاحية، وكلمة المرور، والتحقق من البريد، وقوائم السماح والحظر، والتنزيل، والعلامة المائية. يُفتح الرابط من خارج مساحة العمل. |
update_library_share_link | تعديل رابط مشاركة | تغيير | إدارة المستندات أو الروابط | يغيّر إعدادات رابط موجود. |
revoke_library_share_link | إلغاء رابط مشاركة | تغيير | إدارة المستندات أو الروابط | يوقف الرابط فلا يفتحه أحد بعد ذلك. |
التوقيعات
| الأداة | العنوان | النوع | من يستخدمها | ما تفعله |
|---|---|---|---|---|
list_envelopes | عرض المظاريف | قراءة | إرسال التوقيعات أو عرض التحليلات | المظاريف من الأحدث، مع حالة كل مستلم. التصفية حسب الحالة (مسودة، مُرسل، قيد التنفيذ، مكتمل، مرفوض، ملغى، منتهي) أو الموضوع. حتى 50. |
get_envelope_status | حالة المظروف | قراءة | إرسال التوقيعات أو عرض التحليلات | مظروف واحد: مستنداته، ودور كل مستلم وترتيبه وحالته، ومتى وقّع، وآخر عشرة أحداث. |
check_execution_readiness | فحص جاهزية المظروف | قراءة | إرسال التوقيعات | هل المظروف جاهز للإرسال أو الإتمام: الموقّعون، والحقول المطلوبة، والترتيب، وما يعيقه. |
reconcile_contract_metrics | مطابقة أرقام العقد | قراءة | إرسال التوقيعات | يقارن المبالغ والتواريخ والشروط بين مستندات المظروف ويذكر ما لا يتطابق. |
check_bilingual_parity | فحص تطابق العربية والإنجليزية | قراءة | إرسال التوقيعات | يقارن النسختين العربية والإنجليزية في المظروف ويذكر البنود المختلفة. |
list_approvals | عرض الموافقات | قراءة | إرسال التوقيعات أو إدارة القوالب | طلبات الموافقة على المظاريف والقوالب والنماذج والغرف، مع حالتها. |
list_obligations | عرض الالتزامات | قراءة | إرسال التوقيعات | ما تتطلبه الاتفاقيات الموقّعة ومتى: التجديدات والمدفوعات والإشعارات، مع المسؤولين عنها. المفتوحة افتراضيًا. |
create_signature_draft | إنشاء مسودة توقيع | تغيير | إرسال التوقيعات | ينشئ مسودة من مستندات المكتبة (حتى 50) أو من قالب، مع حتى 50 مستلمًا بأدوار موقّع أو مُطّلع أو معتمِد أو نسخة، بالتوازي أو بالترتيب. لا يُرسل شيء. |
send_envelope | إرسال مظروف للتوقيع | تغيير | إرسال التوقيعات | يرسل المسودة إلى مستلميها. يصل البريد إلى أشخاص خارج مساحة العمل. |
run_envelope_action | تنفيذ إجراء على مظروف | تغيير | إرسال التوقيعات | يرسل تذكيرًا، أو يلغي مظروفًا، أو يحذف مسودة أو يستعيدها، أو ينسخ مظروفًا إلى مسودة جديدة، أو يحفظه قالبًا، أو يشغّل تحليلات المشاهدة أو يوقفها. |
edit_draft_recipients | تعديل مستلمي المسودة | تغيير | إرسال التوقيعات | يضيف مستلمي المسودة أو يعدّلهم أو يحذفهم أو يعيد ترتيبهم. |
correct_sent_recipient | تصحيح مستلم بعد الإرسال | تغيير | إرسال التوقيعات | يصحح اسم مستلم لم يوقّع بعد أو بريده في مظروف مُرسل، أو يسند دوره إلى شخص آخر. |
edit_fields | تعديل حقول التوقيع | تغيير | إرسال التوقيعات أو إدارة القوالب | يضيف الحقول أو يعدّلها أو يحذفها أو يستبدلها في مسودة مظروف أو قالب. |
transfer_envelope_ownership | نقل ملكية المظروف | تغيير | إرسال التوقيعات | يطلب تسليم مظروف لزميل، أو يقبله، أو يرفضه. |
القوالب
| الأداة | العنوان | النوع | من يستخدمها | ما تفعله |
|---|---|---|---|---|
run_template_action | تنفيذ إجراء على قالب | تغيير | إدارة القوالب | ينشئ قالبًا (فارغًا أو من مستند أو من مظروف)، أو ينسخ قالبًا أو يعيد تسميته أو يؤرشفه أو يستعيده أو يحذفه أو يفضّله. |
edit_template_placeholders | تعديل الحقول القابلة للتعبئة | تغيير | إدارة القوالب | يضيف الحقول القابلة للتعبئة في القالب أو يغيّرها أو يحذفها. |
غرف البيانات
| الأداة | العنوان | النوع | من يستخدمها | ما تفعله |
|---|---|---|---|---|
list_rooms | عرض غرف البيانات | قراءة | أي عضو في Docshark | الغرف من الأحدث، مع عدد الملفات في كلٍّ منها. حتى 50. |
get_room_contents | محتوى غرفة البيانات | قراءة | أي عضو في Docshark يصل إلى الغرفة | المجلدات والملفات داخل غرفة واحدة، مع إعدادات التنزيل والطباعة والنسخ والعلامة المائية لكل ملف. |
list_inbox | أسئلة القرّاء المفتوحة | قراءة | إدارة غرف البيانات | الأسئلة التي طرحها القرّاء داخل الغرف ولم يُجب عنها بعد. |
create_room | إنشاء غرفة بيانات | تغيير | إدارة غرف البيانات | ينشئ غرفة، ويملؤها بمستندات من المكتبة إن أردت (حتى 200). |
create_room_folders | إنشاء مجلدات الغرفة | تغيير | إدارة غرف البيانات | يبني هيكل مجلدات داخل الغرفة. |
edit_room_files | تعديل ملفات الغرفة | تغيير | إدارة غرف البيانات | يضيف الملفات أو يحذفها أو يعيد ترتيبها، أو يغيّر ما يمكن للقرّاء فعله بها، بما في ذلك العلامة المائية (متوقفة أو فوق الصفحة أو محروقة). |
rename_room | إعادة تسمية غرفة | تغيير | إدارة غرف البيانات | يغيّر اسم الغرفة. |
update_room_defaults | تعديل إعدادات الغرفة الافتراضية | تغيير | إدارة غرف البيانات | الإعدادات التي تبدأ بها الروابط الجديدة في الغرفة: الحماية، والتنزيل، والعلامة المائية، والأسئلة، وانتهاء الصلاحية. |
create_room_share_link | إنشاء رابط غرفة | تغيير | إدارة غرف البيانات | يشارك الغرفة برابط يُفتح من خارج مساحة العمل. |
revoke_room_share_link | إلغاء رابط غرفة | تغيير | إدارة غرف البيانات | يوقف رابط الغرفة. |
answer_room_question | الإجابة عن سؤال | تغيير | إدارة غرف البيانات | ينشر إجابة عن سؤال قارئ، ويُبلَّغ القارئ. |
set_room_question_status | تحديد حالة السؤال | تغيير | إدارة غرف البيانات | يجعل السؤال مفتوحًا أو مُجابًا أو مغلقًا. |
طلبات الملفات والنماذج
| الأداة | العنوان | النوع | من يستخدمها | ما تفعله |
|---|---|---|---|---|
list_file_requests | عرض طلبات الملفات | قراءة | إدارة طلبات الملفات | الطلبات من الأحدث، وهل كلٌّ منها مفتوح، وكم ملفًا وصل. |
create_file_request | إنشاء طلب ملفات | تغيير | إدارة طلبات الملفات | ينشئ رابطًا يرفع إليه أشخاص من خارج مساحة العمل ملفات لك، مع ملاحظة وانتهاء صلاحية ومجلد وجهة إن أردت. ويعيد الرابط. |
list_forms | عرض النماذج | قراءة | إدارة القوالب | نماذج الويب ونماذج PowerForms، وهل كلٌّ منها منشور، وعدد الردود. |
مساحة العمل
| الأداة | العنوان | النوع | من يستخدمها | ما تفعله |
|---|---|---|---|---|
update_branding | تعديل الهوية البصرية | تغيير | أي عضو في Docshark؛ هوية الفريق تحتاج إدارة الهوية البصرية | يغيّر هوية الفريق البصرية أو يعيدها، أو مظهر توقيعك أنت، أو هوية رابط واحد. |
update_notification_preferences | تعديل تفضيلات الإشعارات | تغيير | أي عضو في Docshark | يغيّر رسائل Docshark وتنبيهاته التي تصلك. |
manage_plan_and_seats | إدارة الخطة والمقاعد | تغيير | أي عضو في Docshark؛ ينفّذ فقط بصلاحية الفوترة أو الفريق | يبدأ تغيير الخطة (Hobby أو Starter أو Team أو Business، شهريًا أو سنويًا) أو يدعو أعضاء ضمن مقاعد الخطة. يمر تغيير الخطة بصفحة الدفع. |
النتائج
- النتائج بصيغة JSON. والتواريخ بصيغة ISO 8601 بتوقيت UTC.
- النتيجة التي تزيد على 60,000 حرف تُقطع مع ملاحظة. اطلب عناصر أقل أو تصفية أضيق.
- القوائم تعرض 20 عنصرًا افتراضيًا و50 على الأكثر.
- إن لم تستطع الأداة فعل المطلوب، تعيد جملة واضحة مُعلَّمة بوصفها خطأ، مثل «Envelope not found». ولا تعيد تفاصيل داخلية أبدًا.
من يستخدمها
يذكر عمود «من يستخدمها» صلاحية Docshark التي تفتح الأداة. يملك المالكون والمشرفون كل الصلاحيات، وتحصل الأدوار الأخرى على ما تمنحه أدوار مساحة العمل في الإعدادات ← الفريق. ويمكن للربط أن يضيّق ذلك أكثر، لكنه لا يوسّعه أبدًا؛ راجع الصلاحيات.