הגדרת שרתי MCP של Google Workspace

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

שרתי ה-MCP של Google Workspace מספקים דרך סטנדרטית לסוכני AI:

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

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

הגדרת שרתי ה-MCP של Google Workspace

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

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

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

  • ממשק ה-API של Gmail
  • Google Drive API
  • Google Docs API
  • Google Sheets API
  • Google Slides API
  • Google Calendar API
  • Google Chat API
  • People API

CLI

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
docs.googleapis.com \
sheets.googleapis.com \
slides.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
people.googleapis.com --project=PROJECT_ID

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

המסוף

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

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

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

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

  • Gmail MCP API
  • Google Drive MCP API
  • Google Docs MCP API
  • Google Sheets MCP API
  • Google Slides MCP API
  • Google Calendar MCP API
  • Google Chat MCP API
  • People MCP API

CLI

gcloud services enable gmailmcp.googleapis.com \
drivemcp.googleapis.com \
docsmcp.googleapis.com \
sheetsmcp.googleapis.com \
slidesmcp.googleapis.com \
calendarmcp.googleapis.com \
chatmcp.googleapis.com \
people.googleapis.com --project=PROJECT_ID

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

המסוף

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

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

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

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

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

    מעבר אל Google Chat API

  2. מגדירים את אפליקציית Chat:

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

מידע נוסף על פיתוח אפליקציה ל-Chat זמין במאמר בנושא בחירת ארכיטקטורה של אפליקציה ל-Google Chat.

שרתי ה-MCP של Google Workspace משתמשים ב-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 (שם האפליקציה), מקלידים Workspace MCP Servers.
    2. בקטע User support email, בוחרים את כתובת האימייל או קבוצת Google המתאימה.
    3. לוחצים על הבא.
    4. בקטע Audience, לוחצים על Internal. אם אי אפשר לבחור באפשרות פנימי, בוחרים באפשרות חיצוני.
    5. לוחצים על הבא.
    6. בקטע Contact Information, מזינים כתובת אימייל שאליה אפשר לשלוח התראות על שינויים בפרויקט.
    7. לוחצים על Next.
    8. בקטע Finish, קוראים את המדיניות של Google בנושא נתוני משתמשים בשירותי API. אם אתם מסכימים, סמנו את התיבה I agree to the Google API Services: User Data Policy.
    9. לוחצים על Continue.
    10. לוחצים על יצירה.
    11. אם בחרתם באפשרות חיצוני לסוג המשתמש, מוסיפים משתמשי בדיקה:
      1. לוחצים על קהל.
      2. בקטע משתמשי בדיקה, לוחצים על הוספת משתמשים.
      3. מזינים את כתובת האימייל שלכם ושל משתמשים מורשים אחרים לבדיקה, ואז לוחצים על שמירה.
  3. לוחצים על גישה לנתונים > הוספה או הסרה של היקפי גישה. יופיע חלונית עם רשימה של היקפי הגישה לכל API שהפעלתם בפרויקט שלכם ב-Google Cloud.

    1. בקטע הוספת היקפי הרשאות באופן ידני, מדביקים את היקפי ההרשאות של שרתי ה-MCP שבהם רוצים להשתמש:

      • 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
    2. לוחצים על הוספה לטבלה.

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

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

הגדרת לקוח MCP

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

Antigravity

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

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

    1. במסוף Google Cloud, עוברים אל Google Auth Platform>Clients>Create Client.

      מעבר אל Create Client

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

    3. הזן שם.

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

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

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

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

    {
      "mcpServers": {
        "gmail": {
          "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
          "oauth": {
            "clientId": "OAUTH_CLIENT_ID",
            "clientSecret": "OAUTH_CLIENT_SECRET"
          }
        },
        "drive": {
          "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
          "oauth": {
            "clientId": "OAUTH_CLIENT_ID",
            "clientSecret": "OAUTH_CLIENT_SECRET"
          }
        },
        "docs": {
          "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
          "oauth": {
            "clientId": "OAUTH_CLIENT_ID",
            "clientSecret": "OAUTH_CLIENT_SECRET"
          }
        },
        "sheets": {
          "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
          "oauth": {
            "clientId": "OAUTH_CLIENT_ID",
            "clientSecret": "OAUTH_CLIENT_SECRET"
          }
        },
        "slides": {
          "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1",
          "oauth": {
            "clientId": "OAUTH_CLIENT_ID",
            "clientSecret": "OAUTH_CLIENT_SECRET"
          }
        },
        "calendar": {
          "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
          "oauth": {
            "clientId": "OAUTH_CLIENT_ID",
            "clientSecret": "OAUTH_CLIENT_SECRET"
          }
        },
        "chat": {
          "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
          "oauth": {
            "clientId": "OAUTH_CLIENT_ID",
            "clientSecret": "OAUTH_CLIENT_SECRET"
          }
        },
        "people": {
          "serverUrl": "https://people.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. אפשר לבצע אימות באמצעות הגדרות ממשק המשתמש הגרפי או ה-CLI:

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

      1. פותחים את מסך ההגדרות (למשל, לוחצים על הגדרות בפינה הימנית התחתונה או פותחים את הגדרות המשתמש של Antigravity).
      2. עוברים אל התאמות אישיות.
      3. בקטע Installed MCP Servers (שרתי MCP מותקנים), לוחצים על Refresh (רענון).
      4. לכל שרת שמופיע ברשימה (gmail, drive, docs, sheets, slides, calendar, chat ו-people), לוחצים על אימות, נכנסים לחשבון Google, מעתיקים את קוד ההרשאה, מדביקים אותו בתיבת הקלט ולוחצים על שליחה.
    • ב-Antigravity CLI:

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

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

        /mcp
        
      3. מאמתים כל שרת MCP:

        1. משתמשים במקשי החיצים כדי לבחור את השרת, עוברים לפעולה Authenticate ומקישים על Enter. משלימים את תהליך הכניסה בדפדפן, מעתיקים את קוד ההרשאה, מדביקים אותו בהנחיה במסוף ולוחצים על Enter.
        2. חוזרים על השלבים האלה לכל שרת שהגדרתם (gmail, drive, docs, sheets, slides, calendar, chat, ו-people).
  6. מוודאים שהשרתים מוגדרים ופועלים בצורה נכונה:

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

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

Claude

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

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

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

    1. במסוף Google Cloud, עוברים אל Google Auth Platform>Clients>Create Client.

      מעבר אל Create Client

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

    3. הזן שם.

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

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

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

    1. ב-Claude.ai או ב-Claude Desktop, עוברים אל Settings (הגדרות) או אל Admin settings (הגדרות אדמין) > Connectors (מחברים).
    2. לוחצים על הוספת מחבר בהתאמה אישית.
    3. מזינים את פרטי החיבור למוצר Google Workspace שרוצים להוסיף:
      • שם השרת: שם לשרת, כמו Gmail.
      • כתובת ה-URL של שרת ה-MCP המרוחק: כתובת ה-URL של מוצר Google Workspace, כמו אחת מהכתובות הבאות:
        • ‫Gmail: https://gmailmcp.googleapis.com/mcp/v1
        • ‫Google Drive: https://drivemcp.googleapis.com/mcp/v1
        • Google Docs: https://docsmcp.googleapis.com/mcp/v1
        • ‫Google Sheets: https://sheetsmcp.googleapis.com/mcp/v1
        • ‫Google Slides: https://slidesmcp.googleapis.com/mcp/v1
        • יומן Google‏: https://calendarmcp.googleapis.com/mcp/v1
        • ‫Google Chat: https://chatmcp.googleapis.com/mcp/v1
        • People API: https://people.googleapis.com/mcp/v1
    4. בהגדרות מתקדמות, מזינים את מזהה הלקוח ב-OAuth ואת סוד הלקוח ב-OAuth.
    5. לוחצים על הוספה.
    6. חוזרים על השלבים האלה לכל מוצר של Google Workspace שרוצים להוסיף.

אחרים

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

  • שם השרת: googleworkspace

  • שרתים: לכל מוצר של Google Workspace יש כתובת URL משלו לשרת:

    • ‫Gmail: https://gmailmcp.googleapis.com/mcp/v1
    • ‫Google Drive: https://drivemcp.googleapis.com/mcp/v1
    • Google Docs: https://docsmcp.googleapis.com/mcp/v1
    • ‫Google Sheets: https://sheetsmcp.googleapis.com/mcp/v1
    • ‫Google Slides: https://slidesmcp.googleapis.com/mcp/v1
    • יומן Google‏: https://calendarmcp.googleapis.com/mcp/v1
    • ‫Google Chat: https://chatmcp.googleapis.com/mcp/v1
    • People API: https://people.googleapis.com/mcp/v1
  • Transport: HTTP

  • אימות: שרת ה-MCP המרוחק של Google Workspace משתמש ב-OAuth 2.0. פרטים נוספים זמינים במאמר מידע על אימות והרשאה.

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

בדיקת שרתי MCP של Google Workspace

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

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

  • "What did Ariel say in her last email about our marketing plan?"

    הלקוח מסנן את האימיילים מאת אריאל באמצעות gmail.search_threads, מאחזר את התוכן של השרשור האחרון באמצעות gmail.get_thread, ואז מסכם אותו בשבילכם.

  • "תנסח אימייל אל ariel@example.com ותציין בו שאני מאשר את תוכנית השיווק".

    הלקוח משתמש ב-gmail.create_draft כדי ליצור אימייל בתיקיית הטיוטות, וכך מאפשר לכם לבדוק אותו ולשלוח אותו מ-Gmail.

  • "תסכם את הקובץ 'תוכנית שיווקית'".

    הלקוח קורא ל-drive.search_files כדי לאתר את 'תוכנית השיווק', ואז משתמש ב-drive.read_file_content כדי לאחזר את התוכן שלה ולסכם אותו.

  • "תראה לי את תוכן המבנה של סיכום הפגישה במסמך Google Docs".

    הלקוח מאחזר את המבנה והתוכן של המסמך באמצעות docs.read_doc.

  • "תקרא את גיליון Sheet1 מגיליון Google Sheets 'מכירות רבעוניות'".

    הלקוח מאחזר ערכי רשת באמצעות sheets.get_values.

  • "תציג לי את הפריסה המילולית של מצגת Google Slides 'סקירת מוצר'".

    הלקוח מאחזר מבנים של פריסות חזותיות של מצגות באמצעות slides.read_presentation.

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

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

  • "מה השם שלי לפי הפרופיל שלי ב-Google?"

    הלקוח משתמש ב-people.get_user_profile כדי לאחזר את פרטי הפרופיל שלכם ב-Google Workspace.

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

פתרון בעיות

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

מוצרים נתמכים

המוצרים הבאים של Google Workspace תומכים בשרתים של Google Workspace MCP ומציעים את הכלים הבאים:

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

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

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

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