סקירה כללית של Model Context Protocol‏ (MCP) ב-Apigee

הדף הזה מתייחס ל-Apigee, אבל לא ל-Apigee Hybrid.

לעיון במסמכי התיעוד של Apigee Edge

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

מה זה MCP?

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

אפליקציות AI יכולות להשתמש ב-MCP כדי לגשת לשירותי Google Cloud ו-Apigee ככלים. בהקשר הזה, כדאי להכיר את המונחים הבאים שקשורים ל-MCP:

  • מארח MCP: אפליקציית ה-AI או הסביבה שמתקשרת עם המשתמש. המארח של MCP משתמש במודלים גדולים של שפה (LLM) כדי לעבד בקשות שעשויות לדרוש נתונים או כלים חיצוניים.
  • לקוח MCP: רכיב בתוך מארח ה-MCP שעוזר למודל ה-LLM ולשרת ה-MCP לתקשר ביניהם. הוא מתרגם את הבקשות של מודל ה-LLM לשרת ה-MCP וממיר את התשובות של שרת ה-MCP למודל ה-LLM. הוא גם מוצא שרתי MCP זמינים ומשתמש בהם.
  • שרת MCP: שירות חיצוני שמספק למודל שפה גדול (LLM) הקשר, נתונים או יכולות, ופועל כשרת proxy בין מודל השפה הגדול לבין לקוח ה-MCP.

איך MCP ב-Apigee עובד

נקודות הקצה של MCP ב-Google,‏ Google Cloudוב-Apigee מיישמות את מפרט שרת ה-MCP. כך לקוחות MCP שעומדים בדרישות יכולים לגשת אליהם כדי:

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

כל לקוח MCP שתומך בנקודות קצה מרוחקות של MCP דרך HTTP/S יכול לגשת לכלים האלה. מכיוון שנקודות הקצה מנוהלות, לא צריך להתקין או לנהל שרתי MCP מקומיים, שרתי MCP מרוחקים או תשתית נוספת כדי לאפשר לאפליקציות מבוססות-סוכנים לגשת לשירותים שלכם.

‫MCP ב-Apigee מציע תמיכה ב-JSON-RPC לשיטות tools/list ו-tools/call. אפשר להתאים אישית את נקודת הקצה של ה-MCP באמצעות פרמטרים של גילוי, אבטחה, זמינות ברשת ויכולת צפייה.

תכונות עיקריות של MCP ב-Apigee

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

מציאת כלים פשוטה יותר באמצעות API Hub

אפשר לגלות נקודות קצה זמינות של MCP לשירותי Apigee באמצעות שירות ספריות שאפשר לגשת אליו דרך ממשק REST. כל נקודת קצה של MCP תומכת גם בשיטת tools/list של MCP, שמאפשרת ללקוחות MCP לגלות את הכלים שזמינים בנקודת הקצה הזו.

בנוסף, MCP משתלב עם Apigee API hub. כשפורסים פרוקסי של MCP Discovery, מרכז ה-API קולט באופן אוטומטי את מפרט ה-OpenAPI שלו, מקצה לו את סגנון ה-API‏ MCP וממפה את פעולות ה-API לכלים נפרדים של MCP. כך מפתחים יכולים לסנן בקלות את ה-API שמופעל באמצעות MCP ב-API Hub ולהשתמש בחיפוש סמנטי עם שאילתות בשפה טבעית כדי למצוא כלים רלוונטיים לאפליקציות מבוססות-סוכנים שלהם.

אבטחה

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

אימות

נקודות הקצה של MCP שמתארחות ב-Apigee תומכות ב-OAuth 2.1 וב-OpenID Connect ‏ (OIDC) לצורך אימות. כך אפשר לוודא שרק סוכנים, לקוחות MCP ומשתמשי קצה עם זהויות מוגדרות יוכלו לגשת לנקודות הקצה של MCP ולהשתמש בכלים של MCP. מטא-נתונים של משאבים מוגנים מאפשרים ללקוחות לגלות את שרתי ההרשאה של OAuth.

מדיניות הרשאות פרטנית

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

ניראות וניתוח נתונים

בנקודות קצה שמארחות Apigee, אפשר להשתמש ב-Apigee Analytics כדי לראות מידע מפורט על השימוש בכלים של MCP. ‫Analytics מאפשר לכם לפלח תנועה ספציפית של MCP מתנועת API רגילה ולצפות במדדים ברמה של כל כלי בנפרד, כמו נפח הבקשות של tools/list (גילוי) לעומת tools/call (ביצוע). מדדי הביצועים גם עוזרים להבחין בין תקורה של שרת proxy לבין זמן התגובה של היעד, וכך מאפשרים לזהות צווארי בקבוק בצורה יעילה יותר.

אמינות ופתרון בעיות

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

שימוש ב-MCP עם Apigee

אתם יכולים לחשוף את ממשקי ה-API הקיימים של Apigee ככלים של MCP ולהפוך אותם לזמינים דרך נקודות הקצה של MCP. אפשר להגדיר את נקודות הקצה האלה ברמת המארח או ברמת קבוצת הסביבות. לדוגמה, אם בארגון cymbal יש שמונה שמות מארחים (למשל, api.cymbal.com, partners.cymbal.com), שכל אחד מהם משויך לקבוצת סביבות שונה, אפשר לארח שרת MCP ייעודי לכל שם מארח.

נקודת קצה מנוהלת (ORG_NAME.mcp.apigee.internal) נפרסת באמצעות פרוקסי ייעודי של MCP Discovery בארגון Apigee, שבו שרתי ה-MCP שלכם זמינים.

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

לקוח/ה שם המארח ונתיב הבסיס של ה-MCP נקודת הקצה של היעד של שרת ה-MCP proxy ל-API סביבה / קבוצת סביבות
מצילה api.cymbal.com/mcp cymbal.mcp.apigee.internal
(פרויקט הדייר של cymbal org)		 mcp-api-proxy1 prod / prod-env-group
api-internal.cymbal.com/mcp cymbal.mcp.apigee.internal
(פרויקט הדייר של cymbal org)		 mcp-api-proxy2 internal / internal-env-group
api-service.cymbal.com/mcp cymbal.mcp.apigee.internal
(פרויקט הדייר של cymbal org)		 mcp-api-proxy3 dev / dev-env-group

מגבלות

המגבלות הבאות חלות על MCP ב-Apigee:

  • מספר הכלים של MCP בארגון Apigee מוגבל ל-1,000.
  • יכול להיות שפריסת התשתית של MCP תהיה כפופה למגבלות קיבולת באזורים הבאים:
    • europe-central2
    • europe-southwest1
    • europe-west9
    • me-central2

    אם מופיעה שגיאה שקשורה לכשל בהקצאת מאזן עומסים, או אם סטטוס ההקצאה לא משתנה ל-Deployed (הופעל), יכול להיות שהסיבה לכך היא מגבלות זמניות על קיבולת התשתית באזור שנבחר. כדאי לנסות לפרוס את ה-proxy בסביבה באזור אחר.

  • ‫MCP ב-Apigee תומך בגרסאות הבאות של OpenAPI: ‏ 3.0.0,‏ 3.0.1,‏ 3.0.2. 3.0.3.
  • אי אפשר להשתמש ב-MCP ב-Apigee עם ארגונים ב-Apigee Hybrid.
  • תובנות לגבי API ב-Apigee API hub לא זמינות עבור ממשקי API וכלי MCP שנפרסו בארגוני Apigee עם VPC-SC מופעל.
  • קריאות GET בתשובות שגיאה של MCP יחזירו שגיאה 405, כי שרת ה-MCP לא תומך כרגע בזרמי אירועים שנשלחים מהשרת (SSE).
  • תובנות לגבי API ב-Apigee API hub לא יציגו ממשקי API בסגנון MCP או תעבורה של משאבי MCP עד שגרסה Apigee 1-17-0-apigee-6 תופעל באופן מלא בכל האזורים הזמינים.
  • אי אפשר לשנות את מאפיין סגנון ה-API ל-MCP עבור משאב API שיש לו פעולות API קיימות.

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