שרתי Google Workspace MCP ב-Antigravity

1. מבוא

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

ארכיטקטורת Google Workspace MCP

הפעולות שתבצעו:

  • מפעילים את שירותי Google Workspace MCP בפרויקט ב-Google Cloud.
  • מגדירים את Antigravity כדי לגשת לשירותי ה-MCP האלה.
  • כדאי לבדוק את השילוב באמצעות הנחיות מעניינות ושימושיות שיוצרות אינטראקציה עם הנתונים שלכם ב-Google Workspace.

הדרישות

  • דפדפן אינטרנט כמו Chrome
  • פרויקט ב-Google Cloud
  • חשבון Google Workspace
  • ‫Antigravity מותקן במחשב המקומי

גישה קלה ל-Codelab הזה

qr_code.png

‫2. לפני שמתחילים

יצירה או בחירה של פרויקט ב-Google Cloud

במסוף Google Cloud, בוחרים פרויקט או יוצרים פרויקט חדש ב-Google Cloud.

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

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

  • עדיין נדרשים ממשקי ה-API הרגילים של Gmail ושל Chat.
  • ב-Drive נדרש API רגיל לשימוש בכלים מסוימים.
  • יומן לא דורש הפעלה של Standard API.
  • ‫People API מטפל גם בהרשאת גישה רגילה וגם בפונקציונליות של MCP, ולכן אין לו שירות MCP נפרד שצריך להפעיל.

הפעלת שירותי MCP

לאחר מכן, מפעילים את שירותי ה-MCP הייעודיים למוצרים.

הגדרת אפליקציית Chat

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

  1. במסוף Google Cloud, מחפשים את Google Chat API ולוחצים על Google Chat API > Manage > Configuration.

  1. מגדירים את אפליקציית Chat:
    • בשדה App name, מזינים Chat MCP.
    • בשדה כתובת ה-URL של האווטאר, מזינים https://developers.google.com/chat/images/quickstart-app-avatar.png.
    • בקטע תיאור, מזינים Chat MCP server.
    • בקטע פונקציונליות, משביתים את האפשרות הפעלת תכונות אינטראקטיביות.
    • בקטע יומנים, בוחרים באפשרות רישום שגיאות ביומן.
  2. לוחצים על שמירה.

chat_app.png

3. הגדרת הסכמה ולקוח OAuth

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

שרתי ה-MCP של Google Workspace משתמשים ב-OAuth 2.0 לאימות. קודם צריך להגדיר את מסך ההסכמה.

  1. במסוף Google Cloud, עוברים אל Google Auth Platform (פלטפורמת אימות של Google) > Branding (מיתוג). אם האפשרות לא מוגדרת, לוחצים על שנתחיל?.
  2. הגדרת פרטי האפליקציה:
    • שם האפליקציה: Google Workspace MCP Servers
    • User support email (כתובת אימייל לתמיכה במשתמשים): בוחרים את כתובת האימייל.
  3. מגדירים את הקהל: בוחרים באפשרות פנימי (או חיצוני אם האפשרות 'פנימי' לא זמינה).
  4. מגדירים את פרטי הקשר: מזינים את כתובת האימייל.
  5. קוראים ומאשרים את המדיניות בנושא נתוני משתמשים, ואז לוחצים על יצירה.
  6. אם בחרתם באפשרות חיצוני, עוברים אל קהל ומוסיפים את כתובת האימייל שלכם בקטע משתמשי בדיקה.
  7. עוברים אל גישה לנתונים > הוספה או הסרה של היקפי גישה. בקטע הוספת היקפים באופן ידני, מוסיפים את ההיקפים הבאים לשרתים שבהם רוצים להשתמש:
    • יומן Google: https://www.googleapis.com/auth/calendar.calendarlist.readonly, https://www.googleapis.com/auth/calendar.events.freebusy, https://www.googleapis.com/auth/calendar.events.readonly
    • ‫Google Chat: https://www.googleapis.com/auth/chat.spaces.readonly, https://www.googleapis.com/auth/chat.memberships.readonly, https://www.googleapis.com/auth/chat.messages.readonly, https://www.googleapis.com/auth/chat.users.readstate.readonly
    • ‫Google Drive: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file
    • ‫Gmail: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/gmail.compose
    • ‫People API: https://www.googleapis.com/auth/directory.readonly, https://www.googleapis.com/auth/userinfo.profile, https://www.googleapis.com/auth/contacts.readonly
  8. לוחצים על הוספה לטבלה, ואז על עדכון ולבסוף על שמירה.

oauth_consent_screen.png

יצירת מזהה לקוח OAuth

  1. עוברים אל פלטפורמת האימות של Google > לקוחות > יצירת לקוח.
  2. בוחרים באפשרות Web application (אפליקציית אינטרנט) כסוג האפליקציה.
  3. נותנים לו את השם Antigravity.
  4. בקטע Authorized redirect URIs (כתובות URI מורשות להפניה אוטומטית), לוחצים על + Add URI (הוספת כתובת URI) ואז מזינים את https://antigravity.google/oauth-callback.
  5. לוחצים על Create ומעתיקים את Client ID ואת Client Secret. תצטרכו אותם בשלב הבא.

oauth_client.png

4. הגדרת Antigravity

עכשיו נגדיר את Antigravity לשימוש בנקודות הקצה האלה. אם לא התקנתם את Antigravity, פועלים לפי הוראות ההתקנה באתר Antigravity.

הוספה של שרתי MCP בהתאמה אישית

  1. פותחים את MCP Servers דרך התפריט הנפתח ... בחלק העליון של חלונית הסוכן בכלי העריכה.

open_mcp_servers.png

  1. לוחצים על Manage MCP Servers (ניהול שרתי MCP) ואז על View raw config (הצגת הגדרות גולמיות).

manage_mcp_servers.png

  1. משנים את הקובץ mcp_config.json שנפתח לפי ההגדרות הבאות של שרת MCP בהתאמה אישית. לפני שממשיכים, מחליפים את ה-placeholder‏ <YOUR_CLIENT_ID> ואת ה-placeholder‏ <YOUR_CLIENT_SECRET> במזהה לקוח OAuth ובסוד הלקוח שיצרתם בשלבים הקודמים:
{
  "mcpServers": {
    "gws-calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-gmail": {
      "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
  }
}

mcp_config.png

  1. חוזרים אל Manage MCP Servers (ניהול שרתי MCP) ולוחצים על Refresh (רענון).

configured_mcp_servers.png

אימות של שרתי MCP בהתאמה אישית

  1. פותחים את Antigravity User Settings (הגדרות משתמש של Antigravity) דרך התפריט הנפתח Editor-Specific settings (הגדרות ספציפיות לעורך) בחלק העליון של החלון.

open_user_settings.png

  1. עוברים אל התאמות אישיות.

customizations.png

  1. לכל שרת שמופיע בקטע INSTALLED MCP SERVERS:
    1. לוחצים על אימות.

installed_servers.png

  1. מבצעים את תהליך האימות בחלון הדפדפן החדש שנפתח.
  2. בסיום, לוחצים על העתקה ללוח.

copy_auth_code.png

  1. סוגרים את חלון הדפדפן.
  2. מדביקים את קוד האימות שהעתקתם בשדה הטקסט שמוצג בהגדרות של Antigravity.
  3. לוחצים על שליחה.

mcp_servers_authenticated.png

5. כלי בדיקה

עכשיו אתם יכולים לקיים אינטראקציה עם הנתונים שלכם ב-Google Workspace באמצעות שפה טבעית. הנה כמה דוגמאות להנחיות לכל שירות.

יומן Google

אפשר לנסות לחפש בלוח הזמנים:

  • "What are my upcoming meetings this week?‎" (מה הפגישות הקרובות שלי השבוע?)
  • "יש לי זמן פנוי מחר בצהריים?"

test_prompt.png

Google Chat

אפשר לנסות לחפש הודעות:

  • "חפש הודעות שמכילות את המילה [KEYWORD] במרחב [SPACE_NAME]"

Google Drive

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

  • "חפש קבצים ב-Google Drive שלי שמכילים את המילה [KEYWORD]".
  • "List the most recent documents I edited" (תציג את המסמכים האחרונים שערכתי).
  • "תקרא את התוכן של מסמך [שם הקובץ] שלי ותסכם את המטרות העיקריות".

Gmail

אפשר לנסות לחפש או לנהל את האימיילים:

  • "תסכם את 5 האימיילים האחרונים שקיבלתי".
  • "תנסח אימייל אל [EMAIL_ADDRESS] עם בקשה לקבל עדכון על הפרויקט [PROJECT_NAME]".

People API

אפשר לנסות לחפש בפרופיל או באנשי הקשר:

  • "According to my Google profile, what is my name?"
  • "תמצא לי את הפרטים ליצירת קשר של [שם]".

שילוב של כמה שירותים

היתרון האמיתי של MCP מתגלה כשמתזמנים משימות בכמה שירותים. הנה כמה הנחיות לדוגמה שמדגימות את היכולות של שילוב בין שירותים:

  • "תחפש קבצים ב-Drive שקשורים ל'עדכונים על אבן הדרך [PROJECT_NAME]', תסכם את התוכן שלהם, תמצא את כתובת האימייל של [NAME] ותיצור טיוטה של אימייל ב-Gmail עם הסיכום".

כלים נוספים

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

6. הסרת המשאבים

כדי לנקות את הפרויקט בלי למחוק אותו, אפשר להשבית את ממשקי ה-API ואת שירותי ה-MCP שהפעלתם:

  1. במסוף Google Cloud, נכנסים אל מרכז הבקרה של השירותים וממשקי ה-API.
  2. לוחצים על כל אחד מממשקי ה-API של Google Workspace ו-MCP שהפעלתם (לדוגמה, Calendar MCP, ‏ Chat MCP) ואז על Disable API (השבתת ה-API).

אם אתם לא מתכוונים להשתמש יותר בפרטי הכניסה של לקוח OAuth, אתם יכולים למחוק אותם במסוף פלטפורמת האימות של Google.

7. מזל טוב

מעולה! הצלחת להגדיר ולבדוק את שרתי ה-MCP הרשמיים של Google Workspace באמצעות Antigravity.

מסמכי עזר