שימוש בשרת MCP מרוחק של Resource Manager

במאמר הזה מוסבר איך משתמשים בשרת Model Context Protocol‏ (MCP) מרוחק של Resource Manager כדי להתחבר לאפליקציות מבוססות-AI, כולל Gemini CLI, ‏ ChatGPT, ‏ Claude ואפליקציות בהתאמה אישית שאתם מפתחים. שרת ה-MCP המרוחק של Resource Manager מאפשר לכם לחפש את כל הפרויקטים שיש לכם הרשאות גישה אליהם ולזהות אותם Cloud de Confiance by S3NS , כדי לוודא שיש לכם את המזהים הנכונים לפני שתנסו לבצע הגדרות ספציפיות יותר של משאבים.

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

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

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

שרתי MCP מקומיים
בדרך כלל מריצים אותם במחשב המקומי ומשתמשים בזרמי הקלט והפלט הרגילים (stdio) לתקשורת בין שירותים באותו מכשיר.
שרתי MCP מרוחקים
פועל בתשתית של השירות ומציע נקודת קצה של 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 ושל Cloud de Confiance by S3NS

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

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

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

מגבלות

אתם יכולים להשתמש במדיניות דחייה של IAM כדי לחסום תנועה לשירות Resource Manager ולשרת ה-MCP שלו. עם זאת, אי אפשר להשתמש במאפייני IAM ובהרשאות toolUser שספציפיים ל-MCP כדי להגביל את הגישה לכלי בשרת הזה.

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

    In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance 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.

    Verify that billing is enabled for your Cloud de Confiance project.

    Enable the Cloud Resource Manager 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, and then sign in to the gcloud CLI with your federated identity. After signing in, initialize the Google Cloud CLI by running the following command: 

    gcloud init

אימות והרשאה

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

שרת ה-MCP של Resource Manager לא מקבל מפתחות API לצורך אימות.

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

היקפי ההרשאות של OAuth ב-MCP של Resource Manager

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

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

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

יכול להיות שיידרשו היקפי הרשאות נוספים במשאבים שאליהם ניגשים במהלך הפעלת כלי. רשימת ההיקפים הנדרשים ל-Resource Manager מופיעה במאמר בנושא Resource Manager API.

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

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

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

  • שם השרת: שרת ה-MCP של Resource Manager
  • כתובת URL של השרת או נקודת קצה: https://cloudresourcemanager.googleapis.com/mcp
  • תעבורה: HTTP שניתן להעביר בסטרימינג
  • פרטי אימות: בהתאם לשיטת האימות שאתם רוצים להשתמש בה, אתם יכולים להזין את פרטי הכניסה, את מזהה הלקוח והסוד של לקוח OAuth או את פרטי הכניסה והזהות של הנציג. Cloud de Confiance by S3NS מידע נוסף על אימות זמין במאמר אימות לשרתי MCP.
  • היקף הרשאות OAuth: היקף הרשאות OAuth 2.0 שבו רוצים להשתמש כשמתחברים לשרת ה-MCP של Resource Manager.

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

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

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

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

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

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

כלים לרשימות

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

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

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

הכלי search_projects בשרת ה-MCP המרוחק של מנהל המשאבים מאפשר לסוכני AI לגלות ולזהות באופן דינמי את כל הפרויקטים ב- Cloud de Confiance by S3NS שיש לכם את ההרשאות הנדרשות כדי לגשת אליהם, כדי שהם יוכלו להריץ פקודות בכלים אחרים.

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

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

    הנחיה מהמשתמש: "הצג את כל הפרויקטים הפעילים שלי ב- Cloud de Confiance by S3NS ".

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

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

    פרומפט של משתמש: "תמצא את כל הפרויקטים בתיקייה 223".

    פעולה של הסוכן: הסוכן מפעיל קריאה לכלי עם השאילתה parent:folders/223 כדי להחזיר רשימה של פרויקטים בגבול האדמיניסטרטיבי הזה.

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

    הנחיית משתמש: "תבדוק את הסטטוס של השירות 'payment-processor'".

    פעולת הסוכן: הסוכן מזהה שחסר project_id לכלי Cloud Run. הוא משתמש בכלי search_projects כדי למצוא פרויקטים עם payment בשם, מזהה פרויקטים סבירים (כמו payment-prod-123) ומבקש אישור לפני שממשיך.

  • גילוי פרויקטים לפי סביבה: אתם יכולים למצוא פרויקטים שסוננו לפי סביבות ספציפיות או מבנים ארגוניים ספציפיים בלי לצאת מממשק הצ'אט.

    הנחיית משתמש: "אילו פרויקטים יש לי גישה אליהם בסביבת הבדיקה?"

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

התאמה אישית של התנהגות ה-LLM

הכלי search_projects הוא רב-תכליתי, אבל יכול להיות שמודלי LLM לא תמיד ידעו מתי לשלוח שאילתה להיררכיית Cloud de Confiance by S3NS . כדי להפעיל את הכלי בתרחישים ספציפיים, צריך לספק הקשר מותאם אישית בקובץ Markdown, למשל ~/.gemini/GEMINI.md או AGENTS.md ברמת הפרויקט.

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