איך מאפשרים לסוכני 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 של החיפוש האוניברסלי מספק דרך סטנדרטית לסוכני AI לחפש מידע בכל חשבון 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 באמצעות המאגר המאוחד לניהול זהויות. איך נכנסים ל-CLI של gcloud באמצעות הזהות המאוחדת?
    3. מאתחלים את ה-CLI של gcloud.

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

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

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

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

  • ממשק ה-API של Gmail
  • 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.

המסוף

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

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

שרת ה-MCP של החיפוש האוניברסלי משתמש ב-OAuth 2.0 לאימות ולהרשאה. צריך להגדיר את מסך ההסכמה ל-OAuth לפני שיוצרים מזהה לקוח OAuth.

אם כבר הגדרתם את מסך ההסכמה של OAuth לשרתי MCP אחרים, ודאו שהוספתם את היקפי ההרשאות הנדרשים לשרת ה-MCP של חיפוש אוניברסלי.

כשמבצעים אימות באמצעות שרת 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, עוברים אל Google Auth Platform ‏> Data Access.
  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

כדי להוסיף את שרת ה-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/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. אפשר לבצע אימות באמצעות ההגדרות בממשק המשתמש הגרפי או באמצעות ה-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. מוודאים שהשרת מוגדר ופועל בצורה נכונה:

    • ב-Antigravity IDE או GUI: הכפתור Sign out (יציאה) מוצג לצד workspace-universal בקטע Customizations (התאמות אישיות) > Installed MCP Servers (שרתי 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 שאלות שדורשות חיפוש במוצרים שונים:

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

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

כלים נתמכים

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

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