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

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

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

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

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

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

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

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

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

  • Google Docs API

CLI

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

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

המסוף

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

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

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

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

  • Docs MCP API

CLI

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

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

המסוף

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

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

שרת ה-MCP של Docs משתמש ב-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, מקלידים Docs 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 של 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
    2. לוחצים על הוספה לטבלה.

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

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

הגדרת אפליקציית ה-AI

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

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

Antigravity

כדי להוסיף את שרת ה-MCP המרוחק של Docs ל-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 (יצירה) ומעתיקים את Client ID (מזהה הלקוח) ואת Client Secret (סוד הלקוח).

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

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

    {
      "mcpServers": {
        "docs": {
          "serverUrl": "https://docsmcp.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. מוצאים את docs ברשימה, לוחצים על Authenticate, נכנסים לחשבון Google, מעתיקים את קוד ההרשאה, מדביקים אותו בתיבת הדו-שיח של הקלט ולוחצים על Submit.
    • ב-Antigravity CLI:

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

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

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

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

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

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

Claude

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

כדי להוסיף ל-Claude את שרת ה-MCP המרוחק של Docs, צריך להגדיר מחבר בהתאמה אישית עם מזהה לקוח וסוד לקוח ב-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 (יצירה) ומעתיקים את Client ID (מזהה הלקוח) ואת Client Secret (סוד הלקוח).

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

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

אחרים

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

  • שם השרת: docs

  • כתובת ה-URL של השרת: https://docsmcp.googleapis.com/mcp/v1

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

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

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

איך מגדירים MCP באפליקציית AI

בדיקת שרת ה-MCP של Docs

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

נסו לשאול את אפליקציית ה-AI את השאלות הבאות:

  • "תציג לי את המבנה של מסמך Google Docs‏ abcd123".

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

  • "הוסף את הכותרת 'תוכנית השיווק שלי' למסמך Google Docs‏ abcd123".

    הלקוח מבצע docs.update_doc כדי לעדכן רכיבים מבניים ולהוסיף טקסט.

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

פתרון בעיות

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

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

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

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

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

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

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

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

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

  • בקרת גישה: בקשות לשרת ה-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 AI-powered agent.
  2. בסקריפט, משתמשים בספריית OAuth2 for Apps Script כדי לתת למשתמשים הרשאה באמצעות לקוח OAuth.
  3. כשאתם שולחים קריאה לשרת ה-MCP, שלחו את טוקן הגישה שהספרייה מחזירה במקום את הטוקן מ-ScriptApp.getOAuthToken.

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

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

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

  • אין גישה אופליין בלקוח OAuth של אפליקציית אינטרנט: בניגוד ללקוחות OAuth של אפליקציה למחשב, לקוחות OAuth של אפליקציית אינטרנט מוגדרים כברירת מחדל לגישה אונליין. כדי לבקש טוקן רענון, צריך לכלול את access_type=offline או את ההיקף offline_access של OpenID Connect ‏(OIDC) לצד היקף אחד לפחות של API, ולא להגדיר את access_type=online.
  • אישור מחדש של אפליקציה שכבר ניתנה לה הסכמה: שרת OAuth 2.0 של Google מנפיק טוקן רענון בפעם הראשונה שמשתמש מעניק גישה אופליין. אם משתמש כבר נתן הרשאה ללקוח ה-OAuth שלכם בלי גישה אופליין, או אם לקוח ה-MCP שלכם איבד את טוקן הרענון ששמר, יכול להיות שכניסות עתידיות לא יחזירו טוקן רענון חדש. צריך לכלול את prompt=consent בבקשת ההרשאה, או להסיר את הגישה של האפליקציה בחיבורים לחשבון Google ולהיכנס שוב.
  • טוקן סטטי למוכ"ז: אם מעבירים טוקן גישה גולמי בכותרת Authorization, כמו פלט מ-gcloud auth print-access-token, תוקף הטוקן יפוג אחרי שעה, אלא אם הלקוח ירענן אותו.

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

הפניה לכלי

הכלים הבאים זמינים בשרת ה-MCP של Docs. סכימות קלט ופלט מפורטות במאמרי העזרה של Docs MCP:

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

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

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

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

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