שימוש בשרת ה-MCP של Secure Source Manager

במאמר הזה מוסבר איך משתמשים בשרת Model Context Protocol‏ (MCP) מרוחק של Secure Source Manager כדי להתחבר לאפליקציות מבוססות-AI, כולל Antigravity, ‏ ChatGPT, ‏ Claude ואפליקציות בהתאמה אישית שאתם מפתחים. שרת ה-MCP המרוחק של Secure Source Manager מאפשר לאפליקציות ה-AI ולעוזרי התכנות שלכם לתקשר ישירות עם מאגרי קוד המקור, כללי ההגנה על הסתעפויות, הבעיות ובקשות ה-pull. שרת ה-MCP המרוחק של Secure Source Manager מופעל כשמפעילים את Secure Source Manager API.

‫Model Context Protocol (MCP) הוא תקן שמגדיר איך מודלים גדולים של שפה (LLM) ואפליקציות או סוכנים של AI מתחברים למקורות נתונים חיצוניים. שרתי MCP מאפשרים לכם להשתמש בכלים, במשאבים ובהנחיות שלהם כדי לבצע פעולות ולקבל נתונים מעודכנים משירות הקצה העורפי שלהם.

מה ההבדל בין שרתי MCP מקומיים לשרתי MCP מרוחקים?

שרתי MCP מקומיים
בדרך כלל פועלים במחשב המקומי ומשתמשים בזרמי הקלט והפלט הרגילים (stdio) כדי לתקשר בין שירותים באותו מכשיר.
שרתי MCP מרוחקים
פועלים בתשתית של השירות ומציעים נקודת קצה (endpoint) מסוג HTTP לאפליקציות AI, כדי לאפשר תקשורת בין לקוח ה-MCP של ה-AI לבין שרת ה-MCP. מידע נוסף על ארכיטקטורת MCP

ליבה ללא שמירת מצב

בגרסת MCP‏ 2026-07-28, פרוטוקול MCP משתנה מפרוטוקול דו-כיווני עם שמירת מצב (stateful) לפרוטוקול ללא שמירת מצב (stateless). כל בקשת MCP מתארת את עצמה ואפשר לנתב אותה באמצעות כותרות. אין צורך בלחיצת היד של initialize/initialized או ב-Mcp-Session-Id כי כל בקשה כוללת את כל המידע הנדרש בכותרות HTTP או בפרמטר _meta. שרתי MCP יכולים לבקש מידע נוסף שנדרש לכלי באמצעות בקשות הלוך ושוב (MRTR).

כדי לנתב ולעבד בקשות בלי לנתח את גוף הבקשה, נדרשות כמה כותרות MCP, כולל:

למידע נוסף על הארכיטקטורה של MCP, קראו את המפרט של MCP בגרסה 2026-07-28 ואת השינויים העיקריים.

שרתי MCP של Google ושרתי MCP מרוחקים של Google Cloud

לשרתי MCP של Google ושל Google Cloud יש את התכונות והיתרונות הבאים:

  • חיפוש פשוט ומרוכז
  • נקודות קצה (endpoints) מנוהלות של HTTP גלובלי או אזורי
  • הרשאה פרטנית
  • אבטחה אופציונלית של הנחיות ותשובות באמצעות הגנה מוגברת על המודל
  • רישום מרכזי ביומן הביקורת

במאמר סקירה כללית על שרתי Google Cloud MCP מוסבר על שרתי MCP אחרים ועל אמצעי הבקרה לאבטחה ולמשילות שזמינים לשרתי Google Cloud MCP.

לפני שמתחילים

כדי להשתמש בשרת MCP של Secure Source Manager, צריך ליצור מכונה ומאגר של Secure Source Manager. להוראות, ראו יצירת מכונה ויצירת מאגר.

התפקידים הנדרשים

כדי לקבל את ההרשאות שנדרשות לשימוש בשרת ה-MCP של Secure Source Manager, בקשו מהאדמין לתת לכם את התפקידים הבאים ב-IAM ברמת הפרויקט, המכונה והמאגר שבהם אתם רוצים להשתמש בשרת ה-MCP של Secure Source Manager:

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

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

ההרשאות הנדרשות

כדי להשתמש בשרת ה-MCP של Secure Source Manager, נדרשות ההרשאות הבאות:

  • להפעיל כלי MCP: mcp.tools.call

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

אימות והרשאה

שרת ה-MCP המרוחק של Secure Source Manager משתמש בפרוטוקול OAuth 2.0 עם ניהול זהויות והרשאות גישה (IAM) לאימות ולהרשאה. כל Google Cloud הזהויות נתמכות לאימות בשרתי MCP.

שרת ה-MCP של Secure Source Manager דורש חשבון משתמש לצורך ניהול זהויות והרשאות גישה (IAM), ולא מקבל מפתחות API. כדי שתוכלו לשלוט בגישה למשאבים ולעקוב אחריה, מומלץ ליצור זהות נפרדת לסוכנים שמשתמשים בכלים של MCP.

מידע נוסף על אימות זמין במאמר אימות לשרתי MCP.

היקפי ההרשאות של Secure Source Manager MCP OAuth

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

ל-Secure Source Manager יש את היקפי ההרשאות הבאים של OAuth לכלי MCP:

היקף ה-URI של Google Cloud CLI תיאור
https://www.googleapis.com/auth/cloud-platform גישה מלאה לכל המשאבים של Google Cloud .

יכול להיות שיידרשו הרשאות נוספות למשאבים שאליהם ניגשים במהלך קריאה לפונקציה. במאמר בקרת גישה באמצעות IAM מפורטת רשימת התפקידים וההרשאות שנדרשים ל-Secure Source Manager.

הגדרת לקוח MCP לשימוש בשרת MCP של Secure Source Manager

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

  • שם השרת: שרת MCP של Secure Source Manager
  • כתובת ה-URL של השרת או נקודת הקצה: שרת ה-MCP של Secure Source Manager תומך רק בנקודות קצה אזוריות. משתמשים בנקודת הקצה האזורית של מיקום המכונה: https://securesourcemanager.LOCATION.rep.googleapis.com/mcp, כאשר LOCATION הוא האזור הנתמך שבו נמצאת המכונה.
  • תעבורה: HTTP שניתן להעביר בסטרימינג
  • פרטי אימות: בהתאם לשיטת האימות שאתם רוצים להשתמש בה, אתם יכולים להזין את פרטי הכניסה, את מזהה הלקוח והסוד של לקוח OAuth או את פרטי הכניסה והזהות של הנציג. Google Cloud מידע נוסף על אימות זמין במאמר אימות בשרתי MCP.
  • היקף OAuth: היקף OAuth 2.0 שבו רוצים להשתמש כשמתחברים לשרת ה-MCP של Secure Source Manager.

נקודות קצה (endpoints) של ערכת הכלים

שרת ה-MCP של Secure Source Manager מציע נקודות קצה של ערכות כלים ייעודיות, כדי שתוכלו להגביל את הכלים שחשופים לסוכן ה-AI:

  • סקר קוד: https://securesourcemanager.LOCATION.rep.googleapis.com/mcp/code_review
  • בקשות משיכה: https://securesourcemanager.LOCATION.rep.googleapis.com/mcp/pull_request
  • כללי הסתעפות: https://securesourcemanager.LOCATION.rep.googleapis.com/mcp/branch_rule
  • מאגרים: https://securesourcemanager.LOCATION.rep.googleapis.com/mcp/repository
  • מכונות: https://securesourcemanager.LOCATION.rep.googleapis.com/mcp/instance
  • הוקים: https://securesourcemanager.LOCATION.rep.googleapis.com/mcp/hook

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

למידע כללי נוסף, אפשר לעיין במקורות המידע הבאים:

באילו כלים אפשר להשתמש

כדי לראות את הפרטים של כלי ה-MCP הזמינים ואת התיאורים שלהם לשרת ה-MCP של Secure Source Manager, עיינו בחומר העזר של Secure Source Manager MCP.

כלים לרשימות

משתמשים בכלי לבדיקת MCP כדי להציג את רשימת הכלים, או שולחים בקשת HTTP מסוג tools/list ישירות לשרת ה-MCP המרוחק של Secure Source Manager. השיטה tools/list לא דורשת אימות.

curl -X POST https://securesourcemanager.LOCATION.rep.googleapis.com/TOOLSET_ENDPOINT \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -H 'MCP-Protocol-Version: MCP_PROTOCOL_VERSION' \
    -H 'Mcp-Method: tools/list' \
    -d '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "tools/list",
      "params": {
        "_meta": {
          "io.modelcontextprotocol/protocolVersion": "MCP_PROTOCOL_VERSION",
          "io.modelcontextprotocol/clientCapabilities": {
            "extensions": {
              "io.modelcontextprotocol/ui": {
                "mimeTypes": ["text/html;profile=mcp-app"]
              }
            }
          }
        }
      }
    }'

מחליפים את מה שכתוב בשדות הבאים:

  • ‫TOOLSET_ENDPOINT: החלק שנותר בנקודת הקצה של ה-MCP אחרי שם השירות. לדוגמה, ב-Secure Source Manager, יכול להיות שהערך יהיה mcp/toolset-name.
  • ‫MCP_PROTOCOL_VERSION: גרסת פרוטוקול ה-MCP. לדוגמה, 2026-07-28.

תרחישים לדוגמה

כשמחברים סוכן AI או עוזר דיגיטלי של IDE לשרת ה-MCP של Secure Source Manager, אפשר לבדוק את מאגרי המקורות של הקוד, להפוך תהליכי עבודה של בקשות משיכה לאוטומטיים ולנהל כללי פיקוח באמצעות שפה טבעית.

אתם יכולים להשתמש בשרת ה-MCP של Secure Source Manager בתרחישים הבאים:

  • אוטומציה של סקרי קוד וניהול בקשות משיכה: סוכן AI יכול לבדוק בקשות משיכה פתוחות, לנתח קבצים שהשתנו והשוואות, וליצור, לפתור או לשלוח בכמות גדולה הערות סקר ספציפיות לשורות.
  • ניהול מאגרים ומכונות: אחזור פרטי המאגר, בדיקת מכונות של Secure Source Manager או יצירה והגדרה של מאגרי קוד מקור בארגון.
  • בדיקה והגדרה של ניהול הסתעפויות ו-webhooks: שליחת שאילתות, יצירה או עדכון של כללי הגנה על הסתעפויות כדי לאכוף מדיניות אבטחה על הסתעפויות קריטיות, או ניהול של webhooks במאגר לשילובים של CI/CD.

פרומפטים לדוגמה

הנה כמה דוגמאות להנחיות שאפשר לתת לאפליקציית ה-AI המקושרת:

  • בדיקת בקשות משיכה והבדלים: "הצג את כל בקשות המשיכה הפתוחות במאגר my-repo וסכם את הקבצים שהשתנו ואת ההבדלים בבקשת משיכה מספר 12".
  • שליחת הערות על סקירת קוד: "הוסף הערת סקירה בשורה 45 של auth.go בבקשת משיכה מספר 12, עם הצעות לשיפור הטיפול בשגיאות".
  • בדיקת ההגנה על ההסתעפות: "הצג את כללי ההגנה על ההסתעפות main במאגר my-repo".
  • הגדרת ניהול הסתעפויות: "Create a branch protection rule for repository my-repo that requires approval before merging into main"
  • בדיקת מאגרים ומכונות: "הצג את כל המאגרים של Secure Source Manager במכונה my-instance ואת הפרטים שלהם".

הגדרות אופציונליות של אבטחה ובטיחות

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

מידע נוסף על אבטחה ופיקוח ב-MCP זמין במאמר אבטחה ובטיחות ב-AI.

שימוש ב-Model Armor

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

כשהתכונה "הגנה מוגברת על המודל" מופעלת עם רישום ביומן, היא מתעדת את כל המטען הייעודי (payload). זה עלול לחשוף מידע רגיש ביומנים.

ניתוב בקשות של MCP ל-Model Armor

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

הפעלת Model Armor

כדי להשתמש ב-Model Armor, צריך להפעיל את ממשקי ה-API של Model Armor.

המסוף

  1. מפעילים את Model Armor API, אם הוא עדיין לא מופעל.

    התפקידים שנדרשים כדי להפעיל ממשקי API

    כדי להפעיל ממשקי API, צריך את ההרשאה serviceusage.services.enable. אם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד "בעלים" (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד "אדמין בממשק 'שימוש בשירות'" (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים

    להפעלת ה-API

  2. בוחרים את הפרויקט שבו רוצים להפעיל את Model Armor.

gcloud

לפני שמתחילים, מבצעים את השלבים הבאים באמצעות Google Cloud CLI עם Model Armor API:

  1. התקינו את ה-CLI של Google Cloud ואז היכנסו ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם. אחרי שנכנסתם לחשבון, אתחלו את ה-CLI של Google Cloud באמצעות הפקודה הבאה: 

    gcloud init

  2. מריצים את הפקודה הבאה כדי להגדיר את נקודת הקצה ל-API של שירות Model Armor.

    gcloud config set api_endpoint_overrides/modelarmor "https://modelarmor.LOCATION.rep.googleapis.com/"

    מחליפים את LOCATION באזור שבו רוצים להשתמש ב-Model Armor.

הגדרת הגנה לשרתי MCP

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

מגדירים את ההגנה המוגברת על המודל עם הסרת תוכן זדוני או רגיש ב-MCP. מידע נוסף זמין במאמר הגדרת רמות הסינון של Model Armor.

דוגמה לפקודה:

gcloud model-armor floorsettings update \
--full-uri='projects/PROJECT_ID/locations/global/floorSetting' \
--enable-floor-setting-enforcement=TRUE \
--add-integrated-services=GOOGLE_MCP_SERVER \
--google-mcp-server-enforcement-type=INSPECT_AND_BLOCK \
--enable-google-mcp-server-cloud-logging \
--malicious-uri-filter-settings-enforcement=ENABLED \
--add-rai-settings-filters='[{"confidenceLevel": "MEDIUM_AND_ABOVE", "filterType": "DANGEROUS"}]'

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

שימו לב להגדרות הבאות:

  • ‫INSPECT_AND_BLOCK: סוג האכיפה שבודק את התוכן בשרת MCP של Google וחוסם הנחיות ותשובות שתואמות למסננים.
  • ‫ENABLED: ההגדרה שמפעילה סינון או אכיפה.
  • ‫MEDIUM_AND_ABOVE: רמת הסמך של הגדרות הסינון של Responsible AI - Dangerous. אפשר לשנות את ההגדרה הזו, אבל ערכים נמוכים יותר עלולים לגרום ליותר תוצאות חיוביות כוזבות. מידע נוסף מופיע במאמר רמות הסמך של Model Armor.

השבתת הסריקה של תנועת MCP באמצעות Model Armor

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

gcloud model-armor floorsettings update \
  --full-uri='projects/PROJECT_ID/locations/global/floorSetting' \
  --remove-integrated-services=GOOGLE_MCP_SERVER

מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud . התכונה "הגנה מוגברת על המודל" לא מחילה באופן אוטומטי את הכללים שמוגדרים בהגדרות המינימום של הפרויקט הזה על תנועה בשרת MCP של Google.

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

שליטה בשימוש ב-MCP באמצעות מדיניות IAM

כללי מדיניות הדחייה וכללי מדיניות ההרשאה של ניהול זהויות והרשאות גישה (IAM) עוזרים לכם לאבטח את Google Cloud ואת שרתי Google MCP.

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

  • חשבון המשתמש.
  • מאפייני הכלי, כמו המאפיין "לקריאה בלבד".
  • שם השירות או שם הכלי.
  • מזהה הלקוח ב-OAuth של האפליקציה.

מידע נוסף זמין במאמר שליטה בשימוש ב-MCP באמצעות ניהול זהויות והרשאות גישה.

המאמרים הבאים