ניהול של שרתי MCP וכלים

בעזרת Agent Registry אתם יכולים לבדוק, לעדכן ולהסיר שרתים וכלים רשומים של Model Context Protocol‏ (MCP), כדי שלסוכנים יהיו סכימות ונקודות קצה מדויקות של הכלים בזמן הריצה. אתם יכולים לגלות שרתי MCP שנרשמו באופן אוטומטי וידני, לעדכן הגדרות של כלים שנרשמו באופן ידני ולהסיר שרתי MCP שכבר לא בשימוש.

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

1. הגדרת Agent Registry.

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

3. לרשום שרתי MCP ב-Agent Registry.

4. כדי להשתמש בפקודות של Google Cloud CLI שמופיעות במאמר הזה, צריך להגדיר את סביבת ה-CLI של gcloud.

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

כדי לקבל את ההרשאות שדרושות לניהול שרתי MCP וכלים ב-Agent Registry, בקשו מהאדמין להקצות לכם את תפקידי ה-IAM הבאים בפרויקט הפיקוח שבו Agent Registry מופעל:

• לראות אילו שרתי וכלים של MCP זמינים: צפייה ב-Agent Registry API (roles/agentregistry.viewer)
• עדכון הגדרות הכלים: עורך Agent Registry API (roles/agentregistry.editor)

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

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

חיפוש שרתי MCP וכלים זמינים

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

הצגת רשימה של כל שרתי ה-MCP הזמינים

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

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

כדי להציג את כל שרתי ה-MCP בסביבה שלכם:

המסוף

1. במסוף Google Cloud , נכנסים לדף Agent Registry:

   כניסה ל-Agent Registry

2. בכלי לבחירת פרויקטים, בוחרים את הפרויקט ב- Google Cloud שבו הגדרתם את Agent Registry.

3. לוחצים על הכרטיסייה שרתי MCP.

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

4. כדי לראות את הפרטים המלאים של שרת, לוחצים על שם השרת.

gcloud

כדי להציג את כל שרתי ה-MCP במיקום מסוים, מריצים את הפקודה gcloud agent-registry mcp-servers list:

gcloud agent-registry mcp-servers list \
    --project=PROJECT_ID \
    --location=REGION

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

• ‫PROJECT_ID: מזהה הפרויקט. אם הגדרתם גבול ניהול, ציינו את המזהה של פרויקט הניהול כדי להציג את שרתי ה-MCP במיקום שצוין בכל הפרויקטים החברים בגבול. כל שם משאב שמוחזר שומר על המזהה של שרת ה-MCP ומשתמש בפרויקט שצוין בבקשה.
• ‫REGION: המיקום של המאגר, למשל us-central1,‏ eu או global. בפרויקט ניהול, ציון מיקום צובר שרתי MCP באותו מיקום בכל הפרויקטים החברים בגבול.

סינון שרתי MCP רשומים

אם יש לכם כמה שרתים, או אם אתם רוצים לאשר את הרישום של שרת ספציפי, אתם יכולים לסנן את הרשימה לפי המטא-נתונים של השרת:

המסוף

1. במסוף Google Cloud , נכנסים לדף Agent Registry:

   כניסה ל-Agent Registry

2. בכלי לבחירת פרויקטים, בוחרים את הפרויקט ב- Google Cloud שבו הגדרתם את Agent Registry.

3. לוחצים על הכרטיסייה שרתי MCP.

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

4. כדי לסנן לפי מיקום, לוחצים על התפריט Location, בוחרים את המיקומים שרוצים לסנן ולוחצים על Apply.

   בדף מוצגת רשימה מסוננת של שרתי ה-MCP הרשומים לפי התנאים שבחרתם.

gcloud

כדי לסנן את הרשימה כך שתחזיר רק משאבים שתואמים למטא-נתונים ספציפיים, מעבירים את הדגל --filter לפקודה gcloud agent-registry mcp-servers list:

gcloud agent-registry mcp-servers list \
    --project=PROJECT_ID \
    --location=REGION \
    --filter="FILTER_EXPRESSION"

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

• ‫PROJECT_ID: מזהה הפרויקט.
• ‫REGION: האזור של המרשם.
• ‫FILTER_EXPRESSION: ביטוי הסינון של שרתי ה-MCP שרוצים לסנן. לדוגמה, אפשר להשתמש במסננים הבאים:
  • כדי לסנן לפי השם המוצג, משתמשים ב-displayName='DISPLAY_NAME'.
  • כדי לחפש לפי המזהה הייחודי הגלובלי של שרת ה-MCP (URN), משתמשים ב-mcpServerId='urn:mcp:SERVER_URN'.
  • כדי לסנן לפי פרויקט חבר ספציפי כששולחים שאילתה לפרויקט ניהול, משתמשים ב-project_id=MEMBER_PROJECT_ID.

Terraform

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

data "google_agent_registry_mcp_server" "filtered_mcp_server" {
  location = "REGION"
  filter   = "displayName=\"DISPLAY_NAME\""
}

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

• ‫REGION: האזור של המרשם.
• ‫DISPLAY_NAME: השם הקריא לאנשים של שרת ה-MCP שלפיו רוצים לסנן, לדוגמה Custom MCP Server.

איך רואים את הפרטים של שרת MCP

לראות פרטים משרת MCP ספציפי, למשל הכלים שלו:

המסוף

1. במסוף Google Cloud , נכנסים לדף Agent Registry:

   כניסה ל-Agent Registry

2. בכלי לבחירת פרויקטים, בוחרים את הפרויקט ב- Google Cloud שבו הגדרתם את Agent Registry.

3. לוחצים על הכרטיסייה שרתי MCP.

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

4. לוחצים על השם של שרת ה-MCP שרוצים לראות.

   דף הפרטים כולל כרטיסיות עם פרטי שרת ה-MCP.

5. לוחצים על הכרטיסייה המתאימה כדי לראות את הפרטים הספציפיים של שרת ה-MCP:

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

gcloud

כדי לראות את המטא-נתונים המפורטים של שרת MCP ספציפי, מריצים את הפקודה gcloud agent-registry mcp-servers describe:

gcloud agent-registry mcp-servers describe SERVER_NAME \
    --project=PROJECT_ID \
    --location=REGION

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

• ‫SERVER_NAME: השם של שרת ה-MCP, לדוגמה custom-mcp-server.
• ‫PROJECT_ID: מזהה הפרויקט. בגבול ניהול, אתם יכולים לציין את מזהה פרויקט הניהול או את המזהה של הפרויקט החבר שבו השרת נפרס. שם המשאב שמוחזר שומר על המזהה של שרת ה-MCP ומשתמש בפרויקט שצוין בבקשה.
• ‫REGION: האזור של המרשם.

Terraform

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

data "google_agent_registry_mcp_server" "my_mcp_server" {
  location      = "REGION"
  mcp_server_id = "SERVER_NAME"
}

output "server_create_time" {
  description = "The timestamp when the MCP server was registered."
  value       = data.google_agent_registry_mcp_server.my_mcp_server.create_time
}

output "server_update_time" {
  description = "The timestamp when the MCP server was last updated."
  value       = data.google_agent_registry_mcp_server.my_mcp_server.update_time
}

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

• ‫REGION: האזור של המרשם.
• ‫SERVER_NAME: המזהה הייחודי של שרת ה-MCP, לדוגמה custom-mcp-server.

עדכון פרטי השרת והגדרות הכלים

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

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

המסוף

מעדכנים את פרטי השרת הזמינים במסוף Google Cloud :

1. במסוף Google Cloud , נכנסים לדף Agent Registry:

   כניסה ל-Agent Registry

2. בכלי לבחירת פרויקטים, בוחרים את הפרויקט ב- Google Cloud שבו הגדרתם את Agent Registry.

3. לוחצים על הכרטיסייה שרתי MCP.

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

4. לוחצים על השם של השרת שרוצים לעדכן.

5. בכרטיסייה Overview של השרת, לוחצים על Edit.

6. בחלונית Edit service, מזינים את הפרטים המעודכנים של השרת, כמו השם או התיאור החדשים שלו.

7. לוחצים על Save.

gcloud

מכינים את המפרט של הכלי החדש. לאחר מכן, מריצים את הפקודה gcloud agent-registry services update עם קובץ ה-JSON המעודכן:

gcloud agent-registry services update SERVER_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --mcp-server-spec-content=TOOL_SPEC

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

• ‫SERVER_NAME: השם של שרת ה-MCP, לדוגמה custom-mcp-server.
• ‫PROJECT_ID: מזהה הפרויקט.
• ‫REGION: האזור של המרשם.
• ‫TOOL_SPEC: הנתיב לקובץ החדש של מפרט הכלי, לדוגמה new-toolspec.json. גודל הקובץ המקסימלי של קובץ המפרט הוא 10KB.

Terraform

כדי לעדכן את המטא-נתונים, את כתובת ה-URL של נקודת הקצה או את מפרט הכלים של שרת ה-MCP הרשום, משנים את הפרמטרים של המשאב google_agent_registry_service הקיים בהגדרות, ואז מריצים את הפקודה terraform apply:

resource "google_agent_registry_service" "mcp_server" {
  location     = "REGION"
  service_id   = "SERVER_NAME"
  display_name = "DISPLAY_NAME"
  description  = "Updated description of the MCP server."

  interfaces {
    url              = "SERVER_URL"
    protocol_binding = "JSONRPC"
  }

  mcp_server_spec {
    type    = "TOOL_SPEC"
    content = file("TOOL_SPEC")
  }
}

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

• ‫REGION: האזור של המרשם.
• ‫SERVER_NAME: השם של שרת ה-MCP, לדוגמה custom-mcp-server.
• ‫DISPLAY_NAME: השם המוצג של שרת ה-MCP, לדוגמה Custom MCP Server.
• ‫SERVER_URL: כתובת ה-URL של נקודת הקצה של שרת ה-MCP, לדוגמה https://api.example.com/mcp.
• ‫TOOL_SPEC: הנתיב לקובץ המפרט המעודכן של הכלי, לדוגמה new-toolspec.json. גודל הקובץ המקסימלי של קובץ המפרט הוא 10KB.

הסרת שרת MCP

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

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

המסוף

1. במסוף Google Cloud , נכנסים לדף Agent Registry:

   כניסה ל-Agent Registry

2. בכלי לבחירת פרויקטים, בוחרים את הפרויקט ב- Google Cloud שבו הגדרתם את Agent Registry.

3. לוחצים על הכרטיסייה שרתי MCP.

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

4. לוחצים על השם של השרת שרוצים להסיר.

5. בכרטיסייה Overview של השרת, לוחצים על Delete.

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

7. לוחצים על Delete.

gcloud

מריצים את הפקודה gcloud agent-registry services delete:

gcloud agent-registry services delete SERVER_NAME \
    --project=PROJECT_ID \
    --location=REGION

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

• ‫SERVER_NAME: השם של שרת ה-MCP שרוצים להסיר, לדוגמה my-mcp-server.
• ‫PROJECT_ID: מזהה הפרויקט.
• ‫REGION: האזור של המרשם.

Terraform

מסירים את המשאב google_agent_registry_service שמייצג את שרת ה-MCP מההגדרות של Terraform, ואז מריצים את הפקודה terraform apply.

ניהול הגישה לכלי

הטמעת פיקוח ואבטחה ברמה שמתאימה לארגונים בשרתי MCP ובכלים. השתמשו ב-Agent Registry כמרשם המרכזי שלכם וב-Agent Gateway לאכיפת מדיניות פעילה.

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

למידע נוסף על ניהול הגישה לכלי, קראו את המאמרים הבאים:

• סקירה כללית על כללי המדיניות של ניהול זהויות והרשאות גישה (IAM): מגדירים מי יכול לגשת לכלים ספציפיים ובאילו תנאים.
• סקירה כללית של Agent Gateway: איך השער אוכף את האבטחה ואת יכולת הצפייה בכל האינטראקציות בין הסוכן לכלי (MCP).
• צפייה בממצאי אבטחה: מעקב אחרי תובנות אבטחה ובדיקה שלהן בסביבה של הסוכנים באמצעות Gemini Enterprise Agent Platform.