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

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

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

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

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

أن تكون مشتركًا في برنامج معاينة Google Workspace للمطوّرين
مشروع Google Cloud لإنشاء مشروع، يُرجى الاطّلاع على مقالة إنشاء مشروع.
أحد برامج MCP، مثل Google Antigravity
لتنفيذ الأوامر الواردة في هذه الصفحة، عليك إعداد gcloud CLI في إحدى بيئات التطوير التالية:
Cloud Shell
لاستخدام وحدة طرفية على الإنترنت مع إعداد gcloud CLI مسبقًا، فعِّل Cloud Shell باتّباع الخطوات التالية:

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

ضبط إعدادات خادم Universal Search MCP

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

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

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

Gmail API
Google Drive API
Google Calendar API
Google Chat API
Google Workspace MCP API

CLI

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
workspacemcp.googleapis.com --project=PROJECT_ID

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

وحدة التحكّم

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

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

يستخدم خادم "بروتوكول سياق النموذج" (MCP) في "البحث الشامل" بروتوكول OAuth 2.0 للمصادقة والتفويض. يجب إعداد شاشة طلب موافقة OAuth قبل إنشاء معرّف عميل OAuth.

إذا سبق لك إعداد شاشة طلب موافقة OAuth لخوادم MCP أخرى، تأكَّد من إضافة النطاقات المطلوبة لخادم 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 للمصادقة > الوصول إلى البيانات.
انقر على إضافة نطاقات أو إزالتها.
أضِف نطاقًا واحدًا أو أكثر من النطاقات التالية:
- 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
انقر على تعديل، ثم على حفظ.

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

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

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

Antigravity

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

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

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

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

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

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

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

Cloud Shell

Local shell

ضبط إعدادات خادم Universal Search MCP

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

CLI

وحدة التحكّم

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

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

Antigravity

Claude

اختبار خادم MCP للبحث الشامل

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

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