‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

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

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

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

חברות בתוכנית של 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 Cloud ואז להגדיר את לקוח ה-MCP כך שיתחבר אליו.

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

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

CLI

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

מחליפים את PROJECT_ID במזהה של הפרויקט ב-Google Cloud.

המסוף

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

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

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

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

כשאתם מאמתים את שרת ה-MCP של Universal Search, אתם יכולים לבחור לאמת את כל ההיקפים המבוקשים או רק קבוצת משנה שלהם. השרת מכבד את הבחירות האלה ומחפש רק במוצרים שקיבלו הרשאת גישה.

לדוגמה, אם אתם מבצעים אימות עם כל ההיקפים הבאים:

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.

במסוף Google Cloud, נכנסים לדף Google Auth Platform > Data Access.
לוחצים על הוספה או הסרה של היקפי הרשאות.
מוסיפים אחד או יותר מההיקפים הבאים:
- 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

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

Antigravity

כדי להוסיף את שרת ה-MCP של החיפוש האוניברסלי ל-Antigravity, מוסיפים את הגדרות השרת לקובץ mcp_config.json. ההוראות האלה רלוונטיות ל-Antigravity 2.0, ל-Antigravity IDE ול-Antigravity CLI.

יוצרים מזהה לקוח וסוד ב-OAuth 2.0 מסוג אפליקציית אינטרנט. בקטע Authorized redirect URIs, לוחצים על ‎+ Add URI ומוסיפים את https://antigravity.google/oauth-callback בשדה URIs. בוחרים באפשרות שימוש בלקוח הזה לסוכן מבוסס-AI. הוראות מופיעות במאמר הגדרת שרתי 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. אתם יכולים לבצע אימות באמצעות הגדרות ה-GUI או ה-CLI:
- ב-Antigravity IDE או GUI (Antigravity 2.0):
  1. פותחים את מסך ההגדרות (למשל, לוחצים על הגדרות בפינה הימנית התחתונה או פותחים את הגדרות המשתמש של Antigravity).
  2. עוברים אל התאמות אישיות.
  3. בקטע שרתי MCP מותקנים, לוחצים על רענון.
  4. מוצאים את workspace-universal ברשימה, לוחצים על Authenticate, נכנסים לחשבון Google, מעתיקים את קוד ההרשאה, מדביקים אותו בתיבת הדו-שיח של הקלט ולוחצים על Submit.
- ב-Antigravity CLI:
  1. מפעילים את Antigravity CLI:
```
agy
```
  2. כדי לפתוח את לוח הבקרה האינטראקטיבי של MCP, מריצים את הפקודה:
```
/mcp
```
  3. משתמשים במקשי החיצים כדי לבחור את workspace-universal, עוברים לפעולה אימות ולוחצים על Enter. משלימים את תהליך הכניסה בדפדפן, מעתיקים את קוד ההרשאה, מדביקים אותו בהנחיה בטרמינל ולוחצים על Enter.
מוודאים שהשרת מוגדר בצורה נכונה ופועל:
- ב-Antigravity IDE או GUI: הכפתור יציאה מוצג לצד workspace-universal בקטע התאמות אישיות > שרתי MCP מותקנים.
- ב-Antigravity CLI: פותחים את החלונית /mcp כדי לראות את שרתי ה-MCP שהוגדרו. שרתים מאומתים מציגים את הכיתוב Authed לצד השמות שלהם בתוך החלונית האינטראקטיבית של ממשק המשתמש בטקסט (TUI). אתם יכולים לבחור את השרת workspace-universal בתצוגת מרכז הבקרה כדי לבדוק את הסטטוס שלו ולראות רשימה של כל הכלים הזמינים בו.

Claude

כדי להוסיף את שרת ה-MCP של Universal Search ל-Claude, צריך להגדיר מחבר בהתאמה אישית.

יוצרים מזהה לקוח וסוד ב-OAuth 2.0 מסוג אפליקציית אינטרנט, ובוחרים באפשרות שימוש בלקוח הזה לנציג מבוסס-AI. הוראות מופיעות במאמר הגדרת שרתי 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 של Universal Search

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

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

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

כלים נתמכים

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

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

איך מאפשרים לסוכני AI לחפש בכל Workspace באמצעות Universal Search MCP Server for Workspace קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

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

Cloud Shell

מעטפת מקומית

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

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

CLI

המסוף

הגדרת מסך ההסכמה של OAuth

הגדרת לקוח ה-MCP

Antigravity

Claude

בדיקת שרת ה-MCP של Universal Search

כלים נתמכים

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