‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

הגדרת 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. הכותרות האלה משתקפות בכותרות HTTP מהסכימה של קלט הכלי באמצעות המאפיין x-mcp-header. לדוגמה, שרת MCP יכול להגדיר כותרת מותאמת אישית כדי לציין את האזור או את מזהה הפרויקט של Google Cloud .

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

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

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

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

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

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

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.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector
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.
Verify that billing is enabled for your Google Cloud project.
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

Install the Google Cloud CLI.

Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
Configure the gcloud CLI to use your federated identity.

For more information, see Sign in to the gcloud CLI with your federated identity.
To initialize the gcloud CLI, run the following command:
```
gcloud init
```

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

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

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

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

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

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

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

להפעיל קריאות API לכלי 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 מרוחק או להתחבר אליו. בשרת Google SecOps MCP, מזינים את הפרטים הבאים לפי הצורך:

שם השרת: שרת 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.

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

מוסיפים את הגדרת שרת ה-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, אתם מנהלים את זה באמצעות הגדרה ספציפית לסביבת העבודה.

יוצרים ספריית סביבת עבודה ייעודית לדייר (לדוגמה, ~/workspace/secops/tenant-a/).
בספרייה הזו, יוצרים קובץ תצורה בשם 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

בטרמינל, עוברים לספריית סביבת העבודה שיצרתם:
```
cd ~/workspace/secops/tenant-a/
```
מפעילים את Antigravity CLI:
```
agy
```
ה-CLI טוען באופן אוטומטי את ההקשר מ-secops_tenant.json בזמן ההפעלה.
כדי לוודא שההגדרה נכונה, מריצים את הפקודה /mcp ב-CLI כדי לראות את הכלים הפעילים. אם טעינת ההקשר נכשלה, אתם יכולים לנפות באגים באמצעות היומנים של Antigravity CLI ב-~/.gemini/antigravity-cli/log/.

ב-IDE של Antigravity למחשב

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

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

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

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

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

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

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

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

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

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

פותחים את Gemini Enterprise ועוברים לאפליקציה, או יוצרים אפליקציה חדשה.
עוברים אל מאגרי נתונים מקושרים ולוחצים על מאגר נתונים חדש.
בוחרים באפשרות 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 (מופרד ברווח).
שומרים את מאגר הנתונים (לדוגמה, נותנים לו את השם Agentic SOC).
באפליקציית Gemini Enterprise, בוחרים באפשרות מאגרי נתונים מקושרים ומוודאים שמאגר הנתונים החדש מופעל.
בתפריט, לוחצים על פעולות ואז על טעינה מחדש של פעולות בהתאמה אישית.
בוחרים את הפעולות שרוצים להפעיל למשתמשים ולוחצים על הפעלת הפעולות.

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

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

פותחים את השיחה הראשית ב-Gemini Enterprise.
מאתרים את מאגר הנתונים המקושר (לדוגמה, Agentic SOC) בתחתית חלון הצ'אט ומעבירים את המתג למצב מופעל.
משלימים את ההצעה להיכנס לחשבון כדי לתת את הרשאות ה-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

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

המסוף

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

gcloud

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

התקינו את ה-CLI של Google Cloud ואז היכנסו ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם. אחרי שנכנסתם לחשבון, אתחלו את ה-CLI של Google Cloud באמצעות הפקודה הבאה:
```
gcloud init
```
מריצים את הפקודה הבאה כדי להגדיר את נקודת הקצה ל-API של שירות Model Armor.
```
gcloud config set api_endpoint_overrides/modelarmor "https://modelarmor.LOCATION.rep.googleapis.com/"
```
מחליפים את LOCATION באזור שבו רוצים להשתמש ב-Model Armor.

הגדרת הגנה לשרתי MCP של Google ו Google Cloud שרתי MCP מרוחקים

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

מגדירים את הסף של Model Armor כשהסרת תוכן זדוני או רגיש ב-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

כדי להפסיק את הסריקה האוטומטית של Model Armor לתנועה אל שרתי Google 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.