ضبط خادم MCP في Drive

يوفّر Google Drive خادم بروتوكول سياق النموذج (MCP) عن بُعد يتيح لوكلاء الذكاء الاصطناعي التفاعل بأمان مع بيانات Google Drive. من خلال ضبط خادم MCP في Google Drive، يمكنك السماح لتطبيقات الذكاء الاصطناعي، مثل Gemini CLI أو Claude أو بيئات التطوير المتكاملة، بتنفيذ إجراءات في Google Drive.

يوفّر خادم MCP في Google Drive طريقة موحّدة لوكلاء الذكاء الاصطناعي من أجل:

قراءة البيانات: البحث في الملفات واسترداد البيانات الوصفية وقراءة محتوى الملف
اتّخاذ إجراء: إنشاء ملفات وتنزيل محتوى
احترام الأمان: يتم اكتساب الأذونات وعناصر التحكّم في إدارة البيانات نفسها التي يملكها المستخدم.

المتطلبات الأساسية

مشروع Google Cloud لإنشاء مشروع، يُرجى الاطّلاع على مقالة إنشاء مشروع.
أحد برامج MCP، مثل Gemini CLI
لتنفيذ الأوامر الواردة في هذه الصفحة، عليك إعداد gcloud CLI في بيئة تطوير محلية باتّباع الخطوات التالية:
1. ثبِّت Google Cloud CLI. إذا سبق لك تثبيت gcloud CLI، تأكَّد من استخدام أحدث إصدار من خلال تنفيذ الأمر gcloud components update.
2. في حال استخدام موفِّر هوية خارجي، سجِّل الدخول إلى gcloud CLI باستخدام هويتك الموحّدة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تسجيل الدخول إلى gcloud CLI باستخدام الهوية الموحّدة.
3. افتح gcloud CLI.

إعداد خادم MCP في Google Drive

لاستخدام خادم MCP في Google Drive، يجب تفعيله في مشروعك على السحابة الإلكترونية على Google Cloud، ثم ضبط برنامج MCP للربط به.

تفعيل واجهات برمجة التطبيقات

لاستخدام خادم MCP في Google Drive، يجب تفعيل واجهة برمجة التطبيقات التالية في مشروعك على Google Cloud:

Google Drive API

CLI

gcloud services enable drive.googleapis.com --project=PROJECT_ID

استبدِل PROJECT_ID برقم تعريف مشروعك على Google Cloud.

وحدة التحكّم

فعِّل واجهات برمجة التطبيقات في Google Cloud Console:

تفعيل واجهات برمجة التطبيقات

تفعيل خدمات MCP

لتفعيل مكوّنات MCP في Google Drive، يجب تفعيل الخدمة التالية في مشروعك على Google Cloud:

Google Drive MCP API

CLI

gcloud services enable drivemcp.googleapis.com --project=PROJECT_ID

استبدِل PROJECT_ID برقم تعريف مشروعك على Google Cloud.

وحدة التحكّم

فعِّل خدمات MCP في Google Cloud Console باتّباع الخطوات التالية:

تفعيل خدمات MCP

يستخدم خادم MCP في Google Drive بروتوكول OAuth 2.0 للمصادقة والتفويض. يجب إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth قبل إنشاء معرّف عميل OAuth.

في وحدة تحكّم Google Cloud، انتقِل إلى منصة Google للمصادقة > العلامة التجارية.

الانتقال إلى "هوية العلامة التجارية"
إذا سبق لك إعداد منصّة Google للمصادقة، يمكنك إعداد الإعدادات التالية في "شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth" ضمن العلامة التجارية والجمهور والوصول إلى البيانات. إذا ظهرت لك الرسالة لم يتم إعداد منصة Google Auth بعد، انقر على البدء:
1. ضمن معلومات التطبيق، في اسم التطبيق، اكتب Drive MCP Server.
2. في حقل البريد الإلكتروني لدعم المستخدمين، اختَر عنوان بريدك الإلكتروني أو مجموعة Google مناسبة.
3. انقر على التالي.
4. ضمن الجمهور، اختَر داخلي. إذا لم تتمكّن من اختيار داخلي، اختَر خارجي.
5. انقر على التالي.
6. ضمن معلومات الاتصال، أدخِل عنوان بريد إلكتروني يمكنك تلقّي إشعارات فيه بشأن أي تغييرات تطرأ على مشروعك.
7. انقر على التالي.
8. ضمن إنهاء، راجِع سياسة بيانات المستخدمين في خدمات Google API وإذا كنت توافق عليها، ضَع علامة في المربّع أوافق على "سياسة بيانات المستخدمين في خدمات Google API".
9. انقر على متابعة.
10. انقر على إنشاء.
11. إذا اخترت خارجي لنوع المستخدم، أضِف مستخدمين اختباريين:
  1. انقر على الجمهور.
  2. ضمن المستخدمون التجريبيون، انقر على إضافة مستخدمين.
  3. أدخِل عنوان بريدك الإلكتروني وأي مستخدمين اختباريين آخرين معتمَدين، ثم انقر على حفظ.
انقر على الوصول إلى البيانات > إضافة نطاقات أو إزالتها. ستظهر لوحة تتضمّن قائمة بنطاقات كل واجهة برمجة تطبيقات فعّلتها في مشروعك على Google Cloud.
1. ضمن إضافة النطاقات يدويًا، الصِق نطاقات خادم MCP في Google Drive:
  - https://www.googleapis.com/auth/drive.readonly
  - https://www.googleapis.com/auth/drive.file
2. انقر على إضافة إلى الجدول.
3. انقر على تعديل.
4. بعد اختيار النطاقات التي يتطلّبها تطبيقك، انقر على حفظ في صفحة الوصول إلى البيانات.

إعداد برنامج MCP

لإضافة خادم MCP بعيد على Google Drive إلى برنامج MCP، اتّبِع التعليمات الخاصة ببرنامجك.

Gemini CLI

لإضافة خادم MCP البعيد في Google Drive إلى واجهة سطر الأوامر (CLI) في Gemini، أضِف إعدادات الخادم إلى ملف settings.json.

أنشئ معرّف عميل وسرًا لبروتوكول OAuth 2.0:
1. في "وحدة تحكّم Google Cloud"، انتقِل إلى منصة Google للمصادقة > العملاء > إنشاء عميل.
  
  الانتقال إلى "إنشاء عميل"
2. اختَر تطبيق على الكمبيوتر كنوع التطبيق.
3. أدخل اسمًا.
4. انقر على إنشاء وانسخ معرّف العميل والرمز السري للعميل.
افتح ملف الإعداد ~/.gemini/settings.json أو أنشئه.

أضِف إعدادات mcpServers إلى settings.json:

{
  "mcpServers": {
    "drive": {
      "httpUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET",
        "scopes": [
          "https://www.googleapis.com/auth/drive.readonly",
          "https://www.googleapis.com/auth/drive.file"
        ]
      }
    }
  }
}

غيِّر القيم في السلسلة على الشكل التالي:

OAUTH_CLIENT_ID: معرّف العميل الذي أنشأته.
OAUTH_CLIENT_SECRET: سر العميل الذي أنشأته

وفِّر ‎settings.json.
ابدأ استخدام Gemini CLI:
```
gemini
```
في Gemini CLI، صادِق على خادم MCP من خلال تنفيذ الأمر التالي:
```
/mcp auth drive
```
1. عندما يُطلب منك ذلك، اضغط على 1 لفتح صفحة مصادقة في متصفّحك. إذا كنت تعمل عبر SSH، اتّبِع التعليمات الواردة في واجهة سطر الأوامر.
2. سجِّل الدخول إلى حسابك على Google.
3. راجِع نطاقات OAuth المطلوبة وانقر على السماح.
4. ستظهر رسالة تؤكّد نجاح المصادقة.

في Gemini CLI، شغِّل /mcp list للاطّلاع على خوادم MCP التي تم ضبطها وأدواتها.

تكون الاستجابة مشابهة لما يلي:

🟢 drive - Ready (7 tools)
  Tools:
  - create_file
  - download_file_content
  - get_file_metadata
  - get_file_permissions
  - list_recent_files
  - read_file_content
  - search_files

أصبح خادم MCP البعيد جاهزًا للاستخدام في Gemini CLI.

Claude

لاستخدام خادم MCP البعيد من Google Drive مع Claude.ai أو تطبيق Claude Desktop، يجب أن يكون لديك خطة Claude Enterprise أو Pro أو Max أو Team.

لإضافة خادم MCP البعيد في Google Drive إلى Claude، عليك ضبط موصّل مخصّص باستخدام معرّف عميل OAuth وسرّ.

أنشئ معرّف عميل وسرًا لبروتوكول OAuth 2.0:
1. في "وحدة تحكّم Google Cloud"، انتقِل إلى منصة Google للمصادقة > العملاء > إنشاء عميل.
  
  الانتقال إلى "إنشاء عميل"
2. اختَر تطبيق الويب كنوع التطبيق.
3. أدخل اسمًا.
4. في قسم معرّفات الموارد المنتظمة (URI) المعتمَدة لإعادة التوجيه، انقر على + إضافة معرّف الموارد المنتظمة (URI)، ثم أضِف https://claude.ai/api/mcp/auth_callback في حقل معرّفات الموارد المنتظمة (URI).
5. انقر على إنشاء وانسخ معرّف العميل والرمز السري للعميل.
إعداد خادم MCP في Claude:
1. في Claude.ai أو تطبيق Claude على الكمبيوتر، انتقِل إلى الإعدادات (أو إعدادات المشرف) > الموصِّلات.
2. انقر على إضافة موصِّل مخصّص.
3. أدخِل تفاصيل الربط لمنتج Google Drive:
  - اسم الخادم: Google Drive
  - عنوان URL لخادم MCP البعيد: https://drivemcp.googleapis.com/mcp/v1
4. في الإعدادات المتقدّمة، أدخِل معرّف عميل OAuth وسر عميل OAuth.
5. انقر على إضافة.

غير ذلك

تتوفّر في العديد من تطبيقات الذكاء الاصطناعي طرق للاتصال بخادم MCP بعيد. يجب عادةً إدخال تفاصيل حول الخادم، مثل اسمه ونقاط النهاية وبروتوكول النقل وطريقة المصادقة. بالنسبة إلى خادم MCP البعيد على Google Drive، أدخِل ما يلي:

اسم الخادم: drive
عنوان URL للخادم: https://drivemcp.googleapis.com/mcp/v1
النقل: HTTP
المصادقة: يستخدم خادم MCP البعيد في Google Drive بروتوكول OAuth 2.0. للحصول على التفاصيل، يُرجى الاطّلاع على لمحة عن المصادقة والتفويض.

لمزيد من التفاصيل حول ربط أنواع مختلفة من العملاء، يُرجى الاطّلاع على ضبط MCP في تطبيق يستند إلى الذكاء الاصطناعي.

اختبار خادم MCP في Google Drive

بعد إعداد عميل MCP، يمكنك التحقّق من الاتصال من خلال تنفيذ بعض الطلبات التجريبية.

جرِّب طرح الأسئلة التالية على عميل MCP:

"أريد تلخيص الملف "خطة التسويق".

يطلب العميل drive.search_files تحديد موقع "خطة التسويق"، ثم يستخدم drive.read_file_content لاسترداد محتواها وتلخيصه.

إذا تم تنفيذ الأدوات بنجاح وتلقّيت ردودًا ذات صلة، يعني ذلك أنّه تم إعداد خادم Google Drive MCP بشكلٍ صحيح.

تحديد المشاكل وحلّها

إذا واجهت مشاكل في الاتصال بخادم MCP، يمكنك التحقّق من وجود أخطاء في سجلّات OAuth. اطلب من المشرف التحقّق من أحداث سجلّ OAuth في أداة التحقيق الأمني.

مرجع الأداة

تتوفّر الأدوات التالية لخادم MCP في Google Drive:

create_file
download_file_content
get_file_metadata
get_file_permissions
list_recent_files
read_file_content
search_files

اعتبار مهم بشأن الأمان: حقن الطلبات غير المباشرة

عندما تعرّض نموذجًا لغويًا لبيانات غير موثوق بها، هناك خطر من حدوث هجوم حقن طلب غير مباشر. بما أنّ برامج MCP، مثل Gemini CLI، يمكنها الوصول إلى أدوات وواجهات برمجة تطبيقات فعّالة من خلال خادم MCP في Google Drive، يمكنها قراءة البيانات وتعديلها وحذفها في حسابك على Google.

لتقليل هذه المخاطر، اتّبِع أفضل الممارسات التالية:

استخدام الأدوات الموثوقة فقط: لا تربط أبدًا خادم MCP في Google Drive بتطبيقات غير موثوق بها أو لم يتم التحقّق منها.
توخَّ الحذر بشأن المدخلات غير الموثوق بها. تجنَّب الطلب من عميل MCP معالجة مستندات أو موارد أخرى من مصادر لم يتم التحقّق منها. قد تحتوي هذه المدخلات على تعليمات مخفية يمكنها اختراق جلستك، ما يسمح للمهاجم بتعديل بياناتك أو سرقتها أو حذفها.
راجِع جميع الإجراءات. ننصحك دائمًا بمراجعة الإجراءات التي يتّخذها عميل الذكاء الاصطناعي نيابةً عنك بعناية للتأكّد من أنّها صحيحة وتتوافق مع نواياك.

ضبط خادم MCP في Drive تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

المتطلبات الأساسية

إعداد خادم MCP في Google Drive

تفعيل واجهات برمجة التطبيقات

CLI

وحدة التحكّم

تفعيل خدمات MCP

CLI

وحدة التحكّم

إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth

إعداد برنامج MCP

Gemini CLI

Claude

غير ذلك

اختبار خادم MCP في Google Drive

تحديد المشاكل وحلّها

مرجع الأداة

اعتبار مهم بشأن الأمان: حقن الطلبات غير المباشرة

القسم ذو الصلة

ضبط خادم MCP في Drive