السماح لوكلاء الذكاء الاصطناعي بالبحث في Workspace باستخدام خادم Universal Search MCP لـ Workspace

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

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

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

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

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

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

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

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

  Cloud Shell

  لاستخدام وحدة طرفية على الإنترنت مع أداة سطر الأوامر gcloud التي تم إعدادها مسبقًا، فعِّل Cloud Shell:

  تفعيل Cloud Shell

  Local shell

  لاستخدام بيئة تطوير محلية، اتّبِع الخطوات التالية:

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

إعداد خادم MCP لميزة "البحث الشامل"

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

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

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

CLI

gcloud services enable workspacemcp.googleapis.com \
  --project=PROJECT_ID

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

وحدة التحكّم

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

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

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

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

إذا سبق لك ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth لخوادم MCP أخرى، يُرجى التأكّد من إضافة النطاقات المطلوبة لخادم MCP الخاص بـ Universal Search.

عند المصادقة باستخدام خادم Universal Search MCP، يمكنك اختيار مصادقة جميع النطاقات المطلوبة أو مجموعة فرعية منها فقط. يلتزم الخادم بهذه الخيارات ويبحث فقط في المنتجات التي تم منح الإذن بالوصول إليها.

على سبيل المثال، إذا تمت المصادقة باستخدام جميع النطاقات التالية:

• https://www.googleapis.com/auth/gmail.readonly
• https://www.googleapis.com/auth/drive.readonly
• https://www.googleapis.com/auth/calendar.readonly
• https://www.googleapis.com/auth/chat.messages.readonly
• https://www.googleapis.com/auth/chat.spaces.readonly
• https://www.googleapis.com/auth/chat.memberships.readonly

سيبحث خادم Universal Search MCP في Gmail وGoogle Drive و"تقويم Google" وGoogle Chat.

ومع ذلك، إذا حذفت https://www.googleapis.com/auth/gmail.readonly ومنحت إذن الوصول إلى https://www.googleapis.com/auth/drive.readonly وhttps://www.googleapis.com/auth/calendar.readonly وhttps://www.googleapis.com/auth/chat.messages.readonly وhttps://www.googleapis.com/auth/chat.spaces.readonly وhttps://www.googleapis.com/auth/chat.memberships.readonly فقط، لن يعرض البحث الشامل سوى النتائج من Google Drive و"تقويم Google" وGoogle Chat. ولا يبحث في بريدك الإلكتروني أو يعرض نتائج من Gmail.

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

3. أضِف نطاقًا واحدًا أو أكثر من النطاقات التالية:

   • https://www.googleapis.com/auth/gmail.readonly
   • https://www.googleapis.com/auth/drive.readonly
   • https://www.googleapis.com/auth/calendar.readonly
   • https://www.googleapis.com/auth/chat.messages.readonly
   • https://www.googleapis.com/auth/chat.spaces.readonly
   • https://www.googleapis.com/auth/chat.memberships.readonly

   يجب تضمين https://www.googleapis.com/auth/chat.spaces.readonly وhttps://www.googleapis.com/auth/chat.memberships.readonly ليتمكّن الخادم من معرفة المشاركين في كل محادثة على Google Chat. بدون هذه الإعدادات، يتم التعامل مع نتائج Google Chat على أنّها تمت مشاركتها خارجيًا، وقد تتطلّب تأكيدًا من المستخدم أو تتم فلترتها.

4. انقر على تعديل ثم على حفظ.

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

ضبط إعدادات عميل MCP

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

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

Antigravity

لإضافة خادم Universal Search MCP إلى Antigravity، يُرجى إضافة إعدادات الخادم إلى ملف mcp_config.json. تنطبق هذه التعليمات على Antigravity 2.0 وAntigravity IDE وAntigravity CLI.

1. أنشئ معرّف عميل وسر عميل OAuth 2.0 من نوع تطبيق ويب. في قسم معرّفات الموارد المنتظمة (URI) المعتمَدة لإعادة التوجيه، انقر على + إضافة معرّف الموارد المنتظم (URI)، ثم أضِف https://antigravity.google/oauth-callback في حقل معرّفات الموارد المنتظمة (URI). اختَر استخدام هذا العميل لوكيل مستنِد إلى الذكاء الاصطناعي. للحصول على التعليمات، يُرجى الاطّلاع على مقالة ضبط خوادم "بروتوكول سياق النموذج" (MCP) في Google Workspace.

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

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

   {
     "mcpServers": {
       "workspace-universal": {
         "serverUrl": "https://workspacemcp.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. ابحث عن workspace-universal في القائمة، وانقر على مصادقة، وسجِّل الدخول إلى حساب Google، وانسخ رمز التفويض، والصقه في مربّع حوار الإدخال، ثم انقر على إرسال.

   • في Antigravity CLI:

     1. بدء استخدام Antigravity CLI:

        agy
        

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

        /mcp
        

     3. استخدِم مفاتيح الأسهم لاختيار workspace-universal، وانتقِل إلى الإجراء مصادقة، ثم اضغط على مفتاح Enter. أكمِل عملية تسجيل الدخول في المتصفّح، وانسخ رمز التفويض، والصقه في طلب Terminal، ثم اضغط على مفتاح Enter.

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

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

Claude

لإضافة خادم Universal Search MCP إلى Claude، يجب إعداد موصِّل مخصّص.

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

2. في إعدادات Claude، أضِف موصّلاً مخصّصًا:

   • اسم الخادم: Universal Search MCP Server
   • عنوان URL لخادم MCP عن بُعد: https://workspacemcp.googleapis.com/mcp/v1
   • معرّف عميل OAuth وسر عميل OAuth: أدخِل بيانات الاعتماد.
   • النطاقات: يجب تضمين https://www.googleapis.com/auth/gmail.readonly وhttps://www.googleapis.com/auth/drive.readonly وhttps://www.googleapis.com/auth/calendar.readonly وhttps://www.googleapis.com/auth/chat.messages.readonly وhttps://www.googleapis.com/auth/chat.spaces.readonly وhttps://www.googleapis.com/auth/chat.memberships.readonly.

اختبار خادم MCP الخاص بميزة "البحث الشامل"

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

• "أريد العثور على أي محتوى مرتبط بالمشروع X في رسائلي الإلكترونية ومستنداتي ورسائل المحادثة".
• "ما هو موعد اجتماعي القادم حول خطة التسويق، وما هي آخر الملاحظات ورسائل المحادثة حولها؟"

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

الأدوات المتوافقة

يوفّر خادم MCP الخاص بـ Universal Search الأداة التالية. للاطّلاع على مخطّطات الإدخال والإخراج، يُرجى مراجعة مرجع MCP الخاص بميزة "البحث الشامل".

• search_corpus: تبحث في منتجات Google Workspace المتعددة، بما في ذلك Drive وGmail و"تقويم Google" و Chat، استنادًا إلى طلب البحث المقدَّم.