نظرة عامة على أدوات Drive MCP لوكلاء الذكاء الاصطناعي
تعرّف على 42 أداة MCP في TrekMail Drive للوكلاء: الرفع وروابط المشاركة والعمليات المجمعة والحذف الآمن ووصول القراءة.
تفاصيل المقال
النوع والصعوبة والخطط ومعلومات آخر تحديث.
▼
تفاصيل المقال
النوع والصعوبة والخطط ومعلومات آخر تحديث.
- النوع
- مرجع
- الصعوبة
- متوسط
- الخطط
- Starter · Pro · Agency · + Drive Add-on
- آخر تحديث
- 10 سبتمبر 2026
يعرض خادم TrekMail MCP خدمة TrekMail لوكلاء الذكاء الاصطناعي في صورة أدوات منظمة لتخزين الملفات والروابط العامة والتنظيف الآمن وكلمات مرور أجهزة المزامنة. لا يرى الاتصال إلا الأدوات التي تسمح بها بيانات اعتماده ومجموعات الأدوات المحددة ووسيلة النقل وبوابات الأمان. تحقق من قائمة الأدوات المعروضة للوكيل بدلا من الاعتماد على عدد ثابت في الكتالوج.
يكون MCP عادة أسهل للوكلاء من استخدام REST الخام. فبدلا من مطالبة الوكيل بإنشاء طلبات HTTP، تمنحه أدوات مثل drive_file_upload أو drive_share_create أو drive_bulk_move. وتواصل API فرض نطاقات الرموز المميزة والتكرار الآمن وتسجيل التدقيق وبوابات الأمان خلف الكواليس.
نطاق تغطية الأدوات
| مجموعة الأدوات | الأدوات | ما يمكن للوكلاء فعله |
|---|---|---|
| المساحات والاستخدام | drive_spaces_list, drive_storage_summary, drive_space_usage |
اكتشاف Drive الخاص بالحساب ومساحات صناديق البريد المسموح بها وحالة الحصة |
| التصفح والتحديد | drive_browse_folder, drive_folder_tree, drive_select_all_ids |
التنقل بين المجلدات وإعداد العمليات المجمعة بأمان |
| الملفات | drive_file_get, drive_file_download_url, drive_file_rename, drive_file_move, drive_file_trash, drive_file_restore, drive_file_purge |
قراءة البيانات الوصفية وتنزيل ملف أو إعادة تسميته أو نقله أو إرساله إلى المهملات أو استعادته أو حذفه نهائيا |
| المجلدات | drive_folder_create, drive_folder_update, drive_folder_move, drive_folder_trash, drive_folder_restore, drive_folder_purge |
إنشاء أشجار المجلدات وإدارتها |
| المشاركة مع الفريق | drive_folder_share_with_account, drive_folder_stop_sharing |
إظهار مجلد من المستوى الأعلى لجميع صناديق البريد أو إيقاف ظهوره على مستوى الحساب |
| المهملات | drive_trash_list, drive_trash_empty |
مراجعة المهملات أو إفراغها نهائيا عند تفعيل بوابة العمليات التدميرية |
| العمليات المجمعة | drive_bulk_trash, drive_bulk_restore, drive_bulk_move, drive_bulk_purge |
نقل ما يصل إلى 5,000 عنصر محدد أو إرساله إلى المهملات أو استعادته أو حذفه نهائيا |
| الروابط العامة | drive_share_create, drive_share_list, drive_share_revoke |
إنشاء روابط تنزيل ذات مدة صلاحية أو حد معين ثم إلغاؤها لاحقا |
| عمليات الرفع | drive_file_upload, drive_upload_initiate, drive_upload_complete, drive_upload_refresh_parts, drive_upload_abort |
رفع الملفات المحلية باستخدام غلاف بسيط أو إدارة التدفق متعدد الأجزاء يدويا |
| حالة الإضافة | drive_addon_get, drive_addon_pricing, drive_addon_cancellation_preview |
قراءة حالة إضافة التخزين وسعرها من دون تغيير الفوترة |
| أجهزة المزامنة | drive_device_list, drive_device_create, drive_device_revoke, drive_device_rotate |
إنشاء كلمة مرور مستقلة لتطبيق مزامنة WebDAV أو مراجعتها أو إلغاؤها أو تدويرها |
متطلبات الرمز المميز
تستخدم أدوات Drive MCP متغير البيئة الخاص برمز العمليات:
TREKMAIL_API_TOKEN=tm_live_your_token
يجب أن يتضمن الرمز المميز نطاقات Drive المطابقة. على سبيل المثال، تتطلب drive_share_create نطاق مشاركة لمساحة Drive التي يوجد بها الملف. وتتطلب drive_file_purge نطاق حذف نهائي وبوابة الأدوات التدميرية. تحتاج أدوات أجهزة المزامنة إلى drive:devices:read أو drive:devices:write؛ ولا تظهر كلمة مرور الجهاز التي تم إنشاؤها إلا مرة واحدة. تتضمن استجاباتها قيمة server_url الصحيحة، بما فيها عنوان DAV يحمل العلامة التجارية فقط بعد أن تصبح شهادته ومضيفه المقيد جاهزين.
يمكنك تشغيل أدوات Drive إلى جانب أدوات الرسائل من خلال توفير TREKMAIL_MESSAGE_TOKEN أيضا. وتظل عائلتا الرموز المميزة منفصلتين.
بوابات الأمان
في خادم MCP يعمل عبر stdio ومستضاف ذاتيا، يمكن للمسؤول المحلي اشتراط TREKMAIL_ALLOW_DESTRUCTIVE=true قبل تشغيل أدوات الحذف النهائي وإفراغ المهملات. هذا عنصر تحكم محلي للأمان، وليس مفتاحا لميزة في منتج TrekMail. تظل عمليات المهملات العادية عمليات تعدل البيانات، ولذلك تتطلب نطاقات كتابة، لكنها قابلة للاستعادة ولا تتطلب نطاقات الحذف النهائي.
لإرسال البريد الإلكتروني وعمليات الكتابة الخاصة بالترحيل بوابات مستقلة. لا يؤدي تفعيل أدوات Drive التدميرية إلى تفعيل الإرسال أو عمليات كتابة الترحيل تلقائيا.
الرفع عبر MCP
استخدم drive_file_upload لمعظم مسارات العمل. فهي تقرأ ملفا محليا من مضيف MCP، وتطلب تعليمات الرفع، وترسل الملف إلى عنوان URL للرفع الذي تم إرجاعه، وتكمل الرفع، وتلغي الحجز إذا حدث خطأ.
تظل الأدوات منخفضة المستوى متاحة عندما يحتاج التكامل إلى تحكم أكبر، مثل الحالات التي تأتي فيها وحدات بايت الملف من خدمة أخرى أو من عملية نقل مخصصة.
روابط المشاركة عبر MCP
استخدم drive_share_create لإنشاء عنوان URL عام للتنزيل. عيّن expires_at وmax_downloads كلما غادر الرابط مؤسستك. استخدم drive_share_revoke عندما ينبغي أن يتوقف الرابط عن العمل. لا يظهر الرمز الخام إلا عند الإنشاء، لذلك ينبغي للوكلاء إرجاع عنوان URL العام الكامل على الفور.
حدود الفوترة
أدوات الإضافة مخصصة للقراءة فقط، وهي drive_addon_get وdrive_addon_pricing وdrive_addon_cancellation_preview. لا يمكن للوكلاء شراء إضافة Drive أو تغيير سعتها أو إلغاؤها عبر MCP. تظل هذه الإجراءات متاحة من لوحة المعلومات فقط وتحت تحكم المستخدم.
مقالات ذات صلة
انتقل إلى الأدلة القريبة التي تُكمل سير العمل.