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

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

يوفر خادم Universal Search MCP طريقة موحّدة لوكلاء الذكاء الاصطناعي للبحث عن المعلومات في حساب 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:

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

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

  1. في Google Cloud Console، انتقِل إلى 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

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

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

إعداد عميل MCP

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

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. للتعرُّف على التعليمات، يُرجى الاطّلاع على مقالة إعداد خوادم Google Workspace MCP.

  2. افتح ملف الإعداد ~/.gemini/antigravity/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. أكمِل عملية تسجيل الدخول في متصفحك، وانسخ رمز التفويض، والصقه في طلب الوحدة الطرفية، واضغط على Enter.

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

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

Claude

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

  1. أنشئ معرّف عميل OAuth 2.0 وسر عميل من نوع تطبيق ويب. للتعرُّف على التعليمات، يُرجى الاطّلاع على مقالة إعداد خوادم Google Workspace MCP.

  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.

اختبار خادم Universal Search MCP

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

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

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

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

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

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