שימוש בשרת MCP מרוחק של AlloyDB

במאמר הזה נסביר איך להשתמש בשרת Model Context Protocol‏ (MCP) מרוחק של AlloyDB ל-PostgreSQL כדי להתחבר לאפליקציות מבוססות-AI, כולל Gemini CLI, ‏ ChatGPT, ‏ Claude ואפליקציות בהתאמה אישית שאתם מפתחים. שרת ה-MCP המרוחק של AlloyDB ל-PostgreSQL מאפשר לכם לגשת לכלי AlloyDB ולהפעיל אותם כדי לנהל אשכולות ומופעים של AlloyDB מסביבות פיתוח מבוססות-AI ופלטפורמות סוכני AI. שרת ה-MCP המרוחק של AlloyDB ל-PostgreSQL מופעל כשמפעילים את AlloyDB ל-PostgreSQL API.

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

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

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

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

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

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

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

כדאי להשתמש בשרת MCP מקומי של AlloyDB מהסיבות הבאות:

  • פיתוח ובדיקה באופן מקומי
  • שימוש ב-MCP במצב אופליין
  • ניהול אשכולות ומופעים של AlloyDB מאפליקציית ה-AI

מידע נוסף על השימוש בשרת MCP מקומי זמין במאמרים שימוש ב-AlloyDB ל-PostgreSQL עם MCP,‏ Gemini CLI וסוכנים אחרים או שרת AlloyDB ל-PostgreSQL MCP. הקטעים הבאים רלוונטיים רק לשרת MCP מרוחק של AlloyDB ל-PostgreSQL.

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

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

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

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

מגבלות

לשרת ה-MCP המרוחק של AlloyDB יש את המגבלות הבאות:

  • הכלי create_user לא תומך ביצירת משתמש אימות מובנה עם סיסמה. אפשר ליצור משתמש רק באמצעות אימות IAM.
  • אם הכלי execute_sql מחזיר תשובה שגודלה גדול מ-10MB, יכול להיות שהתשובה תקוצר.
  • ‫execute_sql_read_only נתמך רק ב-PostgreSQL מגרסה 17 ואילך.

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

  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. Enable the AlloyDB 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

  5. Install the Google Cloud CLI.

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

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

    gcloud init

  8. 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

  9. 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.

  10. Enable the AlloyDB 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

  11. Install the Google Cloud CLI.

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

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

    gcloud init

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

כדי לקבל את ההרשאות שדרושות לשימוש בשרת ה-MCP של AlloyDB ל-PostgreSQL, צריך לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים בפרויקט שבו אתם רוצים להשתמש בשרת ה-MCP של AlloyDB ל-PostgreSQL:

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

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

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

כדי להשתמש בשרת AlloyDB ל-PostgreSQL MCP, נדרשות ההרשאות הבאות:

  • ביצוע קריאות לכלי MCP: mcp.tools.call
  • יוצרים אשכול AlloyDB: alloydb.cluster.create
  • יצירת משתמש ב-AlloyDB: alloydb.users.create
  • שיבוט של מכונת AlloyDB: alloydb.instances.create
  • הפעלת שאילתות SQL במכונת AlloyDB:
    • alloydb.instances.executeSql
    • alloydb.instances.login
  • הפעלת שאילתות SQL לקריאה בלבד במכונת AlloyDB:
    • alloydb.instances.executeSqlReadOnly
    • alloydb.instances.login
  • קבלת אשכול AlloyDB: alloydb.instances.get
  • קבלת פעולה באשכול AlloyDB: alloydb.clusters.get
  • ייבוא נתונים לאשכול AlloyDB: alloydb.clusters.import
  • ייצוא נתונים מאשכול AlloyDB ל-Cloud Storage: alloydb.clusters.export
  • הצגת רשימת אשכולות AlloyDB בפרויקט: alloydb.clusters.list
  • רשימת משתמשי AlloyDB: alloydb.users.list
  • עדכון של אשכול AlloyDB: alloydb.clusters.update
  • עדכון משתמש ב-AlloyDB: alloydb.users.update

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

אימות והרשאה

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

שרת ה-MCP המרוחק של AlloyDB לא מקבל מפתחות API.

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

היקפי הרשאות OAuth ב-AlloyDB MCP

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

ל-AlloyDB יש את היקפי ה-OAuth הבאים של כלי MCP:

URI של היקף ל-CLI של gcloud תיאור
https://www.googleapis.com/auth/alloydb הצגה, עריכה, הגדרה ומחיקה של הנתונים שלך ב- Google Cloud AlloyDB והצגה של כתובת האימייל של החשבון שלך ב-Google.

יכול להיות שיידרשו היקפי הרשאות נוספים במשאבים שאליהם ניגשים במהלך הפעלת כלי. כדי לראות רשימה של היקפי ההרשאות שנדרשים ל-AlloyDB, אפשר לעיין במאמר בנושא AlloyDB Admin API.

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

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

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

  • שם השרת: שרת MCP של AlloyDB ל-PostgreSQL
  • כתובת ה-URL של השרת או נקודת הקצה: https://alloydb.googleapis.com/mcp
  • העברה: Streamable HTTP
  • פרטי אימות: בהתאם לשיטת האימות שרוצים להשתמש בה, אפשר להזין את Google Cloud פרטי הכניסה, מזהה לקוח וסוד לקוח של OAuth, או זהות ופרטי כניסה של סוכן. מידע נוסף על אימות זמין במאמר אימות לשרתי MCP.
  • היקף הרשאות OAuth: היקף ההרשאות של OAuth 2.0 שבו רוצים להשתמש כשמתחברים לשרת MCP של AlloyDB ל-PostgreSQL.

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

הנחיות כלליות נוספות זמינות במקורות המידע הבאים:

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

כדי לראות פרטים על כלי MCP זמינים ותיאורים שלהם עבור שרת MCP של AlloyDB ל-PostgreSQL, אפשר לעיין בהפניה ל-MCP של AlloyDB ל-PostgreSQL.

כלים לרשימות

כדי להציג רשימה של כלים, משתמשים בכלי הבדיקה של MCP או שולחים בקשת HTTP‏ tools/list ישירות לשרת MCP מרוחק של AlloyDB ל-PostgreSQL. בשיטה tools/list לא נדרש אימות.

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

הרצת SQL

כדי להריץ הצהרות SQL:

  1. מגדירים את ההגדרה של מופע data_api_access במופע AlloyDB לערך ALLOW_DATA_API_ACCESS. כשיוצרים מכונה באמצעות הכלי create_instance, ההגדרה data_api_access מופעלת באופן אוטומטי.

    אם ההגדרה data_api_access לא מופעלת במופע, אפשר להפעיל אותה באמצעות הפקודה curl כדי לעדכן את הערך של השדה dataApiAccess ל-ENABLED:

    curl -X PATCH \
 -H "Authorization: Bearer $(gcloud auth print-access-token)" \
 -H "Content-Type: application/json" \
 https://alloydb.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/clusters/CLUSTER_ID/instances/INSTANCE_ID?updateMask=dataApiAccess \
 -d '{
   "dataApiAccess": "ENABLED",
 }'

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

    • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
    • ‫LOCATION: האזור שבו נמצא אשכול AlloyDB.
    • ‫CLUSTER_ID: המזהה של אשכול AlloyDB.
    • ‫INSTANCE_ID: המזהה של מופע AlloyDB.

  2. ב-Gemini CLI, מזינים פרומפט שדומה לפרומפט הבא:

    מפעילים אימות IAM במסד הנתונים במכונת AlloyDB INSTANCE_NAME מוודאים שהצהרות ה-SQL משתמשות בהרשאות שמשויכות לחשבון המשתמש של אימות IAM במסד הנתונים USER_ACCOUNT

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

    • ‫INSTANCE_NAME: השם של מופע AlloyDB.
    • ‫USER_ACCOUNT: חשבון המשתמש ב-IAM שמשמש לאימות כשמריצים הצהרות SQL.

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

הנה כמה תרחישי שימוש לדוגמה בשרת AlloyDB MCP.

פיתוח אפליקציות לאינטרנט

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

פרומפט לדוגמה:

‫"Create a new alloydb PostgreSQL development instance and set up a table called products".

תהליך העבודה: תהליך העבודה להגדרת אפליקציית אינטרנט יכול להיראות כך:

  • הקצאת משאבים: הסוכן יוצר אשכול שאפשר להקצות בו את המופע. לאחר מכן, הסוכן קורא לכלי create_instance כדי ליצור מופע חדש של AlloyDB עם מפרטים בגודל של סביבת פיתוח. אפשר להפעיל קישוריות של כתובת IP ציבורית במכונה החדשה. אפשר גם להגדיר אוטומטית נקודות קצה של Private Service Connect.

  • אימות: הסוכן משתמש בכלי get_operation כדי לדגום את הסטטוס של פעולת יצירת המופע.

  • חיבור: בסיום הפעולה, הסוכן משתמש בכלי get_instance כדי לאחזר את המטא-נתונים של חיבור המופע.

  • הגדרת סכימה: הסוכן יוצר את מסד הנתונים ואז משתמש ב-execute_sql כדי להריץ את משפט ה-SQL‏ CREATE TABLE products.

  • הזנת נתונים ראשוניים: הסוכן משתמש שוב ב-execute_sql כדי להוסיף נתונים ראשוניים (DML) לטבלה החדשה שנוצרה.

ניהול תפעולי וניהול הגדרות של מסדי נתונים

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

פרומפט לדוגמה:

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

תהליך העבודה: תהליך העבודה לבדיקת ההגדרה של מופע AlloyDB ושל משתמש מסד הנתונים יכול להיראות כך.

  • גילוי: הסוכן משתמש ב-list_instances כדי לאחזר רשימה של כל מופעי AlloyDB בפרויקט.

  • בדיקה: לכל מופע מזוהה, הסוכן קורא ל-get_instance כדי לאחזר מטא-נתונים מפורטים של ההגדרה, כמו גרסת מסד הנתונים, האזור וסוג המכונה, וקורא ל-list_users כדי לבדוק את משתמשי מסד הנתונים במופע. המטא-נתונים האלה כוללים מידע על כך שקישוריות של כתובת IP ציבורית מופעלת או שנקודות קצה (endpoints) של Private Service Connect מוגדרות.

  • דיווח: הסוכן מסכם את הממצאים ומדגיש מקרים או משתמשים שחורגים מההגדרה הצפויה.

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

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

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

שימוש בהגנה מוגברת על המודל

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

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

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

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

הפעלת הגנה מוגברת על המודל

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

המסוף

  1. מפעילים את הגנה מוגברת על המודל API, אם הוא עדיין לא מופעל.

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

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

    להפעלת ה-API

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

gcloud

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

  1. במסוף Google Cloud , מפעילים את Cloud Shell.

    הפעלת Cloud Shell

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

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

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

הגדרת הגנה לשרתי 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: רמת המהימנות של ההגדרות של המסנן 'AI אחראי – מסוכן'. אפשר לשנות את ההגדרה הזו, אבל ערכים נמוכים יותר עלולים להוביל ליותר תוצאות חיוביות כוזבות. מידע נוסף זמין במאמר בנושא רמות הסמך של Model Armor.

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

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

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

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

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

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

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

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

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