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

1. מבוא

ב-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: הגישה לשרתי MCP של Google Workspace היא חלק מתוכנית התצוגה המקדימה למפתחים שפתוחה לכולם. אם עדיין לא עשיתם זאת, עליכם להירשם ולוודא שהחשבון שלכם התקבל לתוכנית בכתובת https://developers.google.com/workspace/preview.

יצירה או בחירה של פרויקט ב-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 נפרד שצריך להפעיל.

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

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

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

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

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

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

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

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

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

הגדרת מסך ההסכמה ל-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

1. עוברים אל פלטפורמת האימות של Google > לקוחות > יצירת לקוח.
2. בוחרים באפשרות אפליקציה למחשב כסוג האפליקציה.
3. נותנים לו את השם Gemini CLI.
4. לוחצים על Create ומעתיקים את Client ID ואת Client Secret. תצטרכו אותם בשלב הבא.

4. הגדרת Gemini CLI

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

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

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

פותחים או יוצרים קובץ ~/.gemini/settings.json בתיקיית הבית ומוסיפים את ההגדרות הבאות. מחליפים את ה-placeholders בפרטי הכניסה שלכם ב-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 באמצעות שפה טבעית. הנה כמה דוגמאות להנחיות לכל שירות.

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

יומן Google

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

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

Google Chat

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

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

Google Drive

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

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

Gmail

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

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

People API

אפשר לשאול את Gemini על הפרופיל או על אנשי הקשר:

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

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

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

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

כלים נוספים

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

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

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

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

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

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