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

במאמר הזה מוסבר איך להשתמש בשרת Model Context Protocol‏ (MCP) מרוחק של Spanner כדי להתחבר לאפליקציות מבוססות-AI, כולל Antigravity, ‏ ChatGPT, ‏ Claude ואפליקציות בהתאמה אישית שאתם מפתחים. שרת ה-MCP של Spanner מאפשר לכם לגשת לכלים של Spanner ולהריץ אותם כדי ליצור, לנהל ולשלוח שאילתות למשאבי Spanner מסביבות הפיתוח מבוססות-AI ומפלטפורמות סוכני ה-AI שלכם. שרת ה-MCP המרוחק של Spanner מופעל כשמפעילים את Spanner 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 המקומי של Spanner זמין במאמר MCP Toolbox for Databases.

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

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

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

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

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

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

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

  3. מפעילים את Spanner API, אם הוא עדיין לא מופעל.

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

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

    להפעלת ה-API

    בפרויקטים חדשים, Spanner API מופעל באופן אוטומטי.

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

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

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

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

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

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

  • להפעיל קריאות API לכלי MCP: mcp.tools.call
  • שימוש בכלי MCP של Spanner:
    • spanner.instances.create
    • spanner.instances.get
    • spanner.databases.create
    • spanner.databases.update
    • spanner.sessions.create
    • spanner.instanceOperations.get
    • spanner.databases.getDdl
    • spanner.databases.select
    • spanner.databases.write

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

אימות והרשאה

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

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

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

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

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

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

URI של היקף ההרשאות ל-CLI של gcloud תיאור
https://www.googleapis.com/auth/spanner.admin מאפשרת גישה לניהול המכונות ומסדי הנתונים שלכם ב-Spanner.
https://www.googleapis.com/auth/spanner.data מאפשרת גישה לצפייה בנתונים במסד נתונים של Spanner ולניהול שלהם.

מידע נוסף על היקפי ההרשאות האלה זמין במאמר Spanner API.

להגדיר לקוח MCP כך שישתמש בשרת MCP של Spanner

תוכנות מארחות, כמו Claude או Gemini CLI, יכולות ליצור לקוחות MCP שמתחברים לשרת MCP יחיד. לתוכנה מארחת יכולים להיות כמה לקוחות שמתחברים לשרתי MCP שונים. כדי להתחבר לשרת MCP מרוחק, לקוח ה-MCP צריך לדעת לפחות את כתובת ה-URL של שרת ה-MCP המרוחק.

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

Gemini CLI

כדי להוסיף שרת MCP מרוחק של Spanner ל-Gemini CLI, צריך להגדיר אותו כתוסף.

  1. יוצרים קובץ תוסף במיקום הבא: ~/.gemini/extensions/EXT_NAME/gemini-extension.json כאשר ~/ היא ספריית הבית ו-EXT_NAME הוא השם שרוצים לתת לתוסף.

  2. מוסיפים את התוכן הבא לקובץ התוסף:

            {
          "name": "EXT_NAME",
          "version": "1.0.0",
          "mcpServers": {
            "Spanner MCP Server": {
              "httpUrl": "https://spanner.googleapis.com/mcp",
              "authProviderType": "google_credentials",
              "oauth": {
                "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
              },
              "timeout": 30000,
              "headers": {
                "x-goog-user-project": "PROJECT_ID"
              }
            }
          }
        }

  3. שומרים את קובץ התוספים.

  4. מפעילים את Gemini CLI:

            gemini

  5. מריצים את /mcp ב-CLI כדי לראות את שרת ה-MCP שהוגדר ואת הכלים שלו.

    התגובה אמורה להיראות כך:

            Configured MCP servers:
        🟢 Spanner MCP Server (from spanner )
          - get_database_ddl
          - get_instance
          - get_operation
          - create_database
          - create_instance
          - create_session
          - commit
          - execute_sql
          - list_databases
          - list_instances

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

Claude.ai

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

כדי להוסיף שרת MCP מרוחק של Spanner ל-Claude.ai, מגדירים מחבר בהתאמה אישית עם מזהה לקוח וסוד לקוח ב-OAuth:

יצירת מזהה לקוח וסוד ב-OAuth 2.0

  1. במסוף Google Cloud , נכנסים אל Google Auth Platform > Clients > Create client.

    כניסה לדף Create client

    אם לא בחרתם פרויקט, תתבקשו ליצור פרויקט.

  2. ברשימה Application type, בוחרים באפשרות אפליקציית אינטרנט.

  3. בשדה Name, מזינים שם לאפליקציה.

  4. בקטע Authorized redirect URIs, לוחצים על ‎+ Add URI ומוסיפים את https://claude.ai/api/mcp/auth_callback בשדה URIs.

  5. לוחצים על יצירה. הלקוח נוצר. כדי לגשת למזהה הלקוח, במסוף Google Cloud , נכנסים אל Google Auth Platform > Clients.

  6. ברשימה מזהי לקוח ב-OAuth 2.0, בוחרים את שם הלקוח.

  7. בקטע סודות לקוח, מעתיקים את סוד לקוח ושומרים אותו במקום מאובטח. אפשר להעתיק אותו רק פעם אחת. אם מאבדים אותו, צריך למחוק את הסוד וליצור סוד חדש.

יצירת מחבר בהתאמה אישית ב-Claude.ai

  1. ב-Claude.ai, עוברים להגדרות של המחברים בתוכנית שלכם:

    • בתוכנית Enterprise או Team, עוברים אל Admin settings > Connectors.
    • בתוכנית Pro או Max, עוברים אל הגדרות > מחברים.

  2. לוחצים על הוספת מחבר בהתאמה אישית.

  3. בתיבת הדו-שיח הוספת מחבר בהתאמה אישית, מזינים את הפרטים הבאים:

    • שם השרת: שם קריא לאנשים של השרת.
    • כתובת ה-URL של שרת ה-MCP המרוחק: https://spanner.googleapis.com/mcp

  4. מרחיבים את התפריט הגדרות מתקדמות ומזינים את הפרטים הבאים:

    • מזהה לקוח OAuth: מזהה הלקוח ב-OAuth 2.0 שיצרתם.
    • סוד לקוח OAuth (בתוכניות Pro ו-Max בלבד): הסוד של לקוח OAuth 2.0. כדי לאחזר את הסוד, עוברים אל Google Auth Platform > Clients ובוחרים את מזהה הלקוח ב-OAuth שיצרתם. בקטע Client secrets, לוחצים כדי להעתיק את Client secret.

  5. לוחצים על הוספה.

    המחבר בהתאמה אישית נוצר.

  6. פותחים את התפריט כלים ומפעילים את המחבר.

    ‫Claude.ai יכול להשתמש בשרת ה-MCP.

ChatGPT

כדי להשתמש בשרתי MCP של Google ו-Spanner עם ChatGPT, צריך מינוי ל-ChatGPT Business.

כדי להוסיף שרת MCP מרוחק של Spanner ל-ChatGPT, יוצרים מזהה לקוח וסוד לקוח של Google OAuth 2.0, ואז מוסיפים את שרת ה-MCP כאפליקציה ב-ChatGPT.

יצירת מזהה לקוח וסוד ב-OAuth 2.0

  1. במסוף Google Cloud , נכנסים אל Google Auth Platform > Clients > Create client.

    כניסה לדף Create client

    אם לא בחרתם פרויקט, תתבקשו ליצור פרויקט.

  2. ברשימה Application type, בוחרים באפשרות אפליקציית אינטרנט.

  3. בשדה Name, מזינים שם לאפליקציה.

  4. בקטע Authorized JavaScript origins, לוחצים על ‎+ Add URI ומוסיפים את https://chatgpt.com בשדה URIs.

  5. בקטע Authorized redirect URIs, לוחצים על ‎+ Add URI ומוסיפים את https://chatgpt.com/connector_platform_oauth_redirect בשדה URIs.

  6. לוחצים על יצירה. הלקוח נוצר. כדי לגשת למזהה הלקוח, במסוף Google Cloud , נכנסים אל Google Auth Platform > Clients.

  7. ברשימה מזהי לקוח ב-OAuth 2.0, בוחרים את שם הלקוח.

  8. בקטע Client secrets, מעתיקים את Client secret ושומרים אותו במקום מאובטח. אפשר להעתיק אותו רק פעם אחת. אם מאבדים אותו, צריך למחוק את הסוד וליצור סוד חדש.

מוסיפים את שרת ה-MCP כאפליקציה ב-ChatGPT

  1. נכנסים לחשבון ב-ChatGPT.
  2. מפעילים את מצב פיתוח:
    1. ב-ChatGPT, לוחצים על שם המשתמש כדי לפתוח את תפריט הפרופיל, ואז בוחרים באפשרות הגדרות.
    2. בתפריט ההגדרות, לוחצים על אפליקציות ואז על הגדרות מתקדמות.
    3. ב-Advanced settings, מעבירים את המתג מצב פיתוח למצב מופעל.
  3. בקטע הגדרות > אפליקציות, לוחצים על הכפתור יצירת אפליקציה.
  4. בתיבת הדו-שיח New app, מזינים את הפרטים הבאים:
    • שם: השם של שרת ה-MCP.
    • תיאור: תיאור אופציונלי של שרת ה-MCP.
    • כתובת ה-URL של שרת ה-MCP: https://spanner.googleapis.com/mcp
    • אימות:
      • בתפריט Authentication, בוחרים באפשרות OAuth.
      • בשדה OAuth client ID, מזינים את מזהה הלקוח ב-Google OAuth.
      • בשדה OAuth secret, מזינים את סוד הלקוח של Google OAuth.
    • מאשרים שמבינים את הסיכון שקשור לשימוש בשרת MCP ולוחצים על יצירה.

שרת ה-MCP מופיע בתפריט אפליקציות, ואפשר להשתמש בו באמצעות הנחיות בצ'אט.

הנחיות כלליות ללקוחות MCP

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

לשרת MCP מרוחק של Spanner, מזינים את הפרטים הבאים:

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

‫URI של הפניה אוטומטית

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

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

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

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

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

כלים לרשימות

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

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

ניראות (observability)

שרת ה-MCP של Spanner תומך בכלים לבדיקה פנימית ולניטור של Spanner.

תגי בקשה

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

שם הכלי תג הבקשה
execute_sql mcp_execute_sql
execute_sql_readonly mcp_execute_sql_readonly
commit mcp_commit

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

הנה כמה דוגמאות לתרחישים לדוגמה של שרת Spanner MCP.

פיתוח אפליקציות באמצעות Spanner

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

הנחיה לדוגמה: "צור מכונה אזורית של Spanner בפרויקט PROJECT_ID בהגדרת המכונה האזורית us-central1. צור מסד נתונים למעקב אחר מלאי והוסף 5 מוצרים לדוגמה".

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

תהליך עבודה:

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

  • הנציג מפעיל את הכלי create_instance כדי להקצות מכונה חדשה של Spanner באמצעות הגדרת המכונה שצוינה. יכול להיות שה-agent יפעיל את הכלי get_operation כדי לבדוק אם המכונה מוכנה לשימוש.

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

  • הנציג יכול להשתמש בשילוב של הכלים create_session,‏ execute_sql ו-commit כדי להוסיף נתונים לדוגמה.

  • אם רוצים, הנציג יכול להפעיל את הכלי execute_sql כדי לשלוח שאילתה ולאמת את יצירת הנתונים לדוגמה.

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

אדמינים של Spanner יכולים להשתמש בשרת ה-MCP של Spanner כדי לאסוף מידע על מכונות ומסדי נתונים של Spanner באמצעות כלים כמו list_instances,‏ get_instance,‏ list_databases ו-get_database_ddl.

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

  • "הצגת רשימה של כל המכונות של Spanner בפרויקט הנוכחי".
  • "הצגת רשימה של כל מסדי הנתונים במכונה הנוכחית של Spanner".
  • "Show the schema for the current Spanner database."

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

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

המסוף

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

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