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

ב-Agent Registry אפשר לגלות ולנהל שרתים של Model Context Protocol‏ (MCP) וכלים ספציפיים שהם חושפים.

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

במאמר הזה מוסבר איך לגלות שרתים וכלים רשומים של MCP ואיך לשנות את הגדרות הכלים.

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

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

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

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

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

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

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

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

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

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

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

המסוף

  1. במסוף Google Cloud , עוברים אל Agent Registry:

    כניסה ל-Agent Registry

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

  3. בוחרים בכרטיסייה שרתי MCP.

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

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

gcloud

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

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

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

  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫REGION: האזור של המאגר.

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

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

המסוף

  1. במסוף Google Cloud , עוברים אל Agent Registry:

    כניסה ל-Agent Registry

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

  3. בוחרים בכרטיסייה שרתי MCP.

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

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

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

gcloud

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

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

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

  • כדי לסנן לפי השם המוצג, משתמשים ב-displayName='DISPLAY_NAME'.
  • כדי לחפש לפי מזהה (URN) ייחודי גלובלי, משתמשים בפונקציה mcpServerId='urn:mcp:SERVER_URN'.

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. בבורר הפרויקטים, בוחרים את הפרויקט שבו הגדרתם את Agent Registry. Google Cloud

  3. בוחרים בכרטיסייה שרתי MCP.

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

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

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

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

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

gcloud

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

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

מחליפים את SERVER_NAME בשם של שרת ה-MCP, לדוגמה, custom-mcp-server.

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 מוסיף כלים חדשים או משנה סכימות קיימות, צריך לעדכן את הרישום כדי שהשינויים האלה יבואו לידי ביטוי. מאחר שהרישום לא בודק אוטומטית את שרתי ה-MCP, צריך להעלות ידנית את מפרט הכלי המעודכן. התוכן שתעלו יחליף את הגדרות הכלים הקיימות בשרת הזה.

ב-Agent Registry API, משתמשים במשאבי McpServer לגילוי. לכן, צריך לעדכן את משאב Service הרשום באופן ישיר.

המסוף

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

  1. במסוף Google Cloud , עוברים אל Agent Registry:

    כניסה ל-Agent Registry

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

  3. בוחרים בכרטיסייה שרתי MCP.

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

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

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

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

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

gcloud

הכנת המפרט של הכלי החדש. לאחר מכן, מעדכנים את קובץ ה-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. גודל הקובץ המקסימלי של קובץ המפרט הוא 10 KB.

Terraform

‫Terraform תומך רק בסוג NO_SPEC לשרתי MCP. אי אפשר להגדיר מפרטים של כלי בשורה. כדי לעדכן את הגדרות הכלים של שרת ה-MCP, צריך להשתמש במסוף Google Cloud , ב-gcloud CLI או ב-Agent Registry API.

הסרת שרת MCP

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

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

המסוף

  1. במסוף Google Cloud , עוברים אל Agent Registry:

    כניסה ל-Agent Registry

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

  3. בוחרים בכרטיסייה שרתי MCP.

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

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

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

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

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

gcloud 

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 לאכיפה פעילה של מדיניות.

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

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