הדף הזה רלוונטי ל-Apigee ול-Apigee Hybrid.
לעיון במסמכי התיעוד של Apigee Edge.
בדף הזה מוסבר איך להשתמש ב-Apigee כדי לחשוף את ממשקי ה-API שלכם ככלי MCP לאפליקציות מבוססות-סוכנים. MCP ב-Apigee זמין לארגונים עם מינוי, עם תשלום לפי שימוש ועם גרסת הערכה, כולל ארגונים עם מיקום אחסון נתונים. החל מגרסה 1.17.0 של Apigee Hybrid, אפשר להשתמש ב-MCP גם ב-Apigee Hybrid – מישור הנתונים של זמן הריצה פועל בתוך אשכול Kubernetes שלכם, ולא בתשתית שמנוהלת על ידי Google. במאמר הפעלת MCP ב-Apigee Hybrid מוסבר איך מתקינים ומגדירים את MCP ב-Apigee Hybrid.
מה זה 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 בין ה-LLM לבין לקוח ה-MCP.
איך פועל MCP ב-Apigee
נקודות הקצה של MCP ל-Google, ל- Google Cloudול-Apigee מטמיעות את המפרט של שרת ה-MCP. כך לקוחות MCP תואמים יכולים לגשת אליהם כדי:
- לגלות נקודות קצה (endpoints) זמינות.
- רשימת הכלים שזמינים בנקודת קצה.
- אימות בנקודת קצה.
- להפעיל כלים בהתאם למדיניות הגישה שהוגדרה.
כל לקוח MCP שתומך בנקודות קצה מרוחקות של MCP דרך HTTP/S יכול לגשת לכלים האלה.
מכיוון שנקודות הקצה מנוהלות, אתם לא צריכים להתקין או לנהל שרתי MCP מקומיים, שרתי MCP מרוחקים או תשתית נוספת כדי לאפשר לאפליקציות מבוססות-סוכנים לגשת לשירותים שלכם.
MCP ב-Apigee תומך ב-JSON-RPC לשיטות tools/list ו-tools/call, ולשיטה server/discover בפרוטוקול MCP ללא שמירת מצב (stateless). אתם יכולים להתאים אישית את נקודת הקצה של ה-MCP באמצעות פרמטרים של גילוי, אבטחה, זמינות ברשת וניטור. במאמר גרסאות נתמכות של פרוטוקול MCP מפורטות הגרסאות של פרוטוקול MCP שנתמכות ב-Apigee.
מודלים של פריסה
MCP זמין בשני מודלים של פריסת Apigee:
- Apigee (SaaS): מישור הנתונים של MCP מתארח בתשתית שמנוהלת על ידי Google. אתם פורסים את שרת ה-proxy של MCP Discovery ונקודת הקצה זמינה באופן מיידי.
- Apigee hybrid (אירוח עצמי, החל מגרסה
1.17.0של Apigee hybrid): מישור הנתונים של MCP פועל בתוך אשכול Kubernetes שלכם. מישור הבקרה של Apigee יוצר את הגדרת הכלי של MCP ממפרט OpenAPI, והאשכול מאחזר את ההגדרה הזו לפי לוח הזמנים שלו. תנועת הבקשות של MCP אף פעם לא יוצאת מהאשכול. איך מפעילים את MCP ב-Apigee Hybrid
ארכיטקטורת מישור הנתונים של MCP ב-Apigee Hybrid
בתרשים הבא מוצג איך רכיבי ה-MCP מופצים בין מישור הבקרה של Apigee לבין אשכול Apigee hybrid.
שני מאפיינים של הארכיטקטורה הזו חשובים לתכנון ולבדיקת האבטחה:
- תנועת הבקשות של MCP נשארת בתוך האשכול. לקוחות MCP מגיעים ל-Ingress הקיים של Apigee באותה כתובת URL שבה הם משתמשים לכל שרת proxy אחר של Apigee. מעבד הבקשות מנתב את הבקשה למישור הנתונים של MCP באותו אשכול. אף בקשה או תגובה של MCP לא חוצה את הגבול אל Google Cloud בזמן הבקשה.
- ההגדרות נשלפות, לא נשלחות. הגדרת הכלי MCP נוצרת על ידי מישור הבקרה של Apigee, ורכיב באשכול שלכם מאחזר אותה לפי לוח זמנים. מישור הבקרה של Apigee אף פעם לא יוזם חיבור לאשכול. במאמר דרישות לרשת יוצאת מפורטות נקודות הקצה המדויקות שצריך לאשר לתעבורת הנתונים היוצאת של האשכול.
גרסאות נתמכות של פרוטוקול MCP
MCP ב-Apigee תומך בפרוטוקול MCP ללא שמירת מצב (stateless), גרסה 2026-07-28, ובגרסאות 2025-11-25, 2025-06-18, 2025-03-26 ו-2024-11-05 של פרוטוקול MCP עם שמירת מצב (stateful). נקודת קצה של MCP משרתת את שני הפרוטוקולים בו-זמנית, כך שלקוחות MCP קיימים ממשיכים לפעול כשלקוחות MCP שמשתמשים בפרוטוקול ללא שמירת מצב קוראים לאותה נקודת קצה.
בדף הזה, המונח בלי שמירת מצב מתייחס למודל המטא-נתונים לכל בקשה שהוצג בגרסה 2026-07-28 של MCP, שנקרא גם מודרני במפרט של MCP.
Stateful מתייחס למודל הקודם שמתחיל בבקשת initialize, שבמפרט של MCP נקרא גם מדור קודם. במדריך למתחילים מופיעה דוגמה מעשית להצגת רשימת כלים באמצעות פרוטוקול MCP ללא שמירת מצב.
| פרוטוקול | גרסאות | השיטות הנתמכות |
|---|---|---|
| בלי שמירת מצב | 2026-07-28 |
|
| עם שמירת מצב |
|
|
איך Apigee בוחרת את הפרוטוקול
Apigee בוחר את הפרוטוקול מגוף הבקשה, ולא מהכותרת MCP-Protocol-Version. בקשה שהאובייקט params._meta שלה מכיל את io.modelcontextprotocol/protocolVersion עם ערך מחרוזת JSON משתמשת בפרוטוקול ללא שמירת מצב. בבקשה בלי המפתח הזה, או עם ערך שהוא לא מחרוזת, נעשה שימוש בפרוטוקול עם שמירת מצב.
- כל ערך מחרוזת בוחר את הפרוטוקול ללא שמירת מצב. אם המחרוזת מציינת גרסה שלא נתמכת ב-Apigee, הבקשה עדיין תשתמש בפרוטוקול ללא שמירת מצב ותיכשל עם שגיאת JSON-RPC
-32022(Unsupported protocol version). היא לא תחזור לפרוטוקול עם שמירת מצב. - בקשה עם כותרת
MCP-Protocol-Versionשל2026-07-28אבל בליio.modelcontextprotocol/protocolVersionב-params._metaהיא בקשה עם שמירת מצב. גרסה2026-07-28היא לא גרסה עם שמירת מצב, ולכן Apigee דוחה אותה עם HTTP400ושגיאת JSON-RPC של הפרוטוקול עם שמירת המצב-32602(Unsupported protocol version), ולא עם השגיאה ללא שמירת מצב-32022. כדי להשתמש בגרסה2026-07-28, צריך לשלוח בקשה בפורמט של בקשה ללא שמירת מצב. - אם בבקשת
initializeנדרשת גרסה2026-07-28, או כל גרסה אחרת שלא נתמכת ב-Apigee, Apigee מנהלת משא ומתן על גרסה2025-11-25. - השיטה
server/discoverזמינה רק בפרוטוקול ללא שמירת מצב. בקשתserver/discoverעם שמירת מצב פועלת לפי הטיפול בשגיאות של הפרוטוקול עם שמירת המצב: היא מקבלת את קוד השגיאה200ב-HTTP עם שגיאת JSON-RPC-32601(Method server/discover is not supported) בגוף התגובה. סטטוס ה-HTTP404בקטע שגיאות בפרוטוקול ללא שמירת מצב (stateless) רלוונטי רק לבקשות ללא שמירת מצב.
בקשות לפרוטוקול ללא שמירת מצב (stateless)
כל בקשה ללא שמירת מצב חייבת לכלול את גרסת הפרוטוקול גם בגוף הבקשה וגם בכותרת. אם אתם מעבירים לקוח MCP מהפרוטוקול עם שמירת מצב, אלה ההבדלים העיקריים:
- לקוח ה-MCP לא קורא ל-
initialize. Apigee לא יוצרת סשנים לפרוטוקול ללא שמירת מצב (stateless). - לקוח ה-MCP לא שולח כותרת
Mcp-Session-Id. אם בקשה ללא שמירת מצב כוללת אסימון, Apigee מתעלמת ממנו. - כל בקשה כוללת אובייקט
params._metaעם גרסת הפרוטוקול והיכולות של הלקוח. - כל בקשה כוללת את הכותרות
MCP-Protocol-Versionו-Mcp-Method, ובקשתtools/callכוללת גם את הכותרתMcp-Name. - בקשות לא חוקיות מקבלות את קוד הסטטוס
400או404של HTTP עם קודי השגיאה שמפורטים בקטע שגיאות בפרוטוקול ללא שמירת מצב.
בקשה ללא שמירת מצב חייבת לכלול את השדות הבאים בגוף הבקשה:
-
params._meta["io.modelcontextprotocol/protocolVersion"]: חייב להיות מחרוזת JSON"2026-07-28", ולא מספר. -
params._meta["io.modelcontextprotocol/clientCapabilities"]: חייב להיות אובייקט JSON. אם לקוח ה-MCP לא מצהיר על יכולות, שולחים אובייקט ריק ({}). - אופציונלי:
params._meta["io.modelcontextprotocol/clientInfo"], אובייקט עםnameו-versionשל לקוח ה-MCP. לפי המפרט של MCP, מומלץ שלקוחות MCP ישלחו את זה בכל בקשה.
בקשה ללא שמירת מצב חייבת לכלול את כותרות ה-HTTP הבאות:
| כותרת | נדרש עבור | ערך |
|---|---|---|
MCP-Protocol-Version |
כל השיטות | 2026-07-28. חייב להתאים לגרסת הפרוטוקול ב-_meta. |
Mcp-Method |
כל השיטות | ה-method של JSON-RPC, לדוגמה tools/list. הערך צריך להיות זהה לערך בשדה method בגוף הבקשה. |
Mcp-Name |
tools/call בלבד |
שם הכלי. חייב להיות זהה ל-params.name בגוף הבקשה. שולחים את שם הכלי כערך כותרת ASCII פשוט. אם שם הכלי מכיל תווים שאינם ASCII או תווי בקרה, אם יש בו רווח לבן בתחילת השם או בסופו, או אם הוא תואם לתבנית =?base64?...?=, צריך לקודד אותו בתור =?base64?ENCODED_NAME?=, כאשר ENCODED_NAME הוא קידוד base64 מרופד של שם הכלי ב-UTF-8. לפרטים נוספים, ראו קידוד ערכים במפרט של MCP. אל תשלחו את Mcp-Name עם tools/list או server/discover. |
שולחים כל כותרת פעם אחת. Apigee מתייחסת לכותרת MCP-Protocol-Version, Mcp-Method או Mcp-Name שחוזרת על עצמה כאל חוסר התאמה בכותרת.
התוצאות ללא מדינה כוללות את "resultType": "complete". התוצאות של tools/list ו-server/discover כוללות גם את "cacheScope": "public" ו-"ttlMs": 0. ערך ttlMs של 0 אומר שהתוצאות לא עדכניות ברגע שהן מגיעות: Apigee לא מציעה חלון מטמון בשבילן, ולכן ל-cacheScope אין השפעה מעשית. התוצאה server/discover מפרטת את גרסאות הפרוטוקול הנתמכות ב-supportedVersions, את יכולות השרת ב-capabilities ("tools": {"listChanged": false}) ואת פרטי השרת ב-_meta["io.modelcontextprotocol/serverInfo"]. סדר השדות באובייקט JSON לא מובטח, ולכן לקוחות MCP חייבים לקרוא את השדות לפי השם.
אם בקשת tools/call בלי שמירת מצב כוללת את מפתחות OpenTelemetry traceparent, tracestate או baggage ב-params._meta, Apigee מעבירה את הערכים שלהם לבק-אנד ככותרות HTTP עם אותו שם.
Apigee לא מוסיפה הערות x-mcp-header להגדרות הכלים שמוחזרות על ידי tools/list, ולכן לקוחות MCP לא שולחים כותרות Mcp-Param-NAME ל-Apigee.
שגיאות בפרוטוקול ללא שמירת מצב (stateless)
אם בקשה ללא שמירת מצב לא עומדת בדרישות שמפורטות בקטע בקשות לפרוטוקול ללא שמירת מצב, מערכת Apigee דוחה אותה ומציגה אחת מהשגיאות הבאות.
כדי לתקן שגיאה מסוג 400, צריך לבדוק את הבקשה בהתאם לדרישות האלה.
ב-Apigee לא נדרשת יכולת לקוח, ולכן לא מוחזרת שגיאת JSON-RPC -32021 (MissingRequiredClientCapability).
| תנאי | סטטוס HTTP | קוד שגיאה של JSON-RPC | הודעת השגיאה |
|---|---|---|---|
הכותרת MCP-Protocol-Version, Mcp-Method או Mcp-Name חסרה. |
400 |
-32020 |
Missing HEADER header |
| כותרת לא תואמת לגוף הבקשה, היא ריקה או שהיא מופיעה יותר מפעם אחת. | 400 |
-32020 |
Header mismatch: HEADER header does not match request body |
גרסת הפרוטוקול לא נתמכת. השגיאה data מכילה את הגרסה המבוקשת ב-requested ואת הגרסאות הנתמכות ב-supported. |
400 |
-32022 |
Unsupported protocol version |
השדה io.modelcontextprotocol/clientCapabilities חסר ב-_meta. |
400 |
-32602 |
Missing io.modelcontextprotocol/clientCapabilities in _meta |
io.modelcontextprotocol/clientCapabilities הוא לא אובייקט JSON. |
400 |
-32602 |
io.modelcontextprotocol/clientCapabilities in _meta is not an object |
ה-method לא נתמכת בפרוטוקול ללא שמירת מצב, לדוגמה initialize, notifications/initialized, ping, resources/list, resources/read, prompts/list או subscriptions/listen. |
404 |
-32601 |
Method METHOD is not supported |
התכונות העיקריות של MCP ב-Apigee
MCP ב-Apigee מציע תכונות לחיפוש כלים, לאבטחה ולפיקוח. התכונות האלה עוזרות לכם לנהל את האינטראקציה של אפליקציות מבוססות-סוכנים עם השירותים שלכם.
חיפוש כלים פשוט יותר באמצעות API Hub
אתם יכולים לגלות נקודות קצה זמינות של MCP לשירותי Apigee באמצעות שירות ספריות שנגיש דרך ממשק REST. כל נקודת קצה של MCP תומכת גם בשיטה tools/list של MCP, שמאפשרת ללקוחות MCP לגלות את הכלים שזמינים בנקודת הקצה הזו.
בנוסף, MCP משתלב עם Apigee API hub. כשפורסים שרת פרוקסי לזיהוי MCP, API Hub מטמיע באופן אוטומטי את מפרט ה-OpenAPI שלו, מקצה לו את סגנון ה-API של MCP וממפה את פעולות ה-API לכלים ספציפיים של MCP. כך המפתחים יכולים לסנן בקלות ממשקי API שתומכים ב-MCP ב-API Hub, ולהשתמש בחיפוש סמנטי עם שאילתות בשפה טבעית כדי למצוא כלים רלוונטיים לאפליקציות מבוססות-הסוכנים שלהם.
מיקום הארגומנט של הכלי בבקשה לקצה העורפי
כשלקוח MCP קורא לכלי, Apigee יוצרת בקשה לקצה העורפי שלכם מהארגומנטים שהלקוח סיפק. הערך של in שכל פרמטר מצהיר עליו במפרט OpenAPI קובע איפה הארגומנט הזה ממוקם בבקשה היוצאת.
ערך in של OpenAPI |
המקום שבו הארגומנט נשלח בבקשה לקצה העורפי |
|---|---|
header |
כ-request header. שם הפרמטר משמש כשם הכותרת, בדיוק כמו שהוא כתוב במפרט. |
cookie |
בכותרת הבקשה Cookie, כצמד name=value. אם בפעולה מסוימת מצהירים על כמה פרמטרים של קובצי Cookie, הם נשלחים בכותרת Cookie אחת, ומופרדים באמצעות ; (נקודה-פסיק ורווח). |
query |
במחרוזת השאילתה. |
path |
מוחלף בנתיב כתובת ה-URL של הבקשה. |
כל פרמטר מופיע ב-inputSchema של הכלי, בלי קשר לערך in שלו, כך שלקוח MCP מספק את כולם באותו אופן.
הערך של in משתנה רק במקום שבו הערך ממוקם בבקשה ל-backend.
לדוגמה, הפעולה הבאה מצהירה על פרמטר אחד בכל אחד משלושה מיקומים:
paths: /orders: get: operationId: listOrders parameters: - name: X-Session-Id in: header schema: type: string - name: tenantId in: cookie schema: type: string - name: limit in: query schema: type: integer
בקשת tools/call שמספקת את כל שלושת הארגומנטים יוצרת בקשת backend בצורה הבאה:
GET /orders?limit=25 X-Session-Id: sess-abc-123 Cookie: tenantId=tenant-xyz-789
שימו לב להתנהגות הבאה:
- ארגומנט שקשור לכותרת או לקובץ Cookie לא מצורף גם למחרוזת השאילתה, ולא נכלל בגוף הבקשה.
- המערכת מדלגת על ארגומנט שהלקוח לא מספק. לא נשלחים במקומם כותרת, קובץ Cookie או פרמטר של שאילתה ריקים.
- כותרת מקושרת מחליפה כל כותרת עם אותו שם שכבר קיימת בבקשה לקצה העורפי. כותרות אחרות בבקשה לקצה העורפי מועברות ללא שינוי.
- הערכים מקודדים באחוזים (RFC 3986) כשהם ממוקמים בבקשה לקצה העורפי, כך שערך שמכיל רווח או תו שמור מגיע לקצה העורפי בצורה המקודדת שלו. אפשר לפענח אותו שם אם צריך את המקור.
- אם בפעולה ובנתיב שלה מוגדר פרמטר עם אותו שם ואותו ערך
in, ההגדרה ברמת הפעולה חלה, כפי שנדרש במפרט של OpenAPI. - תנו שמות שונים לפרמטרים באותה פעולה, גם אם הם מצהירים על ערכי
inשונים. ב-OpenAPI, פרמטר מזוהה לפי צמד של שם ומיקום, אבל כלי MCP מקבל ערך אחד לכל שם של ארגומנט. אם במפרט מצהירים על שני פרמטרים עם אותו שם וערכיinשונים, הלקוח מספק ערך אחד והערך הזה נשלח לשני המיקומים המוצהרים בבקשה לקצה העורפי:sessionIdשהוצהר גם כ-in: cookieוגם כ-in: queryמגיע בכותרתCookieובמחרוזת השאילתה. כדאי לבדוק את זה אם בקצה העורפי יש לוגיקה שתלויה במקור של הערך. - שמות הארגומנטים תלויי אותיות רישיות, כך ש-
UserIDו-useridהם שני ארגומנטים שונים. בפרמטרים מסוגheader, צריך לוודא שהשמות שונים לא רק באותיות רישיות: שמות של כותרות HTTP לא תלויים באותיות רישיות, ולכן שני פרמטרים של כותרות שהשמות שלהם שונים רק באותיות רישיות יפנו לאותה כותרת בבקשה של ה-backend, ורק אחד משני הערכים יישמר.
קובצי Cookie בבקשה לקצה העורפי
קובצי Cookie הם המקרה היחיד שבו הקישור יכול להסיר משהו מהבקשה, ולא רק להוסיף לה. בניגוד לכותרות HTTP אחרות, שכוללות צמדים נפרדים של שם/ערך שאפשר להגדיר כל אחד מהם בנפרד, כל קובצי ה-Cookie חולקים כותרת Cookie אחת. Apigee לא ממזגת את קובצי ה-Cookie שאתם מקשרים עם קובצי ה-Cookie שהגיעו בבקשה של לקוח ה-MCP: כשקריאה מספקת ארגומנט כלשהו של קובץ Cookie, הכותרת Cookie מוחלפת כולה בקובצי ה-Cookie המקושרים בלבד.
לכן, אם קובץ Cookie שהגיע עם בקשת ה-HTTP של לקוח ה-MCP עצמו מגיע לקצה העורפי, זה תלוי בקריאת ה-API לכלי הספציפי:
- אם הפעולה לא מצהירה על פרמטרים של
cookie, הכותרתCookieמועברת ל-backend ללא שינוי. - אם הפעולה מצהירה על פרמטרים של
cookieאבל הקריאה לא מספקת אף אחד מהם, הכותרתCookieמועברת שוב ל-backend ללא שינוי. - ברגע שהקריאה מספקת לפחות ארגומנט אחד של קובץ Cookie, הכותרת
Cookieמוחלפת בקובצי ה-Cookie המקושרים בלבד. כל קובץ Cookie שהגיע בבקשה של הלקוח ולא הוגדר כפרמטרcookieנמחק.
המקרה השלישי מונע על ידי הארגומנטים שקריאה מסוימת מספקת, ולכן פעולה עם פרמטרים אופציונליים של קובצי Cookie יכולה להעביר קובצי Cookie בקריאה אחת ולהשמיט אותם בקריאה הבאה. אין הגדרה ששומרת קובץ Cookie לא מוצהר. אם הקצה העורפי שלכם תלוי בקובץ Cookie, הצהירו עליו כפרמטר cookie בכל פעולה שצריכה אותו, כדי שהערך שלו תמיד יסופק על ידי קריאת ה-API לכלי ולא יועבר בירושה מהבקשה של הלקוח.
אבטחה
MCP ב-Apigee כולל כמה שכבות אבטחה כדי להגן על השירותים שלכם. אתם יכולים לשלוט בגישה באמצעות אימות, הרשאה, גבולות רשת וסריקת תוכן.
אימות
נקודות הקצה של MCP שמתארחות ב-Apigee תומכות ב-OAuth 2.1 וב-OpenID Connect (OIDC) לאימות. כך רק סוכנים, לקוחות MCP ומשתמשי קצה עם זהויות מאומתות יכולים לגשת לנקודות הקצה של ה-MCP ולהפעיל את הכלים של ה-MCP. מטא-נתונים של משאבים מוגנים מאפשרים ללקוחות לגלות את שרתי ההרשאות של OAuth.
כללי מדיניות פרטניים של הרשאות
אתם יכולים להגביל את הגישה לכלי ה-MCP שלכם על סמך זהויות של לקוחות OAuth. לדוגמה, אתם יכולים להגדיר מדיניות בשרת ה-proxy של MCP Discovery, ולקבוע שרק סוכנים ייעודיים עם זהויות לקוח ידועות יכולים לגשת לכלי MCP של שירות תשלומים.
אחריות הלקוח על הפעלת כלים
אפליקציות הלקוח של MCP אחראיות לאכיפת הפיקוח האנושי על הפעלת הכלים, למשל הצגת בקשה למשתמש לפני ביצוע פעולות שמשנות את המצב. מידע נוסף זמין במאמרי העזרה של Model Context Protocol.
ניראות וניתוח נתונים
בנקודות קצה (endpoints) שמתארחות ב-Apigee, אתם יכולים להשתמש ב-Apigee Analytics כדי לראות מידע מפורט על השימוש בכלים של MCP.
Analytics מאפשר לכם לפלח תנועה ספציפית ל-MCP מתנועת API רגילה ולראות מדדים ברמת הכלי הספציפי, כמו נפח הבקשות של tools/list (גילוי) לעומת tools/call (ביצוע). מדדי הביצועים גם עוזרים להבחין בין התקורה של שרת ה-Proxy לבין זמן התגובה של היעד, וכך לאתר צווארי בקבוק בצורה יעילה יותר.
אמינות ופתרון בעיות
כדי לשפר את פתרון הבעיות ולספק יותר חשיפה לתהליך הפריסה, Apigee מציגה שגיאות ספציפיות בתשתית ובהגדרות בממשק המשתמש. אם הפריסה נכשלת בגלל מפרט OpenAPI לא תקין או בעיה בתשתית האזורית, בממשק המשתמש יופיע משוב עם פעולות לביצוע שיעזרו לכם לפתור את הבעיה בלי לפנות לתמיכה.
שימוש ב-MCP עם Apigee
אתם יכולים לחשוף את ממשקי ה-API הקיימים של Apigee ככלים של MCP ולהפוך אותם לנגישים דרך נקודות קצה (endpoints) של MCP.
אפשר להגדיר את נקודות הקצה האלה ברמת המארח או ברמת קבוצת הסביבות. לדוגמה, אם לארגון שלכם ב-cymbal יש שמונה שמות מארחים (למשל, api.cymbal.com, partners.cymbal.com), וכל אחד מהם משויך לקבוצת סביבות אחרת, אתם יכולים לארח שרת MCP ייעודי לכל שם מארח.
נקודת קצה מנוהלת של יעד (ORG_NAME.mcp.apigee.internal) נפרסת באמצעות שרת proxy ייעודי של MCP Discovery בארגון שלכם ב-Apigee, שבו שרתי ה-MCP זמינים.
בטבלה הבאה מוצגת דוגמה לאופן שבו לקוחות, כולל הארגון הבדיוני Cymbal, יכולים להגדיר כמה נקודות קצה של 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-central2europe-southwest1europe-west9me-central2
אם מופיעה שגיאת הקצאה או שסטטוס ההקצאה לא משתנה ל-Deployed, יכול להיות שהסיבה היא מגבלות זמניות בקיבולת התשתית באזור שנבחר. נסו לפרוס את שרת ה-proxy בסביבה באזור אחר.
- MCP ב-Apigee תומך בגרסאות הבאות של OpenAPI: 3.0.0, 3.0.1, 3.0.2, 3.0.3.
- תובנות לגבי ממשקי API ב-Apigee API hub לא זמינות לממשקי API ולכלים של MCP שנפרסו בארגונים ב-Apigee שבהם VPC-SC מופעל.
- קריאות GET בתגובות לשגיאות של MCP יחזירו שגיאת
405, כי שרת ה-MCP לא תומך כרגע בסטרימינג של אירועים שנשלחים מהשרת (SSE). - התובנות של Apigee API hub API לא יציגו ממשקי API בסגנון MCP או תנועה למשאבי MCP עד ש-Apigee בגרסה 1-17-0-apigee-6 תושק באופן מלא בכל האזורים הזמינים.
- אי אפשר לשנות את מאפיין הסגנון של ה-API ל-MCP במשאב API שיש לו פעולות API קיימות.
מגבלות ספציפיות ל-Apigee Hybrid
המגבלות הבאות חלות על MCP ב-Apigee Hybrid:
- הארגומנטים של הכלי שהוגדרו כ-
in: headerאו כ-in: cookieנשלחים במחרוזת השאילתה. הניתוב לכל מיקום שמתואר בקטע מיקום הארגומנט של הכלי בבקשה לקצה העורפי עדיין לא זמין ב-Apigee hybrid. עד שהתכונה תהיה זמינה, פרמטר שמצהיר על אחד מהמיקומים האלה יגיע לקצה העורפי כפרמטר של שאילתה, וזו ההתנהגות שהייתה לפני התכונה הזו. השורותin: queryו-in: pathבטבלה הזו רלוונטיות ל-Apigee Hybrid כפי שהן כתובות. - מספר הכלים ב-MCP מוגבל לפי הגודל, לא לפי מספר קבוע. בניגוד ל-Apigee (שמגביל את מספר כלי ה-MCP לכל ארגון), ב-Apigee Hybrid קיבולת הכלים מוגבלת על ידי ארבע מגבלות גודל: גודל קובץ המפרט של OpenAPI, גודל חבילת ה-proxy של MCP, גודל התגובה של
tools/listלכל שם מארח ומספר שמות המארחים לכל קבוצת סביבות. ברוב המפרטים של OpenAPI, אפשר בדרך כלל להכניס 10,000 כלי MCP לכל ארגון במגבלת ברירת המחדל של גודל התגובה. הקיבולת בפועל משתנה בהתאם למבנה הספציפי של המפרט (בעיקר לפי מספר הפרמטרים והמאפיינים של גוף הבקשה, וגם לפי אורך התיאור). סכמות התשובה לא נכללות במכסה. כדי להעריך את הקיבולת של מפרטי OpenAPI ספציפיים ולראות את ארבע המגבלות הקשיחות ואת מצבי הכשל שלהן, קראו את המאמר הערכת הקיבולת של כלי MCP. - הפעלה או השבתה של MCP מפעילה גרסה איטרטיבית לקהל מצומצם (canary release) בשלבים של פודים של מעבד בקשות. מפעיל Apigee מעדכן את מפרט ה-pod של מעבד הבקשות כשמפעילים או משביתים את MCP, והבקר של מעבד הבקשות
ApigeeDeploymentמריץ את השינוי באמצעות גרסה איטרטיבית לקהל מצומצם (canary release) בשלבים, ולא כהפעלה מחדש הדרגתית רגילה של Kubernetes. הגרסה מופעלת רק במעברים של הפעלה והשבתה, ולא בפעילות מתמשכת של פריסת MCP או בתנועה במצב יציב של MCP. תזמנו את ההפעלה הראשונית ואת כל פעולות ההשבתה הבאות במהלך חלון זמן מאושר לתחזוקה. - הלקוח מנהל את גודל המשאבים של פוד ה-MCP. הפודים של MCP פועלים עם בקשות המשאבים והמגבלות שמוגדרות כברירת מחדל בתרשימי ה-Helm של Apigee Hybrid. אם עומס העבודה דורש קיבולת גדולה יותר, צריך לשנות את המעבד (CPU) והזיכרון ב-
overrides.yaml.overrides.yamlfield reference מפרט את השדות הזמינים. - מישור נתונים אחד של MCP לכל ארגון ב-Apigee, לכל אשכול. בגרסה
1.17.0, מפעיל Apigee מקצה מישור נתונים אחד של MCP לכל ארגון Apigee שמותקן באשכול. באשכול שמארח כמה ארגונים ב-Apigee פועל מישור נתונים אחד של MCP לכל ארגון. מישורי הנתונים הם עצמאיים ולא חולקים הגדרות. - צריך להפעיל את התכונה באופן אחיד בכל קבוצת הסביבות. מפעילים את MCP באופן אחיד בכל האשכולות שמשרתים את אותה קבוצת סביבות של Apigee. אם MCP מופעל בחלק מהאשכולות ולא באחרים בתוך קבוצה, בקשות MCP שמופנות לאשכול שבו MCP לא מופעל יקבלו תגובה מסוג
503 Service Unavailable. - כדי להשתמש בפרוטוקול MCP ללא שמירת מצב, צריך גרסה
1.17.4ומעלה. גרסאות Apigee Hybrid מ-1.17.0עד1.17.3תומכות רק בגרסאות2025-11-25,2025-06-18,2025-03-26ו-2024-11-05של פרוטוקול MCP עם שמירת מצב. החל מגרסה1.17.4, Apigee hybrid תומך גם בפרוטוקול MCP ללא שמירת מצב (stateless), גרסה2026-07-28. גרסאות נתמכות של פרוטוקול MCP - TLS חד-כיווני בין מעבד הבקשות לבין מישור הנתונים של MCP. בגרסה
1.17.0נעשה שימוש ב-TLS חד-כיווני בין מעבד הבקשות לבין מישור הנתונים של MCP. - כברירת מחדל, TLS חד-כיווני בין מישור הנתונים של MCP לבין שער הכניסה. מישור הנתונים של MCP מעביר קריאות API לכלי לשער הכניסה של Apigee דרך TLS, אבל כברירת מחדל הוא לא מציג אישור לקוח ולא מאמת את האישור של שער הכניסה.
החל מגרסה
1.17.4, אפשר להפעיל פרוטוקול TLS הדדי בחיבור הזה לכל קבוצת סביבות. חובה להשתמש ב-Mutual TLS בכל קבוצת סביבות ב-tlsMode: MUTUALשמטפלת בקריאות API לכלי MCP. מידע נוסף זמין במאמר הגדרת mTLS בין מישור הנתונים של MCP לבין שער הכניסה. - מישור הנתונים של MCP מסתמך על מעבד הבקשות כדי לזהות את הגורם ששולח את הבקשה. מישור הנתונים של MCP באשכול לא מאמת באופן עצמאי את המתקשרים שלו ב-
1.17.0. הוא סומך על כך שהבקשות שמגיעות אליו כבר אומתו על ידי שרת proxy של Apigee שפועל במעבד הבקשות. כל בקשת MCP שצריך לאמת חייבת להגיע דרך שרת proxy של Apigee MCP שאוכף מדיניות אימות (ראו ניהול הגישה לכלי MCP). לקוחות בסביבת ייצור צריכים להחיל אמצעי בקרה על תעבורת נתונים נכנסת (ingress) באשכול, כדי שרק פודים של מעבד בקשות (תווית Kubernetesapp=apigee-runtimeבאותו מרחב שמות של Kubernetes שבו מותקן Apigee hybrid) יוכלו להגיע לשירות MCP ב-TCP443. כדי לאכוף את ההגבלה הזו, צריך להשתמש במנוע המדיניות שנתמך בפלטפורמה (Kubernetes NetworkPolicy, Cilium, Calico, Istio AuthorizationPolicy).
המאמרים הבאים
- איך מתחילים לעבוד עם Apigee ו-MCP
- ב-Apigee Hybrid, קודם מפעילים את MCP באשכול ואז פועלים לפי המדריך למתחילים.
- כדי לגשת למוצרים אחרים של Google ושל Google Cloud באמצעות כלי MCP, קראו את הסקירה הכללית על שרתי Google Cloud MCP.