MCP מחובר אבל לא עובד? אבחנו את שלב הכשל ב־Mono

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

המדריך עוסק בפתרון תקלות ב־Mono מבית Reunified, שעדיין לא זמין (הצטרפו לרשימת ההמתנה). לחיבור ראשון, השתמשו במדריך הגדרת MCP. כאן המטרה היא להפוך ״זה לא עובד״ מעורפל לתצפית ברורה אחת שאפשר לחזור עליה, בלי לחזור בטעות על פעולת כתיבה.

1. תעדו את התסמין ועצרו ניסיונות חוזרים לא ודאיים

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

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

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

2. בדקו תעבורה לפני החשבון

חיבור HTTP ב־Mono צריך כתובת של שרת MCP, לא דף בית רגיל ולא כתובת API של מודל. השוו את כתובת ה־URL המלאה, כולל הנתיב, לתיעוד העדכני של מפרסם השרת. דף שנפתח בדפדפן מוכיח רק שהדף נגיש, לא ש־MCP עובד שם.

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

כתובת עם localhost מצביעה על המכשיר ששולח את הבקשה. בדקו מהמכשיר עצמו, דרך מסלול נתמך ומחובר. אל תחלישו את בקרות הגישה של שרת שעובד רק כדי שבדיקה תעבור.

3. הפרידו בין הגדרות שנשמרו להרשאה שהושלמה

בדקו באיזו שיטת אימות בחרתם. ״אסימון Bearer״ צריך את האסימון הנכון של השירות בשדה שלו. OAuth צריך את החשבון הנכון, את דרישות השרת וחזרה מלאה ל־Mono; סגירת הדפדפן מוקדם מדי אינה התחברות מוצלחת.

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

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

4. בדקו יכולות ואת המודל שנבחר

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

במיומנות MCP מותקנת, פתחו את החלק ״תצורה״ כדי לראות את הכלים ש־Mono מצא. אם הוא ריק, בדקו את ההתחברות ואם השרת מציג את הכלים שלו; אל תניחו שכל פעולות השירות זמינות. שמירת שרת אינה בדיקת תקינות מלאה.

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

5. בדקו פעולה אחת מוכרת

השתמשו בבקשה לא מזיקה והשוו את התוצאה לשירות המקורי:

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

שגיאה של הכלי עצמו שונה מתוצאה ריקה אבל מוצלחת. שמרו יחד את הסטטוס שהוחזר ואת הטקסט הרלוונטי, בלי סודות.

6. אמתו את התיקון ושמרו רישום לתמיכה

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

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