איך מתחילים לעבוד עם Google Workspace MCP ו-Gemini CLI

1. מבוא

הערה: אתם עדיין משתמשים ב-Gemini CLI? בשיעור ה-Codelab הזה מוסבר איך להגדיר שרתי Google Workspace MCP באמצעות Antigravity CLI. מידע נוסף על המעבר זמין בפוסט הרשמי הזה בבלוג.

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

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

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

הדרישות

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

ה-Codelab הזה יימשך כ-30 דקות.

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

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

תוכנית Google Workspace Developer Preview: הגישה לשרתי MCP של Google Workspace היא חלק מתוכנית Public Developer Preview. אם עדיין לא עשיתם זאת, הירשמו וודאו שהחשבון שלכם התקבל לתוכנית בכתובת https://developers.google.com/workspace/preview.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. במסוף Google Cloud, נכנסים לדף Google Auth Platform ‏> Branding. אם לא הגדרתם את האפשרות הזו, לוחצים על Get Started.
2. מגדירים את פרטי האפליקציה:
   • שם האפליקציה: Google Workspace MCP Servers
   • כתובת אימייל לתמיכה במשתמשים: בוחרים את כתובת האימייל שלכם.
3. מגדירים את Audience: בוחרים באפשרות Internal (או באפשרות External אם האפשרות Internal לא זמינה).
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

כשמגדירים לקוח OAuth 2.0 לשרתי MCP של Google Workspace, צריך להפעיל את הגדרת הסיווג כסוכני (is_agentic) על ידי בחירה באפשרות שימוש בלקוח הזה לסוכן מבוסס-AI. לקוחות OAuth שלא הפעילו את ההגדרה הזו לא יכולים לשלוח קריאות לנקודות קצה של MCP ב-Google Workspace.

1. עוברים אל פלטפורמת האימות של Google > לקוחות > יצירת לקוח (או ממשקי API ושירותים > פרטי כניסה > יצירת פרטי כניסה > מזהה לקוח OAuth).
2. בוחרים באפשרות אפליקציה למחשב כסוג האפליקציה.
3. נותנים לו את השם Gemini CLI.
4. בוחרים באפשרות שימוש בלקוח הזה לסוכן מבוסס-AI כדי להפעיל את דגל הסיווג is_agentic בלקוח OAuth.
5. לוחצים על Create ומעתיקים את Client ID ואת Client Secret. תצטרכו אותם בשלב הבא.

4. הגדרת Gemini CLI

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

נדרשת סביבה מקומית: אל תשתמשו ב-Cloud Shell בשלב הזה. ‫Gemini CLI דורש דפדפן מקומי לאימות OAuth. צריך להשתמש בטרמינל של המחשב המקומי. מידע נוסף זמין במאמר דרישות לגבי הפניה אוטומטית בדפדפן.

יצירת קובץ התצורה

פותחים או יוצרים את ~/.gemini/settings.json בתיקיית הבית ומוסיפים את ההגדרות הבאות. מחליפים את הפלייסהולדרים בפרטי הכניסה שלכם ב-OAuth.

{
  "mcpServers": {
    "calendar": {
      "httpUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/calendar.calendarlist.readonly",
          "https://www.googleapis.com/auth/calendar.events.freebusy",
          "https://www.googleapis.com/auth/calendar.events.readonly"
        ]
      }
    },
    "chat": {
      "httpUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "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"
        ]
      }
    },
    "drive": {
      "httpUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/drive.readonly",
          "https://www.googleapis.com/auth/drive.file"
        ]
      }
    },
    "gmail": {
      "httpUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/gmail.readonly",
          "https://www.googleapis.com/auth/gmail.compose"
        ]
      }
    },
    "people": {
      "httpUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/directory.readonly",
          "https://www.googleapis.com/auth/userinfo.profile",
          "https://www.googleapis.com/auth/contacts.readonly"
        ]
      }
    }
  }
}

5. אימות שרתי MCP

כדי להשתמש בשרתי MCP, צריך לאמת אותם ולוודא שהם מחוברים.

הפעלת Gemini CLI

כדי להפעיל את Gemini CLI, מריצים את הפקודה הבאה בטרמינל:

gemini

אמת

מבצעים אימות מול השירותים שרוצים לבדוק על ידי הפעלת הפקודה המתאימה ב-Gemini CLI. אתם צריכים לאמת רק את השירותים שבהם אתם מתכננים להשתמש ב-Codelab הזה.

יומן

/mcp auth calendar

צ'אט

/mcp auth chat

Drive

/mcp auth drive

Gmail

/mcp auth gmail

אנשים

/mcp auth people

פועלים לפי ההנחיות בדפדפן כדי לאשר כל שירות.

אימות החיבור

מוודאים שהכלים נטענו ומוכנים:

/mcp list

אמור להופיע פלט שמציין שהשירותים הם Ready, עם רשימה של הכלים שלהם.

6. בדיקת שרתי MCP

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

הערה: החליפו את הפלייסהולדרים בסוגריים מרובעים בהנחיות שבהמשך (למשל, [NAME], [FILE_NAME]) בערכים אמיתיים מהנתונים שלכם ב-Google Workspace.

יומן Google

אפשר לשאול את Gemini על לוח הזמנים:

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

Google Chat

אפשר לבקש מ-Gemini לחפש הודעות:

• "Look for messages containing ‘[KEYWORD]' in ‘[SPACE_NAME]'"

Google Drive

אפשר לבקש מ-Gemini למצוא או לקרוא קבצים:

• "חפש קבצים ב-Google Drive שלי שמכילים את [מילת מפתח]".
• "הצג את המסמכים האחרונים שערכתי"
• "תקרא את התוכן של המסמך [FILE_NAME] ותסכם את היעדים העיקריים".

Gmail

אפשר לבקש מ-Gemini לחפש או לנהל את האימיילים:

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

People API

אתם יכולים לבקש מ-Gemini מידע על הפרופיל או על אנשי הקשר שלכם:

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

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

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

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

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

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

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

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

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

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

8. מזל טוב

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

מה למדתם

• איך מפעילים את שירותי Google Workspace MCP ב-Google Cloud.
• איך מגדירים לקוח OAuth ל-MCP.
• איך משתמשים ב-Gemini CLI כדי לבצע פעולות בנתונים של Google Workspace באמצעות כלים רגילים.

מסמכי עזר

• מבוא ל-Model Context Protocol‏ (MCP)
• הגדרת שרתי MCP של Google Workspace
• הגדרת מסך ההסכמה של OAuth