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

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

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

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

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

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

מגבלות

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

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

    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.

    Verify that billing is enabled for your Google Cloud 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 המרוחק של Resource Manager משתמש בפרוטוקול OAuth 2.0 עם ניהול זהויות והרשאות גישה (IAM) לאימות ולהרשאה. כל Google Cloud הזהויות נתמכות לאימות בשרתי MCP.

שרת ה-MCP של מנהל המשאבים לא מקבל מפתחות 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 היקף ההרשאות הזה מאפשר לקרוא ולשנות נתונים.

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

הגדרת לקוח MCP לשימוש בשרת MCP של מנהל המשאבים

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

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

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

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

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

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

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

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

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

כלים לרשימות

משתמשים ב-MCP inspector כדי להציג רשימה של כלים, או שולחים בקשת HTTP מסוג tools/list ישירות לשרת ה-MCP המרוחק של Resource Manager. השיטה 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 לגלות ולזהות באופן דינמי את כל הפרויקטים ב- Google Cloud שיש לכם את ההרשאות הנדרשות כדי לגשת אליהם, כדי שהם יוכלו להריץ פקודות בכלים אחרים.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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