إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
Important
- هذه ميزة إصدار أولي.
- الهدف من ميزات المعاينة ليس الاستخدام في الإنتاج وقد يكون لها دالات مقيدة. تخضع هذه الميزات لشروط الاستخدام التكميلية، وهي تتوفر قبل الإصدار الرسمي حتى يتمكن العملاء من الوصول المبكر وتقديم الملاحظات.
نظرة عامة
| مُعرف خادم | اسم العرض | الوصف |
|---|---|---|
mcp_OneDriveRemoteServer |
العمل على IQ OneDrive | خادم MCP لعمليات OneDrive. استخدم هذا الخادم لإدارة الملفات والمجلدات في OneDrive الشخصية للمستخدم. تقتصر جميع عمليات الملفات على ≤5 ميغابايت. |
ملاحظة
- تظل الاتصالات الموجودة التي تستخدم الإصدارات السابقة من خوادم Microsoft MCP، مثل خادم Microsoft Teams MCP، مدعومة.
- بالنسبة لجميع الاتصالات الجديدة، استخدم أحدث خوادم Work IQ MCP، مثل Work IQ Teams.
الأدوات المتوفرة
getOnedrive
احصل على معلومات حول OneDrive الخاص بالمستخدم بما في ذلك بيانات تعريف محرك الأقراص والحصة النسبية ومعلومات المالك.
لا يتطلب وسائط.
getFolderChildrenInMyOnedrive
تعداد أفضل 20 ملفا ومجلدات (DriveItems) المضمنة في مجلد أصل محدد في OneDrive الخاص بالمستخدم.
المعلمات الاختيارية:
- parentFolderId: معرف المجلد الأصل الذي سيتم سرد ملفاته ومجلداته (افتراضي: "الجذر")
findFileOrFolderInMyOnedrive
البحث عن ملف أو مجلد (DriveItem) في OneDrive الخاص بالمستخدم بواسطة استعلام البحث. أكثر كفاءة من البحث في جميع الملفات التي يمكن الوصول إليها إذا كنت تعرف أن العنصر موجود في OneDrive الخاص بالمستخدم.
المعلمات المطلوبة:
- searchQuery: استعلام البحث؛ يمكن أن يكون اسم الملف بالكامل أو جزئيا
getFileOrFolderMetadataInMyOnedrive
احصل على بيانات التعريف لملف أو مجلد (DriveItem) من OneDrive الخاص بالمستخدم.
المعلمات المطلوبة:
- fileOrFolderId: معرف الملف أو المجلد في OneDrive الخاص بالمستخدم
getFileOrFolderMetadataByUrl
احصل على بيانات التعريف لملف أو مجلد (DriveItem) من عنوان URL للمشاركة. سيسمح فقط للمستخدمين الذين لديهم أذونات صريحة موجودة للوصول إلى الملف بالحصول على بيانات التعريف.
المعلمات المطلوبة:
- fileOrFolderUrl: عنوان URL للملف أو المجلد. لن يتم استرداد عنوان URL لمشاركته مع المستخدم؛ يجب أن يكون لديهم بالفعل وصول صريح
readSmallTextFileFromMyOnedrive
قراءة (تنزيل) ملف نصي من OneDrive الخاص بالمستخدم.
المعلمات المطلوبة:
- معرف الملف: معرف الملف (DriveItem) للقراءة/التنزيل
إنشاءSmallTextFileInMyOnedrive
إنشاء ملف نصي بحجم أقل من 5 ميغابايت أو تحميله إلى OneDrive الخاص بالمستخدم.
المعلمات المطلوبة:
- Filename: اسم الملف المراد إنشاؤه
- نص المحتوى: محتوى نصي للملف
المعلمات الاختيارية:
- parentFolderId: معرف المجلد الأصل (الافتراضي: "الجذر")
إنشاء مجلدInMyOnedrive
إنشاء مجلد جديد (DriveItem) في OneDrive الخاص بالمستخدم باعتباره تابعا للمجلد الأصل المحدد. إذا كان هناك مجلد بنفس الاسم موجود بالفعل، تتم إضافة لاحقة رقمية (على سبيل المثال، NewFolder (1)).
المعلمات المطلوبة:
- اسم المجلد: اسم المجلد المراد إنشاؤه
المعلمات الاختيارية:
- parentFolderId: معرف المجلد الأصل (الافتراضي: "الجذر")
إعادة تسميةFileOrFolderInMyOnedrive
أعد تسمية ملف أو مجلد (DriveItem) في OneDrive الخاص بالمستخدم. يجب أن يتوافق الاسم الجديد مع اصطلاحات التسمية.
المعلمات المطلوبة:
- fileOrFolderId: معرف الملف أو المجلد المراد إعادة تسميته
- newFileOrFolderName: الاسم الجديد للملف أو المجلد
المعلمات الاختيارية:
- Etag: قيمة ETag للتحكم في التزامن. تنجح العملية فقط إذا تطابق ETag الحالي ل DriveItem
حذف ملف أو مجلد في OneDrive الخاص بي
احذف ملفا أو مجلدا (DriveItem) من OneDrive الخاص بالمستخدم.
المعلمات المطلوبة:
- fileOrFolderId: معرف الملف أو المجلد المراد حذفه
المعلمات الاختيارية:
- Etag: قيمة ETag للتحكم في التزامن
مشاركة ملف أو مجلد في OneDrive الخاص بي
إرسال دعوة مشاركة لمنح أذونات القراءة/الكتابة على ملف أو مجلد (DriveItem) في OneDrive الخاص بالمستخدم.
المعلمات المطلوبة:
- fileOrFolderId: معرف الملف أو المجلد المراد مشاركته
- رسائل البريد الإلكتروني للمستلم: صفيف عناوين البريد الإلكتروني للمستلمين الذين يجب دعوتهم
- ادوار: صفيف من الأدوار لتعيينها. القيم المقبولة: "قراءة" و"كتابة" (تمنح "كتابة" صلاحيات لكل من القراءة والكتابة)
المعلمات الاختيارية:
- رساله: رسالة مخصصة لتضمينها في البريد الإلكتروني للدعوة (افتراضي: 'إليك الملف الذي نتعاون في العمل عليه.')
- إرسال دعوة: ما إذا كنت تريد إرسال دعوة مشاركة (افتراضي: صحيح)
تعيين تسمية الحساسية على الملف في OneDrive الخاص بي
تعيين وصف الحساسية لملف في OneDrive الخاص بالمستخدم.
المعلمات المطلوبة:
- معرف الملف: معرف الملف (DriveItem)
- sensitivityLabelId: معرف وصف الحساسية المراد تعيينه، أو سلسلة فارغة لإزالتها
المعلمات الاختيارية:
- assignmentMethod: أسلوب التعيين: "قياسي" أو "متميز" أو "تلقائي" أو "قيمة مستقبلية غير معروف" (افتراضي: "متميز")
- نص التبرير: نص التبرير لأغراض مراجعة الحسابات؛ مطلوب عند تخفيض تسمية أو إزالتها (افتراضي: "تم التغيير بواسطة MCPServer")
إنشاء ملف ثنائي صغير في MyOnedrive
إنشاء ملف ثنائي بحجم أقل من 5 ميغابايت عن طريق ترميز محتواه base64 إلى OneDrive المستخدم.
المعلمات المطلوبة:
- Filename: اسم الملف المراد إنشاؤه بما في ذلك ملحق الملف
- base64Content: محتوى الملف الثنائي المشفرة كسلسلة base64
المعلمات الاختيارية:
- parentFolderId: معرف المجلد الأصل (الافتراضي: "الجذر")
readSmallBinaryFileFromMyOneDrive
اقرأ ملفا ثنائيا بحجم أقل من 5 ميغابايت من OneDrive المستخدم. يتم إرجاع محتوى الملف كسلسلة مرمزة ب base64.
المعلمات المطلوبة:
- معرف الملف: معرف الملف (DriveItem) للقراءة أو التنزيل
copyFileOrFolderInMyOnedrive
انسخ ملفا أو مجلدا (DriveItem) إلى مجلد وجهة ضمن OneDrive المستخدم. هذه العملية غير متزامنة؛ يستخدم checkOperationStatusInMyOnedrive لمراقبة التقدم.
المعلمات المطلوبة:
- sourcefileid: معرف الملف أو المجلد المصدر (DriveItem) المراد نسخه
- destfolderid: معرف المجلد الوجهة (يجب أن يكون موجودا في OneDrive المستخدم)
المعلمات الاختيارية:
- newfilename: اسم جديد للعنصر المنسخ (افتراضيا للاسم الأصلي)
moveFileOrFolderInMyOnedrive
نقل ملف أو مجلد (DriveItem) إلى مجلد وجهة ضمن OneDrive المستخدم. هذه العملية غير متزامنة؛ يستخدم checkOperationStatusInMyOnedrive لمراقبة التقدم.
المعلمات المطلوبة:
- sourcefileid: معرف الملف أو المجلد المصدر (DriveItem) المراد نقله
- destfolderid: معرف المجلد الوجهة (يجب أن يكون موجودا في OneDrive المستخدم)
المعلمات الاختيارية:
- newfilename: اسم جديد للعنصر المنقول (افتراضيا إلى الاسم الأصلي)
تحقق من حالة العملية في MyOneDrive
تحقق من حالة عملية غير متزامنة (مثل النسخ أو النقل) باستخدام رمز العملية الذي تم إرجاعه من العملية الأصلية. إرجاع معلومات التقدم إذا كانت لا تزال قيد التقدم، أو تفاصيل الخطأ إذا فشلت، أو بيانات تعريف الملف أو المجلد النهائي إذا تم إكمالها بنجاح.
المعلمات المطلوبة:
-
رمز العملية: الرمز المميز للعملية الذي تم إرجاعه من عملية غير متزامنة مثل
copyFileOrFolderInMyOnedriveأوmoveFileOrFolderInMyOnedrive
الميزات الرئيسية
إدارة OneDrive
- الحصول على معلومات OneDrive (الحصة النسبية، المالك)
- الوصول إلى OneDrive الشخصي للمستخدم
- تستهدف جميع العمليات OneDrive الخاص بمستخدم مصادق عليه
البحث عن الملفات واكتشافها
- البحث في الملفات والمجلدات حسب الاسم داخل OneDrive الخاص بمستخدم
- الحصول على بيانات تعريف الملف أو المجلد حسب المعرف أو مشاركة عنوان URL
- استعراض محتويات المجلد (حتى 20 عنصرا)
عمليات الملفات
- إنشاء الملفات النصية والثنائية (≤5 ميغابايت)
- قراءة الملفات النصية والملفات الثنائية (≤5 ميغابايت)
- حذف الملفات باستخدام عنصر تحكم التزامن
- إعادة تسمية الملفات باستخدام حماية eTag
- نسخ الملفات والمجلدات ونقلها بشكل غير متزامن
إدارة المجلدات
- إنشاء مجلدات ذات مسارات أصل اختيارية
- لاحقة رقمية تلقائية لأسماء المجلدات المكررة
- محتويات مجلد القائمة (حتى 20 عنصرا)
- الحصول على بيانات تعريف المجلد
- حذف المجلدات التي بها عنصر تحكم التزامن
- إعادة تسمية المجلدات باستخدام حماية eTag
المشاركة والأذونات
- مشاركة الملفات والمجلدات مع المستخدمين
- التحكم في الوصول المستند إلى الدور (قراءة وكتابة)
- تنبيهات البريد الإلكتروني للمشاركة
- الرسائل المخصصة في الدعوات
الأمان والتوافق
- تطبيق أوصاف الحساسية وإزالتها
- أساليب تعيين متعددة (قياسية، مميزة، تلقائية)
- دعم مبررات التدقيق
- التحكم في التزامن باستخدام eTags
Notes
- تستهدف جميع العمليات OneDrive الشخصي للمستخدم المصادق عليه
- تقتصر عمليات الملفات على ≤5 ميغابايت للتحميل والتنزيل
- تدعم عمليات الحذف وإعادة التسمية eTags للتحكم في التزامن
- تتطلب المشاركة عناوين بريد إلكتروني صالحة وأذونات مناسبة
- تتطلب أوصاف الحساسية الترخيص والتكوين المناسبين
- ترجع قائمة المجلدات 20 عنصرا كحد أقصى بشكل افتراضي
ملاحظة
تخضع أسماء أدوات MCP والمعلمات للتغيير ويجب تجنب التبعيات ذات التعليمات البرمجية المضمنة. سيتم الاحتفاظ بدعم السيناريو.