ضبط خوادم MCP في Google Workspace

معاينة المطور: تتوفّر كجزء من برنامج معاينة المطور في Google Workspace، الذي يمنح استخدام المنتج قبل إطلاقه لميزات معيّنة.

يوفّر Google Workspace خوادم بروتوكول سياق النموذج (MCP) عن بُعد تتيح لوكلاء الذكاء الاصطناعي التفاعل بأمان مع بيانات Google Workspace. من خلال ضبط خوادم MCP في Google Workspace، يمكنك تفعيل تطبيقات الذكاء الاصطناعي، مثل Google Antigravity وClaude، لتنفيذ الإجراءات في تطبيقات Google Workspace، مثل Gmail وGoogle Drive و"مستندات Google" و"جداول بيانات Google" و"العروض التقديمية من Google" و"تقويم Google" وGoogle Chat وGoogle Classroom. لكل منتج من منتجات Google Workspace خادم MCP مخصّص له.

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

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

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

• الاشتراك في برنامج معاينة المطوّر في Google Workspace

• مشروع على Google Cloud لإنشاء مشروع، يُرجى الاطّلاع على إنشاء مشروع.

• برنامج MCP، مثل Google Antigravity

• لتشغيل الأوامر في هذه الصفحة، عليك إعداد gcloud CLI في بيئة تطوير محلية باتّباع الخطوات التالية:

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

• في حال ضبط خادم MCP في Google Classroom، يجب إنشاء صف دراسي تجريبي في Google Classroom يضم حساب طالب تجريبي واحد على الأقل. إذا لم يكن لديك صف في Google Classroom يمكنك استخدامه للاختبار، يمكنك إنشاء صف في واجهة المستخدم وإضافة طالب اختباري.

ضبط خوادم "بروتوكول سياق النموذج" (MCP) في Google Workspace

لاستخدام خوادم MCP في Google Workspace، يجب تفعيلها في مشروعك على Google Cloud، ثم ضبط عميل MCP للاتصال بها.

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

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

• Gmail API
• Google Drive API
• Google Docs API
• Google Sheets API
• Google Slides API
• Google Calendar API
• Google Chat API
• People API

• Google Classroom API

CLI

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
docs.googleapis.com \
sheets.googleapis.com \
slides.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
people.googleapis.com \
classroom.googleapis.com --project=PROJECT_ID

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

وحدة التحكّم

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

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

تفعيل خدمات MCP

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

• Gmail MCP API
• Google Drive MCP API
• Google Docs MCP API
• Google Sheets MCP API
• Google Slides MCP API
• Google Calendar MCP API
• Google Chat MCP API
• People MCP API

• Google Classroom MCP API

CLI

gcloud services enable gmailmcp.googleapis.com \
drivemcp.googleapis.com \
docsmcp.googleapis.com \
sheetsmcp.googleapis.com \
slidesmcp.googleapis.com \
calendarmcp.googleapis.com \
chatmcp.googleapis.com \
people.googleapis.com \
classroommcp.googleapis.com --project=PROJECT_ID

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

وحدة التحكّم

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

تفعيل خدمات MCP

ضبط إعدادات تطبيق Chat

لاستخدام خادم MCP في Google Chat، عليك ضبط تطبيق Chat في مشروعك على Google Cloud.

1. في Google Cloud Console، ابحث عن Google Chat API، وانقر على Google Chat API > إدارة > الإعدادات.

   الانتقال إلى Google Chat API

2. إعداد تطبيق Chat:

   1. في حقل اسم التطبيق، أدخِل Chat MCP.
   2. في حقل عنوان URL للأفاتار، أدخِل https://developers.google.com/chat/images/quickstart-app-avatar.png.
   3. في حقل الوصف، أدخِل Chat MCP server.
   4. ضمن الوظائف، أوقِف الميزات التفاعلية من خلال إيقاف خيار تفعيل الميزات التفاعلية.
   5. ضمن السجلّات، اختَر تسجيل الأخطاء في Logging.

3. انقر على حفظ.

لمزيد من المعلومات حول إنشاء تطبيق في Chat، يُرجى الاطّلاع على اختيار بنية تطبيق في Google Chat.

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

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

1. في Google Cloud Console، انتقِل إلى Google Auth Platform > الهوية البصرية.

   الانتقال إلى "هوية العلامة التجارية"

2. إذا سبق لك ضبط Google Auth Platform، يمكنك ضبط إعدادات شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth التالية في الهوية البصرية للعلامة التجارية والجمهور والوصول إلى البيانات. إذا ظهرت لك رسالة تفيد بأنّ منصة Google Auth لم يتم إعدادها بعد، انقر على البدء:

   1. ضمن معلومات التطبيق، في اسم التطبيق، اكتب Workspace MCP Servers.
   2. في حقل البريد الإلكتروني لدعم المستخدمين، اختَر عنوان بريدك الإلكتروني أو مجموعة Google المناسبة.
   3. انقر على التالي.
   4. ضمن الجمهور، اختَر داخلي. إذا لم تتمكّن من اختيار داخلي، اختَر خارجي.
   5. انقر على التالي.
   6. ضمن معلومات الاتصال، أدخِل عنوان بريد إلكتروني يمكن إرسال إشعارات إليك من خلاله بشأن أي تغييرات تطرأ على مشروعك.
   7. انقر على التالي.
   8. ضمن إنهاء، راجِع سياسة بيانات المستخدمين في خدمات Google API، وإذا وافقت عليها، اختَر أوافق على "سياسة بيانات المستخدمين في خدمات Google API".
   9. انقر على متابعة.
   10. انقر على إنشاء.
   11. إذا اخترت خارجي لنوع المستخدم، أضِف مستخدمين تجريبيين:
       1. انقر على الجمهور.
       2. ضمن المستخدمون التجريبيون، انقر على إضافة مستخدمين.
       3. أدخِل عنوان بريدك الإلكتروني وأي مستخدمين اختباريين معتمَدين آخرين، ثم انقر على حفظ.

3. انقر على الوصول إلى البيانات > إضافة نطاقات أو إزالتها. ستظهر لوحة تتضمّن قائمة بالنطاقات لكل واجهة برمجة تطبيقات فعّلتها في مشروعك على Google Cloud.

   1. ضمن إضافة النطاقات يدويًا، الصِق نطاقات خوادم MCP التي تريد استخدامها:

      • Gmail:
        • https://www.googleapis.com/auth/gmail.readonly
        • https://www.googleapis.com/auth/gmail.compose
      • Google Drive:
        • https://www.googleapis.com/auth/drive.readonly
        • https://www.googleapis.com/auth/drive.file
      • مستندات Google:
        • https://www.googleapis.com/auth/drive.readonly
        • https://www.googleapis.com/auth/drive.file
        • https://www.googleapis.com/auth/documents.readonly
        • https://www.googleapis.com/auth/documents
      • جداول بيانات Google:
        • https://www.googleapis.com/auth/drive.readonly
        • https://www.googleapis.com/auth/drive.file
        • https://www.googleapis.com/auth/spreadsheets.readonly
        • https://www.googleapis.com/auth/spreadsheets
      • العروض التقديمية من Google:
        • https://www.googleapis.com/auth/drive.readonly
        • https://www.googleapis.com/auth/drive.file
        • https://www.googleapis.com/auth/presentations.readonly
        • https://www.googleapis.com/auth/presentations
      • تقويم Google:
        • https://www.googleapis.com/auth/calendar.calendarlist.readonly
        • https://www.googleapis.com/auth/calendar.events.freebusy
        • https://www.googleapis.com/auth/calendar.events.readonly
      • Google Chat:
        • https://www.googleapis.com/auth/chat.spaces.readonly
        • https://www.googleapis.com/auth/chat.memberships.readonly
        • https://www.googleapis.com/auth/chat.messages.readonly
        • https://www.googleapis.com/auth/chat.messages.create
        • https://www.googleapis.com/auth/chat.users.readstate
      • People API:
        • https://www.googleapis.com/auth/directory.readonly
        • https://www.googleapis.com/auth/userinfo.profile
        • https://www.googleapis.com/auth/contacts.readonly
      • ‫Google Classroom:
        • https://www.googleapis.com/auth/classroom.announcements
        • https://www.googleapis.com/auth/classroom.courses.readonly
        • https://www.googleapis.com/auth/classroom.coursework.students
        • https://www.googleapis.com/auth/classroom.courseworkmaterials
        • https://www.googleapis.com/auth/classroom.rosters.readonly
        • https://www.googleapis.com/auth/classroom.student-submissions.students.readonly
        • https://www.googleapis.com/auth/classroom.topics.readonly

   2. انقر على إضافة إلى الجدول.

   3. انقر على تعديل.

   4. بعد اختيار النطاقات التي يتطلّبها تطبيقك، انقر على حفظ في صفحة الوصول إلى البيانات.

ضبط عميل MCP

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

Antigravity

لإضافة خوادم MCP عن بُعد في Google Workspace إلى Antigravity، أضِف إعدادات الخادم إلى ملف mcp_config.json. تنطبق هذه التعليمات على Antigravity 2.0 وAntigravity IDE وAntigravity CLI.

1. أنشئ معرّف عميل وسر عميل لبروتوكول OAuth 2.0:

   1. في وحدة تحكّم Google Cloud، انتقِل إلى Google Auth Platform > العملاء > إنشاء عميل

      الانتقال إلى "إنشاء عميل"

   2. اختَر تطبيق ويب كنوع التطبيق.

   3. أدخل اسمًا.

   4. في قسم معرِّفات الموارد المنتظمة (URI) المعتمَدة لإعادة التوجيه، انقر على + إضافة معرِّف الموارد المنتظم (URI)، ثم أضِف https://antigravity.google/oauth-callback في حقل معرِّفات الموارد المنتظمة (URI).

   5. اختَر استخدام هذا العميل لوكيل مستنِد إلى الذكاء الاصطناعي.

   6. انقر على إنشاء وانسخ معرّف العميل وسر العميل.

2. افتح ملف الإعداد ~/.gemini/config/mcp_config.json أو أنشئه.

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

   {
     "mcpServers": {
       "gmail": {
         "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
         "oauth": {
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET"
         }
       },
       "drive": {
         "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
         "oauth": {
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET"
         }
       },
       "docs": {
         "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
         "oauth": {
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET"
         }
       },
       "sheets": {
         "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
         "oauth": {
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET"
         }
       },
       "slides": {
         "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1",
         "oauth": {
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET"
         }
       },
       "calendar": {
         "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
         "oauth": {
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET"
         }
       },
       "chat": {
         "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
         "oauth": {
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET"
         }
       },
       "people": {
         "serverUrl": "https://people.googleapis.com/mcp/v1",
         "oauth": {
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET"
         }
       },
       "classroom": {
         "serverUrl": "https://classroommcp.googleapis.com/mcp/v1",
         "oauth": {
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET"
         }
       }
     }
   }
   

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

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

4. وفِّر ‎mcp_config.json.

5. مصادقة خوادم MCP يمكنك المصادقة باستخدام إعدادات واجهة المستخدم الرسومية أو واجهة سطر الأوامر:

   • بالنسبة إلى Antigravity IDE أو واجهة المستخدم الرسومية (Antigravity 2.0):

     1. افتح شاشة الإعدادات (على سبيل المثال، انقر على الإعدادات في أسفل يمين الصفحة أو افتح إعدادات مستخدم Antigravity).
     2. انتقِل إلى التخصيصات.
     3. ضمن خوادم MCP المثبّتة، انقر على إعادة تحميل.
     4. بالنسبة إلى كل خادم مدرَج (gmail وdrive وdocs وsheets وslides وcalendar وchat وpeople وclassroom)، انقر على مصادقة، ثم سجِّل الدخول إلى حساب Google وانسخ رمز التفويض والصقه في مربّع حوار الإدخال، ثم انقر على إرسال.

   • في Antigravity CLI:

     1. ابدأ Antigravity CLI:

        agy
        

     2. افتح لوحة إدارة MCP التفاعلية من خلال تشغيل:

        /mcp
        

     3. مصادقة كل خادم MCP:

        1. استخدِم مفاتيح الأسهم لاختيار الخادم، ثم انتقِل إلى الإجراء مصادقة واضغط على مفتاح Enter. أكمِل عملية تسجيل الدخول في المتصفّح، وانسخ رمز التفويض، والصقه في طلب Terminal، ثم اضغط على مفتاح Enter.
        2. كرِّر هذه الخطوات لكل خادم تم ضبطه (gmail وdrive وdocs وsheets وslides وcalendar وchat وpeople وclassroom).

6. تأكَّد من ضبط الخوادم وتشغيلها بشكلٍ صحيح:

   • في Antigravity IDE أو واجهة المستخدم الرسومية: يظهر زر تسجيل الخروج بجانب كل خادم ضمن التخصيصات > خوادم MCP المثبَّتة.
   • بالنسبة إلى Antigravity CLI: افتح لوحة "/mcp" لعرض خوادم MCP التي تم ضبطها. تعرض الخوادم التي تم التحقّق منها والمصادقة عليها تمت المصادقة بجانب أسمائها داخل لوحة TUI التفاعلية. يمكنك اختيار أي خادم ضمن عرض لوحة البيانات لفحص حالته وعرض جميع الأدوات المتاحة له.

أصبحت خوادم MCP البعيدة جاهزة للاستخدام في Antigravity.

Claude

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

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

1. أنشئ معرّف عميل وسر عميل لبروتوكول OAuth 2.0:

   1. في وحدة تحكّم Google Cloud، انتقِل إلى Google Auth Platform > العملاء > إنشاء عميل

      الانتقال إلى "إنشاء عميل"

   2. اختَر تطبيق ويب كنوع التطبيق.

   3. أدخل اسمًا.

   4. في قسم معرّفات الموارد المنتظمة (URI) المعتمَدة لإعادة التوجيه، انقر على + إضافة معرّف موارد منتظم (URI)، ثم أضِف https://claude.ai/api/mcp/auth_callback في حقل معرّفات الموارد المنتظمة (URI).

   5. اختَر استخدام هذا العميل لوكيل مستنِد إلى الذكاء الاصطناعي.

   6. انقر على إنشاء وانسخ معرّف العميل وسر العميل.

2. اضبط إعدادات خادم MCP في Claude:

   1. في Claude.ai أو Claude Desktop، انتقِل إلى الإعدادات (Settings) (أو إعدادات المشرف (Admin settings)) > الموصِّلات (Connectors).
   2. انقر على إضافة موصِّل مخصّص.

   3. أدخِل تفاصيل الاتصال لمنتج Google Workspace الذي تريد إضافته:

      • اسم الخادم: اسم الخادم، مثل Gmail.
      • عنوان URL لخادم MCP عن بُعد: عنوان URL لمنتج Google Workspace، مثل أحد العناوين التالية:
        • ‫Gmail‏: https://gmailmcp.googleapis.com/mcp/v1
        • ‫Google Drive: ‏ https://drivemcp.googleapis.com/mcp/v1
        • "مستندات Google": ‏https://docsmcp.googleapis.com/mcp/v1
        • "جداول بيانات Google": ‏https://sheetsmcp.googleapis.com/mcp/v1
        • "العروض التقديمية من Google": ‏https://slidesmcp.googleapis.com/mcp/v1
        • "تقويم Google": https://calendarmcp.googleapis.com/mcp/v1
        • ‫Google Chat: ‏https://chatmcp.googleapis.com/mcp/v1
        • People API: https://people.googleapis.com/mcp/v1
        • ‫Google Classroom: ‏https://classroommcp.googleapis.com/mcp/v1

   4. في الإعدادات المتقدّمة، أدخِل معرّف عميل OAuth وسر عميل OAuth.

   5. انقر على إضافة.

   6. كرِّر هذه الخطوات لكل منتج من منتجات Google Workspace تريد إضافته.

غير ذلك

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

• اسم الخادم: googleworkspace

• الخوادم: لكل منتج من منتجات Google Workspace عنوان URL خاص بالخادم:

  • ‫Gmail‏: https://gmailmcp.googleapis.com/mcp/v1
  • ‫Google Drive: ‏ https://drivemcp.googleapis.com/mcp/v1
  • "مستندات Google": ‏https://docsmcp.googleapis.com/mcp/v1
  • "جداول بيانات Google": ‏https://sheetsmcp.googleapis.com/mcp/v1
  • "العروض التقديمية من Google": ‏https://slidesmcp.googleapis.com/mcp/v1
  • "تقويم Google": https://calendarmcp.googleapis.com/mcp/v1
  • ‫Google Chat: ‏https://chatmcp.googleapis.com/mcp/v1
  • People API: https://people.googleapis.com/mcp/v1
  • ‫Google Classroom: ‏https://classroommcp.googleapis.com/mcp/v1

• النقل: HTTP قابل للبث

• المصادقة: يستخدم خادم MCP عن بُعد في Google Workspace بروتوكول OAuth 2.0. عند إنشاء عميل OAuth 2.0، اختَر استخدام هذا العميل لوكيل مستنِد إلى الذكاء الاصطناعي. لمعرفة التفاصيل، يُرجى الاطّلاع على التعرّف على المصادقة والتفويض.

  يحتاج عميل MCP إلى رمز مميز لإعادة التحميل لمنع المستخدمين من تسجيل الدخول مرة أخرى كل ساعة تقريبًا. يُصدر خادم OAuth 2.0 من Google رمزًا مميزًا لإعادة التحميل فقط عندما يتضمّن طلب التفويض access_type=offline. طلب نطاق offline_access OpenID Connect (OIDC) فقط لا يؤدي إلى عرض رمز مميز. إذا كان عميل MCP يتيح استخدام مَعلمات التفويض المخصّصة، أضِف access_type=offline إلى طلب التفويض. للحصول على رمز مميز جديد لإعادة التحميل لمستخدم سبق أن منح الإذن بالوصول، أضِف أيضًا prompt=consent. إذا كان عميل MCP لا يتيح استخدام مَعلمات التفويض المخصّصة، على المستخدمين تسجيل الدخول مرة أخرى في كل مرة تنتهي فيها صلاحية رمز الدخول. لمعرفة التفاصيل، يُرجى الاطّلاع على إعادة تحميل رمز مميّز للوصول.

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

اختبار خوادم MCP في Google Workspace

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

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

• "ماذا قالت أريج في رسالتها الإلكترونية الأخيرة حول خطتنا التسويقية؟"

  يُفلتر العميل الرسائل الإلكترونية الواردة من "أريج" باستخدام gmail.search_threads، ويسترد محتوى سلسلة المحادثات الأخيرة باستخدام gmail.get_thread، ثم يلخّصها لك.

• "أريد صياغة رسالة إلكترونية إلى [e-mail] لإعلامه بأنّني أوافق على الخطة التسويقية".

  يستخدم العميل gmail.create_draft لإنشاء رسالة إلكترونية في مجلد المسودات، ما يتيح لك مراجعتها وإرسالها من Gmail.

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

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

• "أريد الاطّلاع على المحتوى الهيكلي لملاحظات الاجتماع في مستند Google".

  يجلب العميل بنية المستند ومحتواه باستخدام docs.read_doc.

• "قراءة ورقة البيانات Sheet1 من جدول بيانات Google بعنوان المبيعات الربع سنوية"

  يجلب العميل قيم الشبكة باستخدام sheets.get_values.

• "أريد الاطّلاع على التنسيق اللفظي للعرض التقديمي "نظرة عامة على المنتج" في "العروض التقديمية من Google"."

  يجلب العميل هياكل التصميم البصري للعرض التقديمي باستخدام slides.read_presentation.

• "ما هو موعد اجتماعي القادم مع أريج؟"

  يتحقّق العميل من جدولك الزمني باستخدام calendar.list_events ويشرح بالتفصيل اجتماعك التالي مع "أريج".

• "ما هو اسمي وفقًا لملفي الشخصي في حساب Google؟"

  يستخدم العميل people.get_user_profile لاسترداد معلومات ملفك الشخصي على Google Workspace.

• "ما هي الصفوف التي أدرّسها حاليًا؟"

  يتحقّق العميل من جدولك الزمني باستخدام "classroom.list_course_summaries" ويلخّص الدورات التدريبية النشطة التي تؤدي فيها دور المعلّم.

• "اكتب مسودة إشعار حول الرحلة الميدانية القادمة لصف الجيولوجيا".

  يستخدم العميل classroom.create_announcement لصياغة الإشعار، ويمكنك مراجعته ونشره في تطبيق Google Classroom.

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

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

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

إذا تم رفض طلباتك إلى خوادم MCP، تأكَّد من أنّ عميل OAuth 2.0 لديه الخيار استخدام هذا العميل لوكيل مستنِد إلى الذكاء الاصطناعي محدّدًا في Google Auth Platform > العملاء. إذا لم تتمكّن من تغيير هذا الإعداد في عميل OAuth حالي، أنشِئ عميل OAuth جديدًا مع اختيار استخدام هذا العميل لوكيل مستنِد إلى الذكاء الاصطناعي وعدِّل تطبيقك لاستخدامه. إذا كان عميل OAuth الحالي يُستخدم لكل من ميزات وكيل الذكاء الاصطناعي والميزات غير المرتبطة بالوكيل، يجب إنشاء عميل OAuth منفصل لوكيل الذكاء الاصطناعي والاحتفاظ بالعميل الحالي للميزات غير المرتبطة بالوكيل. للحصول على التعليمات، يُرجى الاطّلاع على ضبط عميل MCP وإدارة عملاء OAuth.

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

إذا طلبت خوادم MCP من "برمجة تطبيقات Google"، تنشئ "برمجة تطبيقات Google" عميل OAuth تلقائيًا لبرنامجك النصي وتديره، ولكن لا يمكنك اختيار استخدام هذا العميل لوكيل مستنِد إلى الذكاء الاصطناعي له. وينطبق ذلك حتى إذا كان النص البرمجي يستخدم مشروعًا عاديًا على Google Cloud. بدلاً من ذلك، اتّبِع الخطوات التالية:

1. في Google Cloud Console، انتقِل إلى Google Auth Platform > العملاء، وأنشئ عميل OAuth، ثم اختَر استخدام هذا العميل لإنشاء وكيل مستنِد إلى الذكاء الاصطناعي.
2. في النص البرمجي، استخدِم OAuth2 لمكتبة "برمجة تطبيقات Google" للسماح للمستخدمين باستخدام عميل OAuth هذا.
3. عند الاتصال بخوادم MCP، أرسِل الرمز المميز للوصول الذي تعرضه المكتبة بدلاً من الرمز المميز من ScriptApp.getOAuthToken.

ولن تتأثر مشاريع "برمجة تطبيقات Google" التي لا تستدعي خوادم MCP.

إذا طُلب منك تسجيل الدخول مرة أخرى كل ساعة تقريبًا، يعني ذلك أنّ عميل MCP لا يتلقّى رمزًا مميزًا لإعادة التحميل. يُصدر خادم OAuth 2.0 من Google رمزًا مميزًا لإعادة التحميل فقط عندما يتضمّن طلب التفويض access_type=offline. طلب نطاق offline_access OpenID Connect (OIDC) فقط لا يؤدي إلى عرض رمز مميز. إذا كان عميل MCP يتيح استخدام مَعلمات التفويض المخصّصة، أضِف access_type=offline إلى طلب التفويض. للحصول على رمز مميز جديد لإعادة التحميل لمستخدم سبق أن منح الإذن بالوصول، أضِف أيضًا prompt=consent. إذا كان عميل MCP لا يتيح استخدام مَعلمات التفويض المخصّصة، عليك تسجيل الدخول مرة أخرى في كل مرة تنتهي فيها صلاحية رمز الوصول. لمعرفة التفاصيل، يُرجى الاطّلاع على إعادة تحميل رمز مميّز للوصول.

المنتجات التي تشملها الخدمة

تتوافق منتجات Google Workspace التالية مع خوادم MCP في Google Workspace وتوفّر الأدوات التالية:

• Gmail
  • create_draft
  • get_message
  • get_thread
  • label_message
  • label_thread
  • list_drafts
  • list_labels
  • search_threads
  • unlabel_message
  • unlabel_thread
• Google Drive
  • copy_file
  • create_file
  • download_file_content
  • get_file_metadata
  • get_file_permissions
  • list_recent_files
  • read_file_content
  • search_files
• مستندات Google
  • read_doc
  • update_doc
• جداول بيانات Google
  • get_values
  • get_spreadsheet
  • update_spreadsheet
  • update_values
  • update_formulas
  • insert_dimension
• العروض التقديمية من Google
  • read_presentation
  • update_presentation
• تقويم Google
  • create_event
  • delete_event
  • get_event
  • list_calendars
  • list_events
  • respond_to_event
  • search_events
  • suggest_time
  • update_event
• Google Chat
  • search_conversations
  • list_messages
  • search_messages
  • send_message
  • mark_as_read
  • mark_as_unread
  • list_memberships
• People API
  • get_user_profile
  • search_contacts
  • search_directory_people
• Google Classroom
  • create_announcement
  • create_course_work
  • create_course_work_rubric
  • create_topic
  • get_announcements
  • get_course_roster
  • get_course_work
  • get_course_work_rubric
  • get_courses
  • get_guardian_info
  • list_announcement_summaries
  • list_course_summaries
  • list_course_work_submissions
  • list_course_work_summaries
  • list_topics
  • update_course_work

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

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

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

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

المواضيع ذات الصلة

• خوادم MCP في Google Workspace في Antigravity (درس تطبيقي حول الترميز)
• إنشاء وكيل ذكاء اصطناعي في Google Workspace باستخدام ADK وMCP
• موصلات خادم MCP في Google Workspace ضمن تطبيقات Gemini Enterprise