איך מאפשרים לסוכני AI לחפש בכל Workspace באמצעות Universal Search MCP Server for Workspace

שרת ה-MCP של חיפוש אוניברסלי ל-Google Workspace משתמש בתקן Model Context Protocol‏ (MCP) כדי לאפשר לסוכני AI לחפש בפריטים שלכם ב-Workspace. השרת הזה מאפשר לחפש בכמה מוצרים של Google Workspace, כולל הודעות Gmail, קבצים ב-Google Drive, אירועים ביומן Google ומרחבים והודעות ב-Google Chat, באמצעות כלי אחד.

שרת ה-MCP של Universal Search מספק דרך סטנדרטית לסוכני בינה מלאכותית לחפש מידע בכל חשבון Google Workspace שלכם, מבלי להזדקק לכלים ספציפיים למוצר.

דרישות מוקדמות

  • פרויקט ב-Google Cloud. כדי ליצור פרויקט, אפשר לעיין במאמר בנושא יצירת פרויקט.

  • לקוח MCP, כמו Google Antigravity.

  • כדי להריץ את הפקודות שבדף הזה, צריך להגדיר את ה-CLI של gcloud באחת מסביבות הפיתוח הבאות:

    Cloud Shell

    כדי להשתמש במסוף מקוון כאשר ה-CLI של gcloud כבר מוגדר, הפעל את Cloud Shell:

    הפעלת Cloud Shell

    מעטפת מקומית

    כדי להשתמש בסביבת פיתוח מקומית:

    1. מתקינים את Google Cloud CLI. אם התקנתם את ה-CLI של gcloud בעבר, צריך לוודא שפועלת אצלכם הגרסה העדכנית ביותר של gcloud components update.
    2. אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות. למידע נוסף, ראה היכנס ל-gcloud CLI עם הזהות המאוחדת שלך.
    3. מאתחלים את ה-CLI של gcloud.

הגדרת שרת MCP של חיפוש אוניברסלי

כדי להשתמש בשרת MCP של החיפוש האוניברסלי, צריך להפעיל אותו בפרויקט בענן של Google ואז להגדיר את לקוח ה-MCP להתחבר אליו.

הפעלת ממשקי ה-API

כדי להשתמש בשרת Universal Search MCP, הפעל את ממשק ה-API של Google Workspace MCP ואת ממשקי ה-API עבור המוצרים שברצונך לחפש בפרויקט Google Cloud שלך:

  • ממשק ה-API של Gmail
  • Google Drive API
  • Google Calendar API
  • Google Chat API

  • ממשק ה-API של MCP של Google Workspace

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.

המסוף

מפעילים את ממשקי ה-API במסוף Google Cloud:

הפעלת ממשקי ה-API

שרת ה-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

שרת 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, עבור אל פלטפורמת האימות של גוגל > גישה לנתונים.
  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. לוחצים על עדכון ואז על שמירה.

הוראות מפורטות להגדרת מסך ההסכמה מופיעות במאמר בנושא הגדרת שרתי MCP של Google Workspace.

הגדרת לקוח MCP

כדי להוסיף את שרת ה-MCP של Universal Search ללקוח ה-MCP, פועלים לפי ההוראות של הלקוח.

Antigravity

כדי להוסיף את שרת Universal Search MCP ל-Antigravity, הוסף את תצורת השרת לקובץ mcp_config.json שלך. ההוראות האלה תומכות ב-Antigravity 2.0, ב-Antigravity IDE וב-Antigravity CLI.

  1. יוצרים מזהה לקוח וסוד לקוח ב-OAuth 2.0 מסוג אפליקציית אינטרנט. בקטע Authorized redirect URIs (כתובות URI מורשות להפניה אוטומטית), לוחצים על + Add URI (הוספת כתובת URI) ואז מוסיפים את https://antigravity.google/oauth-callback בשדה URIs (כתובות 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. ניתן לאמת באמצעות הגדרות ה-GUI או ממשק שורת הפקודה (CLI):

    • ב-Antigravity IDE או GUI‏ (Antigravity 2.0):

      1. פותחים את מסך ההגדרות (למשל, לוחצים על הגדרות בפינה הימנית התחתונה או פותחים את הגדרות המשתמש של Antigravity).
      2. עוברים אל התאמות אישיות.
      3. בקטע Installed MCP Servers (שרתי MCP מותקנים), לוחצים על Refresh (רענון).
      4. מחפשים את workspace-universal ברשימה, לוחצים על אימות, נכנסים לחשבון Google, מעתיקים את קוד ההרשאה, מדביקים אותו בתיבת הדו-שיח של הקלט ולוחצים על שליחה.

    • ב-Antigravity CLI:

      1. מפעילים את Antigravity CLI:

        agy

      2. כדי לפתוח את חלונית הניהול האינטראקטיבית של MCP, מריצים את הפקודה:

        /mcp

      3. משתמשים במקשי החיצים כדי לבחור באפשרות workspace-universal, עוברים לפעולה Authenticate ומקישים על Enter. השלם את תהליך הכניסה בדפדפן שלך, העתק את קוד האישור, הדבק אותו בשורת הפקודה במסוף ולחץ על Enter.

  6. מוודאים שהשרת מוגדר ופועל בצורה נכונה:

    • עבור IDE או GUI של Antigravity: כפתור התנתק מוצג ליד workspace-universal תחת התאמות אישיות > שרתי MCP מותקנים.
    • ב-Antigravity CLI: פותחים את החלונית /mcp כדי לראות את שרתי ה-MCP שהוגדרו. בשרתים מאומתים ומאומתים מוצג הכיתוב Authed לצד השמות שלהם בחלונית האינטראקטיבית של TUI. אפשר לבחור את שרת workspace-universal בתצוגת לוח הבקרה כדי לבדוק את הסטטוס שלו ולראות רשימה של כל הכלים שזמינים בו.

Claude

כדי להוסיף את שרת ה-MCP של Universal Search ל-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.

בדיקת שרת ה-MCP של החיפוש האוניברסלי

כדאי לנסות לשאול את לקוח ה-MCP שאלות שדורשות חיפוש במוצרים שונים:

  • "תמצא כל דבר שקשור לפרויקט X באימייל, במסמכים ובהודעות הצ'אט שלי".
  • "מתי הפגישה הבאה שלי בנושא תוכנית השיווק, ומהן ההערות וההודעות האחרונות בצ'אט בנושא?"

אם הכלים מופעלים בהצלחה ואתם מקבלים תגובות רלוונטיות מכמה מוצרים, סימן שהגדרתם את שרת ה-MCP של החיפוש האוניברסלי בצורה נכונה.

כלים נתמכים

שרת ה-MCP של Universal Search מציע את הכלי הבא:

  • ‫search_corpus: מבצע חיפוש בכמה מוצרים של Google Workspace (‏Google Drive,‏ Gmail, יומן Google ו-Google Chat) על סמך השאילתה שסופקה.