הגדרת שרת ה-MCP של היומן

ביומן Google יש שרת Model Context Protocol‏ (MCP) מרוחק שמאפשר לסוכני AI לקיים אינטראקציה מאובטחת עם הנתונים ביומן Google. כשמגדירים את שרת ה-MCP של יומן Google, מאפשרים לאפליקציות AI כמו Google Antigravity ו-Claude לבצע פעולות ביומן Google.

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

  • קריאת נתונים: הצגת רשימת יומנים, אחזור אירועים ובדיקת זמינות.
  • יוצרים קמפיינים: ליצור, לעדכן ולמחוק אירועים.
  • שמירה על האבטחה: יורש את אותן הרשאות ואמצעי בקרה על משילות מידע (data governance) כמו המשתמש.

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

הגדרת שרת ה-MCP של יומן Google

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

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

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

  • Google Calendar API

CLI

gcloud services enable calendar-json.googleapis.com --project=PROJECT_ID

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

המסוף

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

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

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

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

  • Google Calendar MCP API

CLI

gcloud services enable calendarmcp.googleapis.com --project=PROJECT_ID

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

המסוף

מפעילים את שירותי MCP במסוף Google Cloud:

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

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

  1. במסוף Google Cloud, נכנסים לדף Google Auth Platform‏ > Branding.

    מעבר לדף Branding

  2. אם כבר הגדרתם את פלטפורמת האימות של Google, אתם יכולים לקבוע את ההגדרות הבאות של מסך ההסכמה ל-OAuth בקטעים Branding,‏ Audience ו-Data Access. אם מופיעה ההודעה Google Auth Platform not configured yet, לוחצים על Get Started:

    1. בקטע App Information, בשדה App name, מקלידים Calendar MCP Server.
    2. בקטע User support email, בוחרים את כתובת האימייל שלכם או קבוצה מתאימה ב-Google.
    3. לוחצים על הבא.
    4. בקטע Audience, לוחצים על Internal. אם אי אפשר לבחור באפשרות פנימי, בוחרים באפשרות חיצוני.
    5. לוחצים על הבא.
    6. בקטע Contact Information, מזינים כתובת אימייל שאליה אפשר לשלוח התראות על שינויים בפרויקט.
    7. לוחצים על הבא.
    8. בקטע Finish, קוראים את המדיניות של Google בנושא נתוני משתמשים בשירותי API. אם אתם מסכימים, סמנו את התיבה I agree to the Google API Services: User Data Policy.
    9. לוחצים על המשך.
    10. לוחצים על יצירה.
    11. אם בחרתם באפשרות חיצוני בתור סוג המשתמש, הוסיפו משתמשי בדיקה:
      1. לוחצים על קהל.
      2. בקטע משתמשי בדיקה, לוחצים על הוספת משתמשים.
      3. מזינים את כתובת האימייל שלכם ושל משתמשי בדיקה מורשים אחרים, ולוחצים על Save.

  3. לוחצים על Data Access (גישה לנתונים) > Add or Remove Scopes (הוספה או הסרה של היקפים). יופיע חלונית עם רשימה של היקפי הרשאות לכל API שהפעלתם בפרויקט בענן ב-Google Cloud.

    1. בקטע הוספה ידנית של היקפי הרשאות, מדביקים את היקפי ההרשאות של שרת ה-MCP של יומן 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

    2. לוחצים על הוספה לטבלה.

    3. לוחצים על עדכון.

    4. אחרי שבוחרים את היקפי ההרשאות שהאפליקציה צריכה, לוחצים על Save בדף Data Access.

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

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

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

Antigravity

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

  1. יוצרים מזהה לקוח וסוד ב-OAuth 2.0:

    1. במסוף Google Cloud, נכנסים לדף Google Auth Platform‏ > Clients‏ > Create Client.

      מעבר אל "יצירת לקוח"

    2. בוחרים באפשרות אפליקציית אינטרנט בתור סוג האפליקציה.

    3. הזן שם.

    4. בקטע Authorized redirect URIs, לוחצים על ‎+ Add URI ומוסיפים את https://antigravity.google/oauth-callback בשדה URIs.

    5. בוחרים באפשרות שימוש בלקוח הזה לסוכן מבוסס-AI.

    6. לוחצים על Create ומעתיקים את מזהה לקוח ואת סוד לקוח.

  2. פותחים או יוצרים את קובץ התצורה ~/.gemini/config/mcp_config.json.

  3. מוסיפים את ההגדרה mcpServers אל mcp_config.json:

    {
  "mcpServers": {
    "calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫OAUTH_CLIENT_ID: מזהה הלקוח שיצרתם.
    • ‫OAUTH_CLIENT_SECRET: סוד הלקוח שיצרתם.

  4. חיסכון של mcp_config.json.

  5. מאמתים את שרת ה-MCP. אתם יכולים לבצע אימות באמצעות הגדרות ה-GUI או ה-CLI:

    • ב-Antigravity IDE או GUI (Antigravity 2.0):

      1. פותחים את מסך ההגדרות (למשל, לוחצים על הגדרות בפינה הימנית התחתונה או פותחים את הגדרות המשתמש של Antigravity).
      2. עוברים אל התאמות אישיות.
      3. בקטע שרתי MCP מותקנים, לוחצים על רענון.
      4. מוצאים את calendar ברשימה, לוחצים על Authenticate, נכנסים לחשבון Google, מעתיקים את קוד ההרשאה, מדביקים אותו בתיבת הדו-שיח של הקלט ולוחצים על Submit.

    • ב-Antigravity CLI:

      1. מפעילים את Antigravity CLI:

        agy

      2. כדי לפתוח את חלונית הניהול האינטראקטיבית של MCP, מריצים את הפקודה:

        /mcp

      3. משתמשים במקשי החיצים כדי לבחור את calendar, עוברים לפעולה אימות ולוחצים על Enter. משלימים את תהליך הכניסה בדפדפן, מעתיקים את קוד ההרשאה, מדביקים אותו בהנחיה בטרמינל ולוחצים על Enter.

  6. מוודאים שהשרת מוגדר בצורה נכונה ופועל:

    • ב-Antigravity IDE או ב-GUI: הלחצן יציאה מופיע לצד השרת בקטע התאמות אישיות > שרתי MCP מותקנים.
    • ב-Antigravity CLI: פותחים את החלונית /mcp כדי לראות את שרתי ה-MCP שהוגדרו. שרתים מאומתים מוצגים עם הכיתוב Authed לצד השמות שלהם בחלונית ה-TUI האינטראקטיבית. אתם יכולים לבחור את השרת בתצוגת מרכז הבקרה כדי לבדוק את הסטטוס שלו ולראות רשימה של כל הכלים הזמינים בו.

שרת ה-MCP המרוחק מוכן לשימוש ב-Antigravity.

Claude

כדי להשתמש בשרת ה-MCP המרוחק של יומן Google עם Claude.ai או Claude Desktop, אתם צריכים מינוי ל-Claude Enterprise, ‏Pro, ‏Max או Team.

כדי להוסיף ל-Claude את שרת ה-MCP המרוחק של יומן Google, צריך להגדיר מחבר בהתאמה אישית עם מזהה לקוח וסוד לקוח ב-OAuth.

  1. יוצרים מזהה לקוח וסוד ב-OAuth 2.0:

    1. במסוף Google Cloud, נכנסים לדף Google Auth Platform‏ > Clients‏ > Create Client.

      מעבר אל "יצירת לקוח"

    2. בוחרים באפשרות אפליקציית אינטרנט בתור סוג האפליקציה.

    3. הזן שם.

    4. בקטע Authorized redirect URIs, לוחצים על ‎+ Add URI ומוסיפים את https://claude.ai/api/mcp/auth_callback בשדה URIs.

    5. בוחרים באפשרות שימוש בלקוח הזה לסוכן מבוסס-AI.

    6. לוחצים על Create ומעתיקים את מזהה לקוח ואת סוד לקוח.

  2. מגדירים את שרת ה-MCP ב-Claude:

    1. ב-Claude.ai או ב-Claude Desktop, עוברים אל הגדרות > מחברים או אל הגדרות אדמין > מחברים.
    2. לוחצים על הוספת מחבר בהתאמה אישית.
    3. מזינים את פרטי החיבור של המוצר "יומן Google":
      • שם השרת: Google Calendar.
      • כתובת ה-URL של שרת ה-MCP המרוחק: https://calendarmcp.googleapis.com/mcp/v1
    4. בהגדרות מתקדמות, מזינים את מזהה הלקוח ב-OAuth ואת סוד הלקוח ב-OAuth.
    5. לוחצים על הוספה.

אחרים

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

למידע נוסף על חיבור סוגים שונים של לקוחות, ראו הגדרת MCP באפליקציית AI.

בדיקת שרת ה-MCP של יומן Google

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

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

  • "מתי הפגישה הבאה שלי עם אריאל?"

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

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

פתרון בעיות

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

בדיקת אירועים ביומן של OAuth

אם נתקלתם בבעיות בחיבור לשרת ה-MCP, בדקו אם יש שגיאות ביומני OAuth. מבקשים מהאדמין ב-Google Workspace לבדוק את האירועים ביומן של OAuth בכלי לחקירת אבטחה.

בקשות שנדחו מלקוחות OAuth שהוקצו למשתמשים

אם הבקשות לשרת ה-MCP נדחות, צריך לוודא שבמזהה הלקוח של OAuth 2.0 שהוקצה למשתמש לתהליך ה-OAuth עם 3 רגליים, האפשרות שימוש בלקוח הזה לסוכן מבוסס-AI נבחרה בפלטפורמת האימות של Google > לקוחות:

  • הלקוח הקיים תומך בהגדרה: בוחרים באפשרות שימוש בלקוח הזה לסוכן מבוסס-AI בלקוח OAuth הקיים.
  • אי אפשר לעדכן לקוח קיים: יוצרים לקוח OAuth חדש, בוחרים באפשרות Use this client for an AI-powered agent ומעדכנים את האפליקציה כך שתשתמש בו.
  • הלקוח הקיים תומך גם בתכונות שלא קשורות לסוכנים: צרו לקוח OAuth נפרד לסוכן ה-AI והשאירו את הלקוח הקיים לתכונות שלא קשורות לסוכנים.

הוראות מפורטות זמינות במאמרים הגדרת לקוח MCP וניהול לקוחות OAuth.

חשבונות שירות עם הענקת גישה ברמת הדומיין

אם האפליקציה משתמשת בחשבון שירות עם הענקת גישה ברמת הדומיין ל-OAuth עם שני שלבים, אי אפשר לבחור באפשרות שימוש בלקוח הזה לסוכן מבוסס-AI כי חשבונות שירות לא מנוהלים בפלטפורמת האימות של Google > לקוחות:

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

בקשות מ-Apps Script

אם אתם שולחים קריאה לשרת MCP מ-Apps Script, אתם לא יכולים לבחור באפשרות שימוש בלקוח הזה לסוכן מבוסס-AI בלקוח ברירת המחדל של OAuth ש-Apps Script יוצר ומנהל בשביל הסקריפט שלכם. הכלל הזה חל גם אם הסקריפט משתמש בפרויקט סטנדרטי ב-Google Cloud.

כדי לשלוח קריאה לשרת ה-MCP מ-Apps Script:

  1. במסוף Google Cloud, נכנסים לדף Google Auth Platform ‏> Clients, יוצרים לקוח OAuth ובוחרים באפשרות Use this client for an agent מבוסס-AI.
  2. בסקריפט, משתמשים בספריית OAuth2 for Apps Script כדי לתת למשתמשים הרשאה באמצעות לקוח OAuth.
  3. כשאתם שולחים קריאה לשרת ה-MCP, שלחו את טוקן הגישה שהספרייה מחזירה במקום הטוקן מ-ScriptApp.getOAuthToken.

פרויקטים ב-Apps Script שלא שולחים קריאות לשרתי MCP של Google Workspace לא מושפעים.

הצעות חוזרות להיכנס לחשבון מדי שעה

אם אתם מתבקשים להיכנס שוב בערך כל שעה, סימן שלקוח ה-MCP לא מקבל טוקן רענון. שרת OAuth 2.0 של Google מנפיק טוקן רענון רק אם בקשת ההרשאה כוללת את access_type=offline. אם מבקשים רק את היקף ההרשאות offline_access של OpenID Connect‏ (OIDC), לא מקבלים טוקן רענון.

בודקים אם לקוח ה-MCP תומך בפרמטרים מותאמים אישית של הרשאה:

  • הלקוח תומך בפרמטרים מותאמים אישית של הרשאה: מוסיפים את access_type=offline לבקשת ההרשאה. כדי לקבל טוקן רענון חדש למשתמש שכבר נתן גישה, צריך להוסיף גם את prompt=consent.
  • הלקוח לא תומך בפרמטרים מותאמים אישית של הרשאה: צריך להיכנס שוב בכל פעם שתוקף טוקן הגישה פג.

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

הפניה לכלי

הכלים הבאים זמינים בשרת ה-MCP של יומן Google:

  • create_event
  • delete_event
  • get_event
  • list_calendars
  • list_events
  • respond_to_event
  • suggest_time
  • update_event

שיקול אבטחה חשוב: החדרת פרומפטים עקיפה

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

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

כדאי לפעול לפי השיטות המומלצות הבאות:

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