אתם יכולים להשתמש במצב פיתוח בממשקי Gemini כדי לבדוק באופן אינטראקטיבי את שרת Model Context Protocol (MCP), לאבחן שגיאות סכימה או שגיאות זמן ריצה ולמדוד את איכות הכלי לפני שאתם שולחים את האפליקציה המקושרת לבדיקה ב-Google Connected Console.
המדריך הזה כולל את המשימות הבאות:
- מפעילים את מצב הפיתוח של ממשקי Gemini, יוצרים אפליקציית MCP בהתאמה אישית ומוודאים שהכלי הראשוני מזוהה.
- לנפות באגים בקריאות API לכלי שנכשלו, לסנכרן סכימות מעודכנות ולבדוק את האימות.
- לדמות את ההקשר של סביבת המשתמש ולהגדיר אימות לקוח.
לסקירה כללית על פריסת סביבת העבודה ועל הכרטיסיות של הכלי לבדיקת רכיבים, ראו את הסקירה הכללית על מצב פיתוח למפַתחי אפליקציות ב-Gemini.
הפעלת מצב פיתוח בממשקי Gemini
אם אתם מגדירים את שרת ה-MCP ב-Google Connected Console, האפליקציה הרשומה כבר זמינה כשאתם מפעילים את מצב הפיתוח בממשקי Gemini, ואתם יכולים לדלג על שלב 2. אם אתם רוצים לבדוק נקודת קצה של שרת MCP מסוג HTTPS שנפרס ישירות ב-Gemini לפני שאתם רושמים אותה במסוף, בצעו את שני השלבים הבאים כדי להפעיל את מצב הפיתוח בממשקי Gemini ולקשר את השרת כאפליקציית MCP בהתאמה אישית.
שלב 1: מפעילים את מצב הפיתוח בממשקי Gemini
- פותחים את Gemini בדפדפן האינטרנט.
- לוחצים על הגדרות > מצב פיתוח למפתחי אפליקציות ב-Gemini (או עוברים ישירות לכתובת gemini.google.com/devmode).
(אופציונלי) שלב 2: יוצרים ובודקים אפליקציית MCP בהתאמה אישית
כדי לקשר את שרת ה-MCP כאפליקציה בהתאמה אישית במצב פיתוח בממשקי Gemini:
- בתיבת הדו-שיח בחירת אפליקציה, לוחצים על + יצירת אפליקציה חדשה.
- בתיבת הדו-שיח Connect to an MCP server, מזינים את נקודת הקצה הציבורית של שרת ה-MCP ב-HTTPS בשדה MCP Server URL (מוודאים שכתובת ה-URL מתחילה ב-
https://, לדוגמה,https://your-app-link.com/mcp). - אם השרת דורש פרטי כניסה רשומים מראש ל-OAuth, לוחצים על Additional settings > Show more כדי להזין את מזהה לקוח OAuth ואת סוד לקוח, ואז לוחצים על Next.
- בתיבת הדו-שיח לאישור האבטחה והפרטיות, בודקים איך Gemini יוצר אינטראקציה עם שרת ה-MCP המותאם אישית:
- הפעלת כלים: Gemini מפעיל את הכלים של שרת ה-MCP כדי להפעיל ולהריץ פונקציות זמינות שיטפלו בבקשות שלכם.
- אחזור ושיתוף נתונים: Gemini מאחזר ומנהל משאבים, סכימות והקשרים שנחשפים על ידי נקודות הקצה של שרת ה-MCP, ויכול לשתף מידע שיש לו גישה אליו בהתאם להגדרות של חשבון Google או כשהוא יוצר אינטראקציה עם אפליקציות מקושרות אחרות.
- אמינות וניתוק: לפני שממשיכים, חשוב לוודא ששרת ה-MCP מהימן ולעיין במדיניות הפרטיות שלו. אתם יכולים לנתק את השרת בכל שלב בדף "אפליקציות מקושרות" או למחוק את הקישור שלו מהחיבורים בחשבון Google.
- בוחרים באפשרות אני מבין/ה ומאשר/ת את הסיכונים לגבי האבטחה והפרטיות בקישור האפליקציה הזו המותאמת אישית ולוחצים על קישור.
- בתיבת הדו-שיח Save your custom app, מזינים את השם המוצג של האפליקציה בהתאמה אישית, מוודאים שהכלים של השרת מופיעים ברשימה Available actions ולוחצים על Connect.
- בחלונית הצדדית של מצב פיתוח בממשקי Gemini, בוחרים בכרטיסייה סכימות של כלים כדי לעיין במידע על כל כלי באפליקציה המקושרת, כולל הגדרות של פרמטרים, תגי בטיחות (לקריאה בלבד, הרסני, נדרש אימות), סכימה גולמית ומבנה התגובה.
- בחלונית הצ'אט השמאלית, מזינים הנחיות בשפה טבעית או הנחיות
@mention(לדוגמה,@MyApp show my profile), ועוקבים אחרי הכרטיסייה יומן אירועים כדי לראות איך הכלי פועל.
ניפוי באגים בקריאות API לכלים
אם קריאת API לכלי נכשלת או יוצרת ארגומנטים לא צפויים, אתם יכולים לבדוק את נתוני הטלמטריה לאבחון, לעדכן את שרת ה-MCP בקצה העורפי ולבצע Hot Reload לסכימה בלי למחוק את היסטוריית השיחות.
כדי לנפות באגים בקריאת API לכלי שנכשלה:
- בחלונית השמאלית, לוחצים על הכרטיסייה יומן אירועים.
- לוחצים על האירוע שנכשל ברשימה Telemetry כדי להרחיב את הפרטים שלו ולבדוק את המטען הייעודי (payload) של הבקשה ל-
Tool callואת התגובה שלTool result:- שגיאות בחיבור וברשת: בודקים את הודעות השגיאה ואת זמן האחזור כדי לוודא שאפשר להגיע לנקודת הקצה.
- שגיאות אימות: אם האירוע מחזיר את הערך
401או403, צריך לבדוק את מצב אסימון ה-OAuth או את פרטי הכניסה של הלקוח בכרטיסייה Authentication. - חוסר התאמה באימות הסכימה: אם השרת מחזיר שגיאת פרמטרים לא תקינים של MCP (
-32602), משווים בין הארגומנטים של ה-JSON שנוצרו על ידי המודל ב-Tool callלבין סוגי הפרמטרים, המאפיינים הנדרשים והוראות הפורמט בכרטיסייה סכימות של כלים. - חריגות בזמן ריצה בשרת: כדי לאבחן חריגות בקצה העורפי, בודקים את קוד השגיאה וההודעה של JSON-RPC ב-
Tool result.
- כדי לפתור את הבעיה, צריך לעדכן את ההטמעה של שרת ה-MCP או לשפר את התיאורים של הכלים והפרמטרים. במאמר תקנים לשילוב אפליקציות מקושרות ב-MCP מוסבר איך לכתוב סכימות ברורות של כלים ותגובות שגיאה.
- בכרטיסייה Tool Schemas, לוחצים על Sync schema. Gemini מאחזר מחדש את
tools/listמשרת ה-MCP ומעדכן את הגדרות הכלים הפעילים, תוך שמירה על שרשור הצ'אט הנוכחי. - מנסים שוב את השאילתה. בכרטיסייה יומן אירועים, מוודאים שהקריאה החוזרת לכלי מחזירה את הערך
200 OKומציגה את התשובה הצפויה בתצוגה המקדימה של הצ'אט.
הדמיה של הקשר הסביבה והאימות
אתם יכולים לבדוק איך כלי ה-MCP מגיבים למיקומים, לאזורי זמן, ללוקאלים ולשיטות אימות שונים של משתמשים ישירות בחלונית הבדיקה.
שינוי ההקשר של הסביבה
כדי לדמות הקשר של משתמש לכלים שרגישים לתאריך, לשעה או למיקום, פועלים לפי השלבים הבאים:
- בחלונית השמאלית, לוחצים על הכרטיסייה Environment.
- בקטע Date and Time, בוחרים Simulated Date ו-Simulated Time כדי לבדוק ביטויי זמן יחסיים (כמו "מחר בבוקר" או "בשבת הקרובה בצהריים").
- בקטע Preferences, בוחרים Language כדי לדמות את הלוקאל של המשתמש (לדוגמה,
en-US). - מריצים הנחיה לבדיקה בחלונית הצ'אט כדי להעריך את הכלי בהקשר המדומה.
- כדי לשחזר את הגדרות ברירת המחדל של הסביבה, לוחצים על איפוס.
הגדרת אימות לקוח
כדי להגדיר או להחליף את שיטת האימות שבה משתמשים במהלך הסשן במצב פיתוח בממשקי Gemini, פועלים לפי השלבים הבאים:
- בחלונית השמאלית, לוחצים על הכרטיסייה Authentication.
- בקטע Client Authentication Configuration, בוחרים באחד ממצבי האימות הבאים:
- Dynamic Client Registration: משתמש בתהליך OAuth כדי לנהל משא ומתן על פרטי הכניסה באופן אוטומטי עם שרת ההרשאות. מידע נוסף זמין במדריך ההטמעה של OAuth 2.1. אם רלוונטי, מזינים את נקודת הקצה בשדה הוספת קישור לאפליקציה בהתאמה אישית.
- רישום לקוח ידני: מאפשר לכם לספק באופן ידני מזהה לקוח וסוד לקוח שנרשמו מראש. מרחיבים את הקטע Advanced Settings כדי להגדיר עוד שינויים בתהליך.
- לוחצים על שמירה וממתינים עד שמופיעה ההודעה נשמר. אחר כך מריצים הנחיה לבדיקה כדי לוודא שהכלים המאומתים פועלים.