Model Context Protocol (MCP) הוא תקן קוד פתוח לחיבור אפליקציות AI למערכות חיצוניות. הוא מגדיר קבוצה ספציפית של ישויות ומבנה מוגדר, שמשמש כדרך סטנדרטית לחיבור בין מקורות נתונים שונים וכלים לבין מודלים של AI.
אתם יכולים להשתמש בכלים של MCP כדי לקשר את אפליקציית הסוכן שלכם לשרת MCP קיים.
מגבלות
ההגבלות הבאות חלות:
- ב-CX Agent Studio יש תמיכה רק בשרתים שמבוססים על StreamableHttpTransport. אין תמיכה בשרתי העברה של SSE.
פיתוח או בחירה של שרת MCP
כדי ליצור שרת MCP משלכם, מומלץ להשתמש בערכות ה-SDK הרשמיות של MCP או בערכות SDK מהימנות אחרות של צד שלישי, כמו FastMCP. אחרי שיוצרים את שרת ה-MCP, פורסים אותו בשירות אירוח. אפשר להשתמש ב-Cloud Run או ב-Compute Engine כדי לארח את שרת ה-MCP. כדאי להיעזר במדריך הבא כדי להבין את התהליך מההתחלה ועד הסוף: Build and Deploy a Remote MCP Server to Google Cloud Run in Under 10 Minutes.
במקום ליצור שרת MCP מאפס, אפשר גם להשתמש בשרת MCP מוכן מראש, כמו Google Cloud שרת MCP.
אימות
לכלי MCP יש את אותן אפשרויות אימות כמו לכלי OpenAPI.
כותרות מותאמות אישית
אפשר לספק כותרות HTTP מותאמות אישית שיישלחו בבקשות לשרת ה-MCP. אפשר גם להוסיף משתנים מההקשר של הסשן לכותרות האלה. מידע נוסף זמין במאמר בנושא משתני הקשר של הסשן.
בדיקה של שרת ה-MCP באופן עצמאי
לפני שמחברים את הסוכנים לשרת ה-MCP, מומלץ לבדוק את שרת ה-MCP בנפרד.
שרתים שנבנו באמצעות StreamableHttpTransport מסתיימים בסיומת (/mcp או /mcp/). לדוגמה, אם השרת מתארח ב-https://example.com, כתובת ה-URL הנכונה לשליחת בקשות לשרת תהיה https://example.com/mcp.
כדי לבדוק את השרת באופן מקומי, כדאי להשתמש ב-curl או ב-Postman (שתומך באופן מקורי בחיבורי MCP). כך מוודאים שהשרת פועל ושהמידע לאימות שנדרש לתקשורת עם השרת מובן.
כותרות מותאמות אישית
אפשר להגדיר כותרות מותאמות אישית שייכללו כששולחים בקשות HTTP לשרת ה-MCP (בקשות לרשימת כלים וגם בקשות להפעלת כלים). הערכים של הכותרות האלה צריכים להיות מסופקים על ידי משתנים, ולכן כדי להגדיר כותרת מותאמת אישית, צריך קודם להגדיר משתנה שיכיל את ערך הכותרת. אם משתנה לא מכיל ערך ואין ערך ברירת מחדל בזמן הריצה, הכותרת לא תיכלל בבקשות.
יצירת כלי ה-MCP
כדי ליצור כלי MCP מהמסוף:
- לוחצים על סמל הכלי בצד שמאל של הכלי ליצירת סוכנים.
- בוחרים באפשרות כלי MCP.
- מזינים שם לכלי.
- צריך לספק תיאור של הכלי.
- מציינים את כתובת השרת של שרת ה-MCP.
- בוחרים סוג אימות.
- אפשר להגדיר כותרות מותאמות אישית על ידי ציון שמות של כותרות ומשתנים שמשמשים כערכי כותרות.
- לוחצים על יצירה.
לשרתים שמתארחים ב-Cloud Run, מומלץ להשתמש באפשרות האימות Service Agent ID Token (אסימון מזהה של סוכן שירות).
בשיטה הזו נעשה שימוש בחשבון השירות של CX Agent Studio (בפורמט: service-{PROJECT_NUMBER}@gcp-sa-ces.iam.gserviceaccount.com) כדי לשלוח בקשות למשימת Cloud Run.
מקצים את התפקיד 'מפעיל Cloud Run' לחשבון השירות של CX Agent Studio, כדי שהוא יוכל לשלוח בקשות לשרת באמצעות הזהות שלו.
לפני שמוסיפים עוד כלים לסוכן, מומלץ לבדוק לפחות כלי אחד כדי לוודא שפרטי האימות מוגדרים בצורה נכונה.