הגדרת שרתי 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 Classroom. לכל מוצר של Google Workspace יש שרת MCP ייעודי משלו.

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

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

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

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

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

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

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

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

  • Google Classroom 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 \
classroom.googleapis.com --project=PROJECT_ID

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

המסוף

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

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

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

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

  • 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

  • Google Classroom 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 \
classroommcp.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. בשדה שם האפליקציה, מזינים Chat MCP.
    2. בשדה Avatar URL, מזינים את הערך https://developers.google.com/chat/images/quickstart-app-avatar.png.
    3. בשדה Description, מזינים Chat MCP server.
    4. בקטע פונקציונליות, משביתים את התכונות האינטראקטיביות באמצעות המתג הפעלת תכונות אינטראקטיביות.
    5. בקטע Logs, בוחרים באפשרות Log errors to Logging.

  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
      • People API:
        • https://www.googleapis.com/auth/directory.readonly
        • https://www.googleapis.com/auth/userinfo.profile
        • https://www.googleapis.com/auth/contacts.readonly
      • Google Classroom:
        • https://www.googleapis.com/auth/classroom.announcements
        • https://www.googleapis.com/auth/classroom.courses.readonly
        • https://www.googleapis.com/auth/classroom.coursework.students
        • https://www.googleapis.com/auth/classroom.courseworkmaterials
        • https://www.googleapis.com/auth/classroom.rosters.readonly
        • https://www.googleapis.com/auth/classroom.student-submissions.students.readonly
        • https://www.googleapis.com/auth/classroom.topics.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.

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

    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": {
    "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"
      }
    },
    "classroom": {
      "serverUrl": "https://classroommcp.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. פותחים את מסך ההגדרות (למשל, לוחצים על Settings בפינה השמאלית התחתונה או פותחים את Antigravity User Settings).
      2. עוברים אל התאמות אישיות.
      3. בקטע שרתי MCP מותקנים, לוחצים על רענון.
      4. לכל שרת שמופיע ברשימה (gmail,‏ drive,‏ docs,‏ sheets,‏ slides,‏ calendar,‏ chat,‏ people ו-classroom), לוחצים על Authenticate, נכנסים לחשבון Google, מעתיקים את קוד ההרשאה, מדביקים אותו בתיבת הדו-שיח של הקלט ולוחצים על Submit.

    • ב-Antigravity CLI:

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

        agy

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

        /mcp

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

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

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

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

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

Claude

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

כדי להוסיף ל-Claude את שרתי ה-MCP המרוחקים של Google Workspace, צריך להגדיר מחבר בהתאמה אישית עם מזהה לקוח וסוד של 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 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
        • ‫Google Classroom: ‏ https://classroommcp.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
    • ‫Google Classroom: ‏ https://classroommcp.googleapis.com/mcp/v1

  • תעבורה: HTTP שניתן להעביר בסטרימינג

  • אימות: שרת ה-MCP המרוחק של Google Workspace משתמש ב-OAuth 2.0. כשיוצרים את לקוח OAuth 2.0, בוחרים באפשרות Use this client for an agent מבוסס-AI. לפרטים, ראו מידע על אימות והרשאה.

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

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

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

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

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

  • "מה אריאל כתבה באימייל האחרון שלה לגבי תוכנית השיווק שלנו?"

    התוכנה מסננת אימיילים מאריאל באמצעות 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.

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

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

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

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

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

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

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

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

  • "אילו כיתות אני מלמד/ת כרגע?"

    הלקוח בודק את לוח הזמנים שלכם באמצעות classroom.list_course_summaries ומסכם את הקורסים הפעילים שבהם אתם בתפקיד המורה.

  • "תנסח הודעה על הסיור הקרוב בשטח בשביל שיעור הגיאולוגיה שלי".

    הלקוח משתמש ב-classroom.create_announcement כדי לנסח את ההודעה, ואתם יכולים לבדוק ולפרסם אותה באפליקציית Google Classroom.

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

פתרון בעיות

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

אם הבקשות שלכם לשרתי MCP נדחות, ודאו שבחרתם באפשרות Use this client for an AI-powered agent ללקוח OAuth 2.0 ב-Google Auth Platform > Clients. אם אתם לא יכולים לשנות את ההגדרה הזו בלקוח OAuth קיים, צרו לקוח OAuth חדש עם האפשרות שימוש בלקוח הזה לסוכן מבוסס-AI ועדכנו את האפליקציה כך שתשתמש בו. אם לקוח OAuth קיים משמש גם לתכונות של סוכני AI וגם לתכונות שלא קשורות לסוכנים, צריך ליצור לקוח OAuth נפרד לסוכן ה-AI ולהשאיר את הלקוח הקיים לתכונות שלא קשורות לסוכנים. הוראות מפורטות זמינות במאמרים הגדרת לקוח MCP וניהול לקוחות OAuth.

אם האפליקציה משתמשת בחשבון שירות עם הענקת גישה ברמת הדומיין, אי אפשר לבחור בשבילה את האפשרות Use this client for an AI-powered agent כי חשבונות שירות לא מנוהלים ב-Google Auth Platform > Clients. בקשות לשרתי MCP מחשבונות שירות שמשתמשים בהענקת גישה ברמת הדומיין לא נדחות מהסיבה הזו. הגישה נשלטת על ידי הגדרות ההקצאה ברמת הדומיין, שמנוהלות על ידי האדמין ב-Google Workspace. פרטים נוספים זמינים במאמר בנושא שליטה בהרשאות הגישה ל-API באמצעות הענקת גישה ברמת הדומיין.

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

  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 לא מושפעים מהשינוי.

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

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

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

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

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

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

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