שרתי Google Workspace MCP ב-Google Antigravity 2.0, ב-IDE או ב-CLI

1. מבוא

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

google_workspace_mcp_antigravity_arch_2.png

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

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

הדרישות

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

qr_code.png

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

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

במסוף Google Cloud, בוחרים או יוצרים פרויקט בענן של Google.

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

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

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

בשלב הבא, מפעילים את שירותי ה-MCP של Google Workspace.

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

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

  1. במסוף Google Cloud, מחפשים את Google Chat API ולוחצים על Google Chat API ‏> Manage (ניהול) > Configuration (הגדרה).

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

chat_app.png

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

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

קודם צריך להגדיר את מסך ההסכמה.

  1. במסוף Google Cloud, נכנסים לדף Google Auth Platform ‏> Branding. אם לא הגדרתם את האפשרות הזו, לוחצים על Get Started.
  2. מגדירים את פרטי האפליקציה:
    • שם האפליקציה: Google Workspace MCP Servers
    • כתובת אימייל לתמיכה במשתמשים: בוחרים את כתובת האימייל שלכם.
  3. מגדירים את Audience: בוחרים באפשרות Internal (או באפשרות External אם האפשרות Internal לא זמינה).
  4. מגדירים את הפרטים ליצירת קשר: מזינים את כתובת האימייל.
  5. קוראים ומאשרים את המדיניות בנושא נתוני משתמשים, ואז לוחצים על יצירה.
  6. אם בחרתם באפשרות חיצוני, עוברים אל קהל ומוסיפים את כתובת האימייל שלכם בקטע משתמשי בדיקה.
  7. עוברים אל גישה לנתונים > הוספה או הסרה של היקפים. בקטע הוספה ידנית של היקפים, מוסיפים את הפרטים הבאים לשרתים שבהם רוצים להשתמש:
    • ‫Universal:‏ 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
    • Gmail:‏ https://www.googleapis.com/auth/gmail.readonly,‏ https://www.googleapis.com/auth/gmail.compose
    • ‫Google Drive:‏ https://www.googleapis.com/auth/drive.readonly,‏ https://www.googleapis.com/auth/drive.file
    • ‫Google Docs:‏ https://www.googleapis.com/auth/drive.readonly,‏ https://www.googleapis.com/auth/drive.file,‏ https://www.googleapis.com/auth/documents.readonly,‏ https://www.googleapis.com/auth/documents
    • ‫Google Sheets:‏ https://www.googleapis.com/auth/drive.readonly,‏ https://www.googleapis.com/auth/drive.file,‏ https://www.googleapis.com/auth/spreadsheets.readonly,‏ https://www.googleapis.com/auth/spreadsheets
    • ‫Google Slides:‏ https://www.googleapis.com/auth/drive.readonly,‏ https://www.googleapis.com/auth/drive.file,‏ https://www.googleapis.com/auth/presentations.readonly,‏ https://www.googleapis.com/auth/presentations
    • יומן 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.messages.create,‏ https://www.googleapis.com/auth/chat.users.readstate.readonly
    • 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_1.pngoauth_consent_screen_2.pngoauth_consent_screen_3.png

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

  1. עוברים אל פלטפורמת האימות של Google > לקוחות > יצירת לקוח.
  2. בוחרים באפשרות אפליקציית אינטרנט בתור סוג האפליקציה.
  3. נותנים לו את השם Antigravity.
  4. בקטע Authorized redirect URIs, לוחצים על ‎+ Add URI ומזינים את https://antigravity.google/oauth-callback.
  5. בוחרים באפשרות שימוש בלקוח הזה לסוכן מבוסס-AI.
  6. לוחצים על Create ומעתיקים את מזהה לקוח ואת סוד לקוח. תצטרכו אותם בשלב הבא.

oauth_client.png

4. הגדרת Antigravity

עכשיו נגדיר את Antigravity כך שישתמש בנקודות הקצה האלה. אם לא התקנתם את Antigravity 2.0,‏ IDE ו/או CLI, פעלו לפי ההוראות באתר Antigravity.

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

‫Antigravity 2.0,‏ IDE ו-CLI משתפים הגדרת MCP מרכזית בקובץ ~/.gemini/config/mcp_config.json.

  1. פותחים אותו בכלי המועדף לעריכת טקסט.
  2. משנים את ההגדרה הבאה של שרת ה-MCP בהתאמה אישית. לפני כן, מחליפים את ה-placeholders‏ <YOUR_CLIENT_ID> ו-<YOUR_CLIENT_SECRET> במזהה הלקוח ובסוד הלקוח של OAuth שיצרתם בשלבים הקודמים.
  3. שמרו אותו.
{
  "mcpServers": {
    "gws-universal": {
      "serverUrl": "https://workspacemcp.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-drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-sheets": {
      "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-slides": {
      "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "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-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
    ...
  }
  ...
}

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

כל שרתי ה-MCP שהגדרתם אמורים להופיע כמותקנים ב-Antigravity: ‏gws-universal, ‏gws-gmail, ‏gws-drive, ‏gws-docs, ‏gws-sheets, ‏gws-slides, ‏gws-calendar, ‏gws-chat ו-gws-people. צריך לאמת כל אחד מהם בכל פלטפורמה של Antigravity, כי אסימוני OAuth לא מרוכזים במקום אחד.

Antigravity 2.0

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

unauthed_mcp_servers_20.png

  1. לכל שרת MCP שמופיע ברשימה:
    1. לוחצים על אימות.
    gui_auth.png
    1. מבצעים את תהליך האימות בחלון הדפדפן החדש שנפתח.
    2. בסיום, לוחצים על העתקה ללוח.
    copy_auth_code.png
    1. מדביקים את קוד האימות שהעתקתם בשדה הטקסט שמוצג בהגדרות של Antigravity 2.0 ולוחצים על שליחה.
    gui_paste_auth_code.png
    1. הכפתור יציאה מוצג עכשיו במקום הכפתור אימות.
    gui_sign_out.png

Antigravity IDE

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

open_user_settings_ide.png

  1. עוברים אל התאמות אישיות.
  2. בקטע שרתי MCP מותקנים, לוחצים על רענון.

unauthed_mcp_servers_ide.png

  1. לכל שרת MCP שמופיע ברשימה:
    1. לוחצים על אימות.
    gui_auth.png
    1. מבצעים את תהליך האימות בחלון הדפדפן החדש שנפתח.
    2. בסיום, לוחצים על העתקה ללוח.
    copy_auth_code.png
    1. מדביקים את קוד האימות שהעתקתם בשדה הטקסט שמוצג בהגדרות של Antigravity IDE ולוחצים על שליחה.
    gui_paste_auth_code.png
    1. הכפתור יציאה מוצג עכשיו במקום הכפתור אימות.
    gui_sign_out.png

Antigravity CLI

  1. מקלידים /mcp ולוחצים על Enter.

unauthed_mcp_servers_cli.png

  1. לכל שרת MCP שמופיע ברשימה:
    1. בוחרים אותה באמצעות מקשי החיצים למעלה ולמטה ולוחצים על Enter.
    2. בוחרים באפשרות אימות באמצעות מקשי החיצים שמאלה וימינה ולוחצים על Enter.
    cli_auth.png
    1. פותחים את כתובת ה-URL שמוצגת בחלון דפדפן חדש ועוברים את תהליך האימות.
    cli_auth_url.png
    1. בסיום, לוחצים על העתקה ללוח.
    copy_auth_code.png
    1. מדביקים את קוד האימות שהעתקתם בשדה הטקסט שמוצג בטרמינל שבו פועל Antigravity CLI, ולוחצים על Enter.
    cli_paste_auth_code.png
    1. הסטטוס נדרש אימות יוחלף בסטטוס מאומת.
    cli_sign_out.png

5. כלי בדיקה

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

מידה אוניברסלית

נסו לחפש במוצרים שונים:

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

ide_uni_test.png

Gmail

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

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

Google Drive

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

  • "Search for files on my Google Drive that contain ‘[KEYWORD]'."
  • "הצג את המסמכים האחרונים שערכתי"
  • "תקרא את התוכן של המסמך [FILE_NAME] ותסכם את היעדים העיקריים".

Google Docs‏, ‏ Sheets‏, ‏ Slides

נסו לחפש במקורות ב-Drive:

  • "תראה לי את התוכן המבני של מסמך Google Docs‏ [DOCS_TITLE]."
  • "Read sheet Sheet1 from Google Sheet [SHEETS_TITLE]"
  • "תציג לי את הפריסה המילולית של המצגת [SLIDES_TITLE] ב-Google Slides".

יומן Google

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

  • "אילו פגישות יש לי השבוע?"
  • "יש לי זמן פנוי מחר אחר הצהריים?"

Google Chat

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

  • "חפש הודעות עם [מילת מפתח] במרחב [שם המרחב]"

People API

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

  • "מה השם שלי לפי הפרופיל ב-Google?"
  • "Find contact info for ‘[NAME]'‎"

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

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

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

עולם תוכן מורחב

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

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

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

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

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

7. מזל טוב

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

מסמכי עזר