הגדרת MCP

במאמר הזה מוסבר איך משתמשים בשרת Model Context Protocol‏ (MCP) המרוחק של Google Security Operations כדי להתחבר לאפליקציות AI, כולל Antigravity, ‏ ChatGPT, ‏ Claude ואפליקציות בהתאמה אישית שאתם מפתחים. שרת ה-MCP המרוחק של Google Security Operations מופעל כשמפעילים את Google Security Operations 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.

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

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

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

  4. Verify that billing is enabled for your Google Cloud project.

  5. Enable the Chronicle API, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

  6. Install the Google Cloud CLI.

  7. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  8. To initialize the gcloud CLI, run the following command: 

    gcloud init

  9. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  10. If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

  11. Verify that billing is enabled for your Google Cloud project.

  12. Enable the Chronicle API, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

  13. Install the Google Cloud CLI.

  14. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  15. To initialize the gcloud CLI, run the following command: 

    gcloud init

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

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

  • לבצע קריאות לכלי MCP: משתמש בכלי MCP (roles/mcp.toolUser)
  • גישה לשירות Chronicle API: אדמין של Chronicle API (roles/chronicle.admin)
  • כדי לתת גישת אדמין ל-Google SecOps: אדמין ב-Chronicle SOAR ‏ (roles/chronicle.soarAdmin)
  • אופציונלי: מגדירים תפקידים בהתאמה אישית ב-IAM עם ההרשאות שנדרשות ל-methods של Chronicle API שמופעלות על ידי כלי ה-MCP.

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

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

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

כדי להשתמש בשרת MCP המרוחק של Google SecOps, נדרשות ההרשאות הבאות:

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

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

אימות והרשאה

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

היקפי ההרשאות של Google SecOps MCP OAuth

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

ל-Google SecOps יש את היקף ההרשאות הבא ל-OAuth של כלי MCP:

URI של היקף ההרשאות ל-CLI של gcloud תיאור
https://www.googleapis.com/auth/chronicle היקף ההרשאות הזה מאפשר לקרוא ולשנות נתונים.

הגדרת לקוח MCP לשימוש בשרת MCP של Google SecOps

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

באפליקציית ה-AI, מחפשים דרך להוסיף שרת MCP מרוחק או להתחבר אליו. בשרת MCP של Google SecOps, מזינים את הפרטים הבאים לפי הצורך:

  • שם השרת: שרת Google SecOps MCP
  • כתובת ה-URL של השרת או נקודת הקצה: בוחרים את נקודת הקצה האזורית ומוסיפים mcp /‎ בסוף. לדוגמה, https://us-chronicle.googleapis.com/mcp
  • תעבורה: HTTP שניתן להעביר בסטרימינג
  • פרטי אימות: בהתאם לשיטת האימות שאתם רוצים להשתמש בה, אתם יכולים להזין את פרטי הכניסה, את מזהה הלקוח והסוד של לקוח OAuth או את פרטי הכניסה והזהות של הנציג. Google Cloud מידע נוסף על אימות זמין במאמר אימות בשרתי MCP.
  • היקף ההרשאות של OAuth: היקף ההרשאות של OAuth 2.0 שבו רוצים להשתמש כשמתחברים לשרת ה-MCP של Google SecOps. ב-Google SecOps, משתמשים ב-https://www.googleapis.com/auth/chronicle.

‫URI של הפניה לכתובת אחרת

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

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

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

הגדרת Antigravity לשימוש בשרת Google SecOps MCP

אתם יכולים להגדיר את Google Antigravity (גם את סביבת הפיתוח המשולבת למחשב וגם את ה-CLI) כך שיתחבר לשרת ה-MCP של Google SecOps.

הגדרת קובץ התצורה המשותף של MCP

ב-Antigravity יש קובץ תצורה משותף לכל שרתי ה-MCP.

  1. פותחים את קובץ התצורה המשותף של MCP‏ ~/.gemini/config/mcp_config.json בכלי לעריכת טקסט.

  2. מוסיפים את הגדרת שרת ה-MCP של Google SecOps לאובייקט mcpServers:

    {
  "mcpServers": {
    "google-cloud-secops": {
      "serverUrl": "https://us-chronicle.googleapis.com/mcp",
      "authProviderType": "google_credentials",
      "oauth": {
        "scopes": [
          "https://www.googleapis.com/auth/cloud-platform"
        ]
      },
      "timeout": 300000
    }
  }
}

    מחליפים את https://us-chronicle.googleapis.com/mcp בנקודת הקצה האזורית המתאימה למכונה של Google SecOps.

הגדרת הקשר ספציפי לדייר

שרת ה-MCP של Google SecOps דורש הקשר נוסף: customer_id,‏ project_id ו-region. ב-Antigravity, אתם מנהלים את זה באמצעות הגדרה ספציפית לסביבת העבודה.

  1. יוצרים ספריית סביבת עבודה ייעודית לדייר (לדוגמה, ~/workspace/secops/tenant-a/).

  2. בספרייה הזו, יוצרים קובץ תצורה בשם secops_tenant.json עם התוכן הבא:

    {
  "customer_id": "YOUR_CUSTOMER_ID",
  "project_id": "YOUR_PROJECT_ID",
  "region": "YOUR_REGION"
}

    מחליפים את YOUR_CUSTOMER_ID, YOUR_PROJECT_ID ו-YOUR_REGION בפרטי הדייר בפועל. האזור חייב להיות באותיות קטנות (לדוגמה, us או eu).

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

אפשר להשתמש בהגדרות ב-Antigravity CLI או ב-IDE במחשב.

ב-Antigravity CLI

  1. בטרמינל, עוברים לספריית סביבת העבודה שיצרתם:

    cd ~/workspace/secops/tenant-a/

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

    agy

    ממשק ה-CLI טוען באופן אוטומטי את ההקשר מ-secops_tenant.json בזמן ההפעלה.

  3. כדי לוודא שההגדרה נכונה, מריצים את הפקודה /mcp ב-CLI כדי לראות את הכלים הפעילים. אם טעינת ההקשר נכשלה, אתם יכולים לנפות באגים באמצעות היומנים של Antigravity CLI ב-~/.gemini/antigravity-cli/log/.

ב-IDE של Antigravity למחשב

  1. פותחים את אפליקציית Antigravity למחשב.
  2. יוצרים פרויקט חדש ובוחרים את תיקיית סביבת העבודה שיצרתם (שמכילה את secops_tenant.json).
  3. מתחילים שיחה חדשה. לסוכן תהיה גישה לכלים של Google SecOps MCP עם ההקשר הנכון של הדייר.

איך מגדירים את Gemini Enterprise לשימוש בשרת ה-MCP של Google SecOps

אתם יכולים לשלב את Google SecOps עם Gemini Enterprise באמצעות מאגר נתונים של MCP בהתאמה אישית. כך המשתמשים יכולים לשלוח שאילתות ל-Google SecOps ישירות מהצ'אט הראשי של Gemini Enterprise.

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

  1. מוודאים ששרת ה-MCP המרוחק מופעל במופע של Google SecOps.
  2. מוודאים שמדיניות הארגון לא מונעת יצירה של שרתי MCP בהתאמה אישית.

שלב 1: מגדירים אפליקציית אינטרנט עם OAuth 2.0

אתם צריכים ליצור אפליקציית אינטרנט מסוג OAuth 2.0 בפרויקט ב- Google Cloud שמשויך למכונה שלכם ב-Google SecOps.

  1. במסוף Google Cloud , נכנסים לדף APIs & Services ‏ > Credentials.
  2. לוחצים על Create Credentials ובוחרים באפשרות OAuth client ID.
  3. בוחרים באפשרות אפליקציית אינטרנט בתור סוג האפליקציה.
  4. מזינים שם ללקוח (לדוגמה, Gemini Enterprise SecOps MCP).
  5. בקטע Authorized redirect URIs, מוסיפים את כתובות ה-URL הבאות:
    • https://vertexaisearch.cloud.google.com/oauth-redirect
    • https://vertexaisearch.cloud.google.com/static/oauth/oauth.html
  6. לוחצים על Create ושומרים את מזהה הלקוח ואת סוד הלקוח שנוצרו.

שלב 2: מוסיפים את מאגר הנתונים של Google SecOps ב-Gemini Enterprise

אדמין צריך להגדיר את מחבר ה-MCP בהתאמה אישית באופן גלובלי.

  1. פותחים את Gemini Enterprise ועוברים לאפליקציה, או יוצרים אפליקציה חדשה.
  2. עוברים אל מאגרי נתונים מקושרים ולוחצים על מאגר נתונים חדש.
  3. בוחרים באפשרות Custom MCP (פלטפורמת MCP בהתאמה אישית) ומזינים את הפרטים הבאים:
    • כתובת ה-URL של שרת ה-MCP: בוחרים את נקודת הקצה האזורית ומוסיפים /mcp בסוף (לדוגמה, https://us-chronicle.googleapis.com/mcp).
    • כתובת ה-URL להרשאה: https://accounts.google.com/o/oauth2/v2/auth
    • פרמטרים של כתובת URL להרשאה: &access_type=offline&prompt=consent
    • Token URL: https://oauth2.googleapis.com/token
    • מזהה לקוח: מזינים את מזהה הלקוח משלב 1.
    • סוד לקוח: מזינים את סוד הלקוח משלב 1.
    • היקפי הרשאות OAuth: מזינים את https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/chronicle (מופרדים ברווח).
  4. שומרים את מאגר הנתונים (לדוגמה, נותנים לו את השם Agentic SOC).
  5. באפליקציית Gemini Enterprise, בוחרים באפשרות מאגרי נתונים מקושרים ומוודאים שמאגר הנתונים החדש מופעל.
  6. בתפריט, לוחצים על פעולות ואז על טעינה מחדש של פעולות בהתאמה אישית.
  7. בוחרים את הפעולות שרוצים להפעיל למשתמשים ולוחצים על הפעלת הפעולות.

שלב 3: אימות המחבר בצ'אט

כל משתמש צריך לתת ל-Gemini הרשאה לגשת ל-Google SecOps בשמו.

  1. פותחים את השיחה הראשית ב-Gemini Enterprise.
  2. מאתרים את מאגר הנתונים המקושר (לדוגמה, Agentic SOC) בתחתית חלון הצ'אט ומעבירים את המתג למצב מופעל.
  3. משלימים את תהליך הכניסה כדי לתת את הרשאות ה-OAuth הנדרשות.

שלב 4: מגדירים את הזיכרון של Gemini כדי לספק לו הקשר

כדי לוודא ש-Gemini מנתב קריאות ל-API בצורה נכונה עם ההקשר הנדרש של הדייר (tenant), אתם צריכים לשמור את פרטי הסביבה בזיכרון של Gemini.

שולחים ל-Gemini הנחיה כמו זו שבהמשך (מחליפים את הערכים הזמניים לשמירת מקום בנתונים בפועל):

Remember that for all Google SecOps and Agentic SOC queries, my Customer ID is CUSTOMER_ID, my Region is REGION, and my Google Cloud project ID is PROJECTID.

‫Gemini יאשר שהוא שמר את הפרטים האלה.

‫שלב 5: מתחילים לשלוח שאילתות

עכשיו אפשר לשלוח שאילתות ל-Google SecOps באמצעות שפה טבעית בצ'אט הראשי. לדוגמה:

  • "באמצעות המחבר של Agentic SOC, חפש ניסיונות התחברות מ-3 הימים האחרונים".
  • "סכם את הפניות הפתוחות האחרונות ב-SecOps".

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

בחומר העזר של Google SecOps MCP מפורטים כלי ה-MCP הזמינים בשרת Google SecOps MCP והתיאורים שלהם.

כלים לרשימות

משתמשים ב-MCP inspector כדי להציג רשימה של כלים, או שולחים בקשת HTTP מסוג tools/list ישירות לשרת ה-MCP המרוחק של Google Security Operations. השיטה tools/list לא דורשת אימות.

curl -X POST https://chronicle.REGION.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 אחרי שם השירות. לדוגמה, ב-Google Security Operations, יכול להיות שהערך יהיה mcp/toolset-name.
  • ‫MCP_PROTOCOL_VERSION: גרסת פרוטוקול ה-MCP. לדוגמה, 2026-07-28.

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

הנה כמה תרחישים לדוגמה לשימוש בשרת ה-MCP של Google SecOps:

כלי: list_rule_errors

הנחיה לדוגמה:

List rule errors for the rule: ru_ddd45753-d749-4fee-b068-29072e750cfb

תשובה:

Here are the rule errors for ru_ddd45753-d749-4fee-b068-29072e750cfb:

Error Message: query took too long to execute, see https://docs.cloud.google.com/chronicle/docs/detection/yara-l-best-practices for tips for optimizing rules; these optimization tips are applicable to various types of queries

Time Range: 2025-02-16T10:00:00Z to 2025-02-16T11:00:00Z
Rule: projects/935934211738/locations/US/instances/eb3b937b-3ab6-47e5-8185-24837b826691/rules/ru_ddd45753-d749-4fee-b068-29072e750cfb@v_1740004374_748943000
Error Message: query took too long to execute, see https://docs.cloud.google.com/chronicle/docs/detection/yara-l-best-practices for tips for optimizing rules; these optimization tips are applicable to various types of queries

Time Range: 2025-02-16T11:00:00Z to 2025-02-16T12:00:00Z
Rule: projects/935934211738/locations/US/instances/eb3b937b-3ab6-47e5-8185-24837b826691/rules/ru_ddd45753-d749-4fee-b068-29072e750cfb@v_1740004374_748943000
The errors indicate that the queries for this rule took too long to execute during the specified time ranges. You may want to review the YARA-L best practices for optimizing rules.

כלי: create_rules

הנחיה לדוגמה:

Create the following rule:
successful_user_logins_from_outside_us_test {
meta:
author = "Google SecOps Gemini"
description = "Detect successful user logins originating from outside the United States."
severity = "Medium"
events:
$e.metadata.event_type = "USER_LOGIN"
$e.security_result.action = "ALLOW"
$e.principal.ip_geo_artifact.location.country_or_region != "United States"
outcome:
$user = array($e.principal.user.userid)
$source_ip = array($e.principal.ip)
$country = array($e.principal.ip_geo_artifact.location.country_or_region)
$city = array($e.principal.ip_geo_artifact.location.city)
condition:
$e
}

תשובה:

The rule successful_user_logins_from_outside_us_test has been successfully created with the following details:

Name: projects/935934211738/locations/US/instances/eb3b937b-3ab6-47e5-8185-24837b826691/rules/ru_cff9cae1-bb88-4456-b725-4c08f21803ed
Revision ID: v_1768208899_054095000
Display Name: successful_user_logins_from_outside_us_test
Author: Google SecOps Gemini
Description: Detect successful user logins originating from outside the United States.
Severity: Medium
Compilation State: SUCCEEDED
Create Time: 2026-01-12T09:08:19.054095Z

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

בגלל המגוון הרחב של הפעולות שאפשר לבצע באמצעות כלי 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

התכונה "הגנה מוגברת על המודל" זמינה באזורים מסוימים. אם אתם מפעילים את Model Armor ומשתמשים בשרת MCP בסמכות שיפוט שלא נתמכת על ידי Model Armor, יכול להיות שההתנהגות של ניתוב הקריאה תהיה שונה בשרתי MCP שונים, ושהיא תפר את התאימות של מיקום אחסון הנתונים לנתונים שנמצאים בשימוש ובמעבר. מידע נוסף על ההתנהגות של שרתי 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. מפעילים את Cloud Shell במסוף Google Cloud .

    הפעלת Cloud Shell

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

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

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

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

הגדרת הגנה לשרתי MCP של Google ו Google Cloud לשרתי 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 באמצעות ניהול זהויות והרשאות גישה.

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

הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.