שימוש בשרת MCP של Cloud Storage

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

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

אלה כמה סיבות אפשריות לשימוש בשרת MCP מקומי של Cloud Storage:

• אתם צריכים ליצור כלי בהתאמה אישית.
• אין לכם הרשאות להפעיל את שרת ה-MCP או להשתמש בו בפרויקט.

במאמר איך מחברים מודלים גדולים של שפה (LLM) ל-Cloud Storage באמצעות MCP מוסבר איך משתמשים בשרת MCP מקומי.

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

במאמר הזה מוסבר איך להשתמש בשרת Cloud Storage MCP כדי להתחבר ל-Cloud Storage מאפליקציות AI כמו Gemini CLI, מצב סוכן ב-Gemini Code Assist, ‏Claude Code או באפליקציות AI שאתם מפתחים.

באמצעות שרת ה-MCP של Cloud Storage, אתם יכולים להשתמש באפליקציות ובסוכני AI כדי לבצע את המשימות הבאות:

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

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

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

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

מגבלות

לשרת ה-MCP של Cloud Storage יש את המגבלות הבאות:

• סוגי קבצים: פעולות קריאה תומכות בקובצי טקסט ובקובצים בינאריים (כמו קובצי PDF, תמונות, אודיו וסרטונים). פעולות כתיבה מוגבלות לקובצי טקסט.

• גודל הקובץ: עד 8MiB לפעולות קריאה וכתיבה.

• נקודת קצה: נקודת קצה גלובלית בלבד.

למידע מפורט על המכסות והמגבלות שחלות על שרת ה-MCP של Cloud Storage, ראו מכסות ומגבלות.

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

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

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

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.

Install the Google Cloud CLI.

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

To initialize the gcloud CLI, run the following command:

gcloud init

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

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.

Install the Google Cloud CLI.

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

To initialize the gcloud CLI, run the following command:

gcloud init

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

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

• ביצוע קריאות לכלי MCP: משתמש בכלי MCP (roles/mcp.toolUser)
• הצגת אובייקטים, קריאת אובייקטים והתוכן שלהם או אחזור מטא-נתונים של אובייקט: צפייה באובייקטים של אחסון (roles/storage.objectViewer)
• כתיבת תוכן לאובייקט: יצירת אובייקטים באחסון (roles/storage.objectCreator)
• מחיקת אובייקטים: משתמש באובייקטים באחסון (roles/storage.objectUser) או אדמין של אובייקטים באחסון (roles/storage.objectAdmin)
• יצירה, הצגה או מחיקה של קטגוריות: אדמין של Storage ‏ (roles/storage.admin)

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

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

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

אימות והרשאה

שרת ה-MCP של Cloud Storage לא מקבל מפתחות API לאימות, כי כל הבקשות דורשות הרשאה של ניהול זהויות והרשאות גישה (IAM).

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

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

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

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

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

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

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

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

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

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

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

• להתחבר לשרתי MCP מרוחקים.
• הגדרת MCP באפליקציית AI.

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

בחומר העזר בנושא שרת ה-MCP של Cloud Storage מפורטים הכלים הזמינים ב-MCP ותיאורים שלהם. סכימות ודוגמאות זמינות במאגר של Cloud Storage MCP ב-GitHub.

כלים לרשימות

כדי להציג רשימה של כלים, אפשר להשתמש בכלי הבדיקה של MCP או לשלוח בקשת HTTP‏ tools/list ישירות לשרת MCP המרוחק של Cloud Storage. השיטה tools/list לא דורשת אימות.

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

קריאה לכלי

כדי להפעיל כלי ספציפי, משתמשים ב-method‏ tools/call ומציינים את שם הכלי והארגומנטים הנדרשים באובייקט params. בדוגמה הבאה מוסבר איך להפעיל את הכלי list_buckets בפרויקט my-project:

POST /storage/mcp HTTP/1.1
Host: storage.googleapis.com
Content-Type: application/json
Authorization: Bearer OAUTH2_TOKEN

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "params": {
    "name": "list_buckets",
    "arguments": {
      "projectId": "my-project"
    }
  }
}

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

ריכזנו כאן כמה דוגמאות לתרחישי שימוש בשרת ה-MCP של Cloud Storage.

ניהול תוכן וקמפיינים למוצרי קמעונאות

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

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

"צור כרטיס מוצר למק"ט SKU-123 באמצעות נכסים מהקטגוריה product-images, ואז צור קטגוריה חדשה בשם campaign-q3-assets, צור תמונות באנר ושמור אותן בקטגוריה הזו".

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

• הצגת רשימת נכסים: הסוכן משתמש ב-list_objects כדי למצוא את כל התמונות של המוצר החדש בקטגוריה ייעודית של Cloud Storage.
• אחזור תוכן: הסוכן משתמש ב-read_object כדי לגשת לנכסי מוצר (עד 8MB), וגם מאחזר תיאורי מוצרים ממערכת לניהול מידע על מוצרים (PIM) באמצעות כלי אחר.
• יצירת כרטיס מוצר: הסוכן יוצר טיוטה של כרטיס המוצר, כולל טקסט שיווקי וקישורים לתמונות ולסרטונים.
• יצירת מאגר קמפיינים: הסוכן משתמש ב-create_bucket כדי ליצור מאגר חדש של נכסי קמפיין.
• שמירת נכסי הקמפיין: הסוכן יוצר טקסט שיווקי ומשתמש ב-write_text כדי לשמור אותו בדלי החדש 'קמפיינים'. הגודל של העותק צריך להיות פחות מ-8MB.

ניתוח נתונים פיננסיים

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

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

"מה היו הנקודות העיקריות בשיחת הוועידה האחרונה של ExampleCorp בנושא תוצאות כספיות, ואיך הן בהשוואה למה שנאמר בשלושת הדוחות הכספיים האחרונים שלה?"

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

• זיהוי מסמכים: הסוכן מחלץ מילות מפתח מהשאלה של המשתמש כדי לזהות קטגוריות או קידומות רלוונטיות, למשל earnings-calls/ExampleCorp/ או financial-reports/ExampleCorp/, ומשתמש ב-list_objects כדי למצוא תמלילי אודיו ודוחות פיננסיים רלוונטיים.
• הורדת תוכן: הסוכן משתמש ב-read_object כדי להוריד את התוכן של הקבצים שזוהו, עד 8MiB לכל קובץ.
• ניתוח ותגובה: הסוכן מעביר את התוכן ל-LLM כדי לסכם את הממצאים, להשוות את הסנטימנט ולסנתז תשובה לשאלה של המשתמש. במקרה הצורך, אפשר להשתמש בכלים אחרים כמו BigQuery כדי לבצע ניתוח מעמיק יותר.

הערכת הסיכון של הספק

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

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

"העריכו את הספק "Example Inc." על ידי בדיקת שאלון האבטחה האחרון שלו ואישור התאימות שלו בקטגוריה vendor-docs. סכם את כל הסיכונים האפשריים על סמך המדיניות שלנו ושמור את הדוח".

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

• חיפוש מסמכים: הסוכן משתמש בכלי list_objects כדי למצוא את התיקייה של הספק בקטגוריה של Cloud Storage שמוקדשת למסמכים של הספק.
• הורדת מסמכים: הסוכן משתמש ב-read_object כדי להוריד את כל המסמכים הרלוונטיים, כמו שאלונים בנושא אבטחה, אישורי תאימות ודוחות כספיים, עד 8MiB לכל קובץ.
• ניתוח מסמכים: הסוכן מנתח את התוכן של המסמכים האלה, יכול להיות שהוא משתמש בכלים אחרים כדי לחלץ טקסט, לחפש סימני אזהרה או מידע חסר על סמך מדיניות הסיכון של הבנק.
• יצירה ושמירה של דוח: הנציג יוצר דוח סיכום של הממצאים שלו ומשתמש ב-write_text כדי לשמור אותו בתיקייה של הספק ב-Cloud Storage, כדי שמעריך הסיכונים יוכל לבדוק אותו.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• מאמרי העזרה של Cloud Storage MCP
• מידע נוסף על שרתי MCP של Google Cloud