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

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

يستخدم خادم Universal Search MCP Server في 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 لميزة "البحث الشامل"

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

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

لاستخدام خادم بروتوكول سياق النموذج (MCP) للبحث الشامل، يجب تفعيل واجهة برمجة تطبيقات بروتوكول سياق النموذج (MCP) في Google Workspace في مشروعك على السحابة الإلكترونية على Google Cloud:

CLI

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

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

وحدة التحكّم

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

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

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

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

عند المصادقة باستخدام خادم 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

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

ومع ذلك، إذا منحت إذن الوصول إلى 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/gmail.readonly)، لن يعرض البحث الشامل سوى النتائج من Google Drive و"تقويم Google" وGoogle Chat. ولا يبحث في بريدك الإلكتروني أو يعرض نتائج من Gmail.

في وحدة تحكّم Google Cloud، انتقِل إلى Google Auth Platform > الوصول إلى البيانات.
انقر على إضافة نطاقات أو إزالتها.
أضِف نطاقًا واحدًا أو أكثر من النطاقات التالية:
- 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
انقر على تعديل ثم على حفظ.

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

ضبط عميل MCP

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

Antigravity

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

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

أضِف إعدادات 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: سر العميل الذي أنشأته.

وفِّر ‎mcp_config.json.
مصادقة خادم 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.
تأكَّد من أنّ الخادم تم ضبطه بشكل صحيح وأنّه قيد التشغيل:
- في Antigravity IDE أو واجهة المستخدم الرسومية: يظهر زر تسجيل الخروج بجانب workspace-universal ضمن التخصيصات > خوادم MCP المثبَّتة.
- بالنسبة إلى Antigravity CLI: افتح لوحة /mcp لعرض خوادم MCP التي تم ضبطها. تعرض الخوادم التي تم التحقّق منها والمصادقة عليها الحالة تمت المصادقة بجانب أسمائها داخل لوحة TUI التفاعلية. يمكنك اختيار خادم workspace-universal ضمن عرض لوحة البيانات لفحص حالته وإدراج جميع الأدوات المتاحة فيه.

Claude

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

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

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

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

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

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

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

يوفّر خادم MCP الخاص بـ Universal Search الأداة التالية:

‫search_corpus: تُجري هذه الأداة عملية بحث في عدة منتجات ضمن Google Workspace (مثل Google Drive وGmail و"تقويم Google" وGoogle Chat) استنادًا إلى طلب البحث المقدَّم.

السماح لوكلاء الذكاء الاصطناعي بالبحث في Workspace باستخدام خادم Universal Search MCP لـ Workspace تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

Cloud Shell

Local shell

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

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

CLI

وحدة التحكّم

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

ضبط عميل MCP

Antigravity

Claude

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

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

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