Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

רישום שרתי MCP

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

במאמר הזה מוסבר איך לרשום שרתי MCP ואיך מנהלים את מפרטי הכלים שלהם ב-Agent Registry.

גילוי אוטומטי של שרתי MCP Google Cloud

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

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

רישום שרתי MCP חיצוניים

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

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

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

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

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

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

כדי לקבל את ההרשאות שנדרשות לרישום ידני של שרתי MCP ב-Agent Registry, צריך לבקש מהאדמין להקצות לכם ב-IAM את התפקיד Agent Registry API Editor (roles/agentregistry.editor) בפרויקט. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

הכנת מפרט הכלי

יוצרים קובץ toolspec.json שמתאר את הכלים שהשרת מספק. גודל הקובץ המקסימלי של קובץ המפרט הזה הוא 10 KB.

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

{
  "tools": [
    {
      "name": "get_customer_info",
      "description": "Retrieves customer details from the database.",
      "annotations": {
        "title": "Get Customer Info",
        "readOnlyHint": true,
        "idempotentHint": true
      }
    },
    {
      "name": "create_support_ticket",
      "description": "Creates a new support ticket in the issue tracking system.",
      "annotations": {
        "title": "Create Support Ticket",
        "destructiveHint": true,
        "idempotentHint": false,
        "openWorldHint": true
      }
    }
  ]
}

לדרישות מפורטות בנוגע למבנה, אפשר לעיין בסכימות JSON ובהפניית REST.

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

רישום שרת ה-MCP והעלאת הגדרת הכלי בו-זמנית:

המסוף

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

כניסה ל-Agent Registry
בבורר הפרויקטים, בוחרים את הפרויקט שבו הגדרתם את Agent Registry. Google Cloud
בוחרים בכרטיסייה שרתי MCP.
לוחצים על הוספת שרת MCP.
בחלונית פרטים של שרת MCP, מזינים את השם המוצג, תיאור ואת האזור הגיאוגרפי.
בקטע Tool specification (מפרט הכלי), מזינים את כתובת ה-URL של נקודת הקצה של שרת ה-MCP ומדביקים את התוכן של קובץ toolspec.json.

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

בחלונית Select MCP tools מוצגת רשימת כלים עם שמות ותיאורים משרת ה-MCP.
בוחרים את כל הכלים של MCP שרוצים לכלול. אפשר לסנן את הכלים מהרשימה לפי שם או ערך.
לוחצים על Save.

gcloud

רושמים את שרת ה-MCP במפרט הכלי:

gcloud agent-registry services create SERVER_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --mcp-server-spec-type=tool-spec \
  --mcp-server-spec-content=toolspec.json \
  --interfaces=url=SERVER_URL,protocolBinding=PROTOCOL

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

‫SERVER_NAME: השם שרוצים לתת לשרת ה-MCP, לדוגמה, custom-mcp-server.
‫PROJECT_ID: מזהה הפרויקט.
‫REGION: האזור של המאגר.
‫DISPLAY_NAME: השם שאתם רוצים לתת לשרת, לדוגמה, Custom MCP Server.
‫SERVER_URL: כתובת ה-URL של נקודת הקצה של שרת ה-MCP, לדוגמה, https://api.example.com/mcp.
‫PROTOCOL: פרוטוקול הקישור של נקודת הקצה. הערכים התקינים הם JSONRPC,‏ HTTP_JSON או GRPC. בשרתי MCP, הערך הזה הוא לרוב JSONRPC.

Terraform

כדי לרשום שרת MCP ולציין את הכלים שלו, צריך להגדיר משאב google_agent_registry_service עם בלוק mcp_server_spec:

resource "google_agent_registry_service" "mcp_server" {
  location     = "REGION"
  service_id   = "SERVER_NAME"
  display_name = "DISPLAY_NAME"
  description  = "An external MCP server registered using Terraform."

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

  mcp_server_spec {
    type    = "NO_SPEC"
  }
}

output "server_resource_name" {
  description = "The generated read-only Server resource name."
  value       = google_agent_registry_service.mcp_server.registry_resource
}