הגדרת שרת ה-MCP של Drive

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

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

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

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

הגדרת שרת ה-MCP של Google Drive

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

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

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

  • Google Drive API

CLI

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

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

המסוף

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

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

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

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

  • Google Drive MCP API

CLI

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

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

המסוף

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

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

שרת ה-MCP של Google Drive משתמש ב-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, מקלידים Drive 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 Drive:

      • https://www.googleapis.com/auth/drive.readonly
      • https://www.googleapis.com/auth/drive.file

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

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

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

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

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

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

Antigravity

כדי להוסיף את שרת ה-MCP המרוחק של Google Drive ל-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": {
    "drive": {
      "serverUrl": "https://drivemcp.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. מוצאים את drive ברשימה, לוחצים על Authenticate, נכנסים לחשבון Google, מעתיקים את קוד ההרשאה, מדביקים אותו בתיבת הדו-שיח של הקלט ולוחצים על Submit.

    • ב-Antigravity CLI:

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

        agy

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

        /mcp

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

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

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

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

Claude

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

כדי להוסיף ל-Claude את שרת ה-MCP המרוחק של Google Drive, צריך להגדיר מחבר בהתאמה אישית עם מזהה לקוח וסוד לקוח ב-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 Drive:
      • שם השרת: Google Drive.
      • כתובת ה-URL של שרת ה-MCP המרוחק: https://drivemcp.googleapis.com/mcp/v1
    4. בהגדרות מתקדמות, מזינים את מזהה הלקוח ב-OAuth ואת סוד הלקוח ב-OAuth.
    5. לוחצים על הוספה.

אחרים

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

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

בדיקת שרת ה-MCP של Google Drive

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

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

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

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

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

פתרון בעיות

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

בדיקת אירועים ביומן של 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 Drive:

  • copy_file
  • create_file
  • download_file_content
  • get_file_metadata
  • get_file_permissions
  • list_recent_files
  • read_file_content
  • search_files

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

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

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

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

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