ضبط خوادم MCP في 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 طريقة موحّدة لوكلاء الذكاء الاصطناعي من أجل:

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

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

ضبط خوادم "بروتوكول سياق النموذج" (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، ابحث عن 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.

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

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

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

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

    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
        • https://www.googleapis.com/auth/chat.users.spacesettings
      • 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، يُرجى اتّباع التعليمات الخاصة بالعميل.

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

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، انتقِل إلى الإعدادات > الموصِّلات أو إعدادات المشرف > الموصِّلات.
    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 الخاص بـ Developer Knowledge

خادم MCP الخاص بمعلومات المطوّرين هو خادم عن بُعد يبحث في مستندات المطوّرين الرسمية والمباشرة من Google Developers، بما في ذلك developers.google.com/workspace، لكي يتمكّن وكيل الذكاء الاصطناعي من البحث عن طرق واجهة برمجة التطبيقات الحالية ونطاقات OAuth وعيّنات التعليمات البرمجية بدلاً من الاعتماد فقط على بيانات التدريب. يوفّر هذا الخادم أدوات search_documents وget_documents وanswer_query، ويكمل خوادم "بروتوكول سياق النموذج" في Google Workspace التي تتيح لوكيلك اتخاذ إجراءات بشأن بيانات Google Workspace. من خلال إضافة خادم MCP الخاص بـ Developer Knowledge، يمكن لوكيلك الإجابة عن الأسئلة حول إنشاء التطبيقات باستخدام واجهات برمجة تطبيقات Google Workspace من المستندات الحالية.

لإضافة هذا الخادم إلى تطبيق الذكاء الاصطناعي، اتّبِع الخطوات الواردة في مقالة ضبط بيئة التطوير المتكاملة أو وكيل الترميز واختَر العميل. لمساعدة وكيلك في تحديد وقت البحث في المستندات والأداة التي يجب استخدامها، يمكنك أيضًا تثبيت مهارة وكيل retrieving-developer-knowledge.

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

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

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

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

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

  • "أريد صياغة رسالة إلكترونية إلى ariel@example.com لإعلامه بأنّني أوافق على الخطة التسويقية".

    يستخدم العميل 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.

  • "اطّلِع على مستندات Google Workspace الرسمية لمعرفة نطاق OAuth الذي تتطلّبه أداة Gmail create_draft، ثم اكتب مسودة رسالة إلكترونية إلى ariel@example.com لتأكيد الخطة التسويقية".

    إذا أضفت خادم MCP الخاص بـ Developer Knowledge، سيستدعي العميل search_documents للعثور على النطاق في مستندات مرجع Gmail MCP، ثم يستخدم gmail.create_draft لإنشاء المسودة.

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

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

يمكنك استخدام الأقسام التالية لحلّ المشاكل الشائعة المتعلّقة بالمصادقة والاتصال بخوادم MCP في Google Workspace.

التحقّق من أحداث سجلّ OAuth

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

الطلبات المرفوضة من عملاء OAuth المفوَّضين من المستخدمين

إذا تم رفض طلباتك إلى خوادم MCP، تأكَّد من أنّ معرّف عميل OAuth 2.0 المفوَّض من المستخدم لتدفق OAuth الثلاثي يتضمّن الخيار استخدام هذا العميل لوكيل مستنِد إلى الذكاء الاصطناعي محدّدًا في Google Auth Platform > العملاء:

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

للحصول على التعليمات، يُرجى الاطّلاع على ضبط عميل MCP وإدارة عملاء OAuth.

حسابات الخدمة التي لديها تفويض على مستوى النطاق

إذا كان تطبيقك يستخدم حساب خدمة مع تفويض على مستوى النطاق لبروتوكول OAuth الثنائي، لا يمكنك اختيار استخدام هذا العميل لوكيل مستنِد إلى الذكاء الاصطناعي لأنّه لا تتم إدارة حسابات الخدمة في منصة مصادقة Google > العملاء:

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

الطلبات من "برمجة تطبيقات Google"

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

لاستدعاء خوادم MCP من "برمجة تطبيقات Google"، اتّبِع الخطوات التالية:

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

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

طلبات تسجيل الدخول المتكرّرة كل ساعة

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

تحقَّق مما إذا كان عميل MCP يتيح مَعلمات التفويض المخصّصة:

  • إذا كان العميل يتيح استخدام مَعلمات التفويض المخصّصة: أضِف access_type=offline إلى طلب التفويض. للحصول على رمز مميز جديد لإعادة التحميل لمستخدم سبق أن منح إذن الوصول، أضِف أيضًا prompt=consent.
  • لا يتيح العميل استخدام مَعلمات التفويض المخصّصة: سجِّل الدخول مرة أخرى في كل مرة تنتهي فيها صلاحية رمز الدخول.

لمعرفة التفاصيل، يُرجى الاطّلاع على إعادة تحميل رمز مميّز للوصول.

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

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

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

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

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

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