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

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

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

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

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

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

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

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

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

  • Google Chat API

CLI

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

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

המסוף

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

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

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

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

  • Google Chat MCP API

CLI

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

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

המסוף

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

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

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

כדי להשתמש בשרת ה-MCP של Google Chat לביצוע פעולות לקריאה בלבד, כמו חיפוש שיחות, צריך להפעיל את ה-API וליצור לקוח OAuth. לא צריך להגדיר אפליקציה ל-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 Chat משתמש ב-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, מקלידים Chat MCP Server.
    2. בקטע User support email, בוחרים את כתובת האימייל שלכם או קבוצה מתאימה ב-Google.
    3. לוחצים על הבא.
    4. בקטע Audience, לוחצים על Internal. אם אי אפשר לבחור באפשרות Internal, בוחרים באפשרות External.
    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. לוחצים על גישה לנתונים > הוספה או הסרה של היקפים. יופיע חלונית עם רשימת היקפי ההרשאות לכל API שהפעלתם בפרויקט ב-Google Cloud.

    1. בקטע הוספה ידנית של היקפי הרשאות, מדביקים את היקפי ההרשאות של שרת ה-MCP של 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
      • https://www.googleapis.com/auth/chat.users.spacesettings

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

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

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

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

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

Antigravity

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

    • ב-Antigravity CLI:

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

        agy

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

        /mcp

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

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

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

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

Claude

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

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

אחרים

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

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

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

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

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

  • "מה הייתה ההודעה האחרונה במרחב המשותף 'פרויקט X'?"

    הלקוח מוצא את המרחב המשותף באמצעות search_conversations ואז מאחזר הודעות באמצעות list_messages.

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

פתרון בעיות

אם נתקלתם בבעיות בחיבור לשרת ה-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.

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

הפניה לכלי

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

  • search_conversations
  • list_messages
  • search_messages
  • send_message
  • mark_as_read
  • mark_as_unread
  • list_memberships
  • get_notification_settings
  • update_notification_settings

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

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

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

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

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