איך לחבר כלי MCP בטלפון ובמחשב
הבדלים בין חיבורי MCP מקומיים ומרוחקים, בחירת הרשאות, בדיקת כלי אחד ופתרון בעיות התחברות.
עוזר AI שימושי יותר כשהוא יכול לגשת למידע הדרוש למשימה: לקרוא דיווח תקלה בפרויקט, למצוא מסמך או לבדוק יומן. Model Context Protocol, או בקיצור MCP, מספק לאפליקציות דרך משותפת להתחבר ליכולות האלה.
כל שרת שמחברים הוא גם מקום חדש שאליו המידע יכול להגיע. מתחילים בשירות אחד, משימה ברורה אחת ומינימום ההרשאות שמספיק כדי לבצע אותה. חיבור אחד שעובד קל יותר להבנה מרשימה ארוכה של אינטגרציות שלא השתמשו בהן.
מה החיבור מספק
מדריך הארכיטקטורה של MCP מסביר את תפקידי המארח, הלקוח והשרת. בזמן ההגדרה, השאלה המעשית היא מה השרת הנבחר מציע: כלים להפעלה, משאבים לקריאה, הנחיות לשימוש חוזר או שילוב שלהם.
חיבור לא כולל אוטומטית את כל התכונות של השירות שמאחוריו. שרת יומן שמציג אירועים לא בהכרח יכול ליצור הזמנות. קוראים את רשימת היכולות של השרת עצמו ובודקים מי מפרסם אותו. בוחרים מפרסם שאפשר לזהות, עם הוראות התקנה עדכניות והסבר ברור על האופן שבו הוא מטפל במידע.
חשוב להפריד בין MCP למודל. המודל מייצר תשובות; שרת MCP נותן גישה למשהו מחוץ לשיחה. שימוש במודל מקומי לא הופך שרת מרוחק למקומי.
בחירה בין HTTP מרוחק ל־stdio מקומי
מפרט שיטות התעבורה מתאר שתי דרכים להתחבר: Streamable HTTP ו־stdio. חיבור HTTP מרוחק משתמש בכתובת של שרת. חיבור stdio מפעיל תוכנה על אותה מכונה ומדבר איתה דרך הקלט והפלט שלה.
בטלפון, חיבור מרוחק הוא בדרך כלל נקודת ההתחלה. פקודה שמפעילה שרת במחשב לא תרוץ באייפון רק כי מדביקים אותה באפליקציה לנייד. האם פקודות מקומיות עובדות תלוי באפליקציה ובמערכת ההפעלה.
חשוב גם לזכור ש־localhost הוא המכשיר ששולח את הבקשה. כתובת שעובדת במחשב הנייד לא מצביעה על המחשב הזה כשפותחים אותה בטלפון. משתמשים בשיטת חיבור שדורשת התחברות. לא פותחים שירות מקומי לא מוגן לאינטרנט רק כדי שדוגמה תעבוד.
בדיקת החשבון וההרשאות
לפני הכניסה לחשבון, יש להשוות את כתובת השרת לתיעוד של המפעיל שלו. אם משתמשים ב־OAuth, בודקים את החשבון ואת הגישה המבוקשת בדף ההרשאה. חשבון עבודה וחשבון אישי יכולים להכיל נתונים שונים גם כששם האפליקציה זהה.
בהגדרה מבוססת טוקן, משתמשים בטוקן שמכסה רק את השירות והמשימה הנדרשים. מזינים אותו רק בשדה הטוקן של האפליקציה. לא מדביקים טוקנים בצ׳אט, בצילום מסך או במסמך משותף לפתרון תקלות. מדריך ההרשאות של MCP נותן רקע טכני על תהליך ההתחברות.
קריאת נתונים ושינוי נתונים הן הרשאות נפרדות. מתחילים בגישת קריאה בלבד אם השירות מציע אותה. מוסיפים גישת כתיבה רק כשיש פעולה מסוימת לבדוק, במקום שאפשר לבדוק אחר כך.
בדיקת פעולה קטנה עם תוצאה נראית
נניח שהמטרה היא למצוא דיווחים פתוחים בפרויקט. משתמשים בפרויקט הדגמה ללא מידע רגיש ומבקשים:
הצג עד חמישה דיווחים פתוחים בפרויקט ההדגמה. כלול כותרת וקישור לכל דיווח. אל תיצור, תערוך או תסגור דבר.
בודקים את התוצאה בשירות עצמו. מוודאים שהפרויקט, הקישורים והחשבון הם אלה שהתכוונו אליהם. אם לא חוזר כלום, מבררים אם הפרויקט ריק, אם חסרה גישה או אם הבקשה נכשלה.
אם נדרשת אחר כך פעולת כתיבה, משתמשים בפריט בדיקה זמני. מבקשים שינוי אחד מדויק, בודקים את האישור ומוודאים את התוצאה בשירות המקורי. מחיקות ושליחת הודעות לאנשים אחרים נשארות מחוץ לבדיקה הראשונה.
זיהוי השלב שלא הצליח
קל יותר לפתור בעיה כשמזהים את השלב:
- אין חיבור: בודקים כתובת, סוג תעבורה, רשת והאם השרת פועל.
- הכניסה לחשבון חוזרת: בודקים חשבון נבחר, תוקף ההרשאה ודרישות מתועדות לכתובת החזרה.
- יש חיבור אך אין כלים: בודקים אילו יכולות השרת מספק ומה החשבון רשאי לגשת אליו.
- כלי נכשל: בודקים קלט נדרש, מגבלות שירות והודעת שגיאה מהשירות עצמו.
כשמבקשים עזרה, משתפים את השגיאה בלי פרטים פרטיים, יחד עם הגרסאות של האפליקציה והשרת. מסירים טוקנים, תוכן של מסמכים פרטיים ומזהי חשבון. לא מנסים שוב פעולת כתיבה לפני שבודקים אם הניסיון הקודם הצליח.
תחזוקת חיבור שאפשר לנהל
שומרים רשומה קצרה של השירות, הבעלים שלו, החשבון שבו השתמשו, הגישה שניתנה ואיך מבטלים אותה. בודקים שוב את ההרשאות אחרי שמוסיפים יכולות. הסרת חיבור באפליקציה וביטול הגישה בשירות הם שני צעדים שונים. כדי לסיים את הגישה לגמרי, משתמשים גם בהגדרות של השירות עצמו.
ב־Mono מוסיפים שרתי MCP בהגדרות, ואז באינטגרציות: לפי כתובת השרת או, אם המכשיר תומך בכך, בפקודה מקומית, עם התחברות דרך OAuth או טוקן. שרתים מחוברים יכולים גם להפעיל skills. לפני חיבור חומר רגיש, כדאי לקרוא את מדריך הפרטיות של AI: ספק כלי הוא עוד משתתף במסלול הנתונים. Mono נמצאת כרגע ברשימת המתנה. אפשר להצטרף לרשימה לקבלת עדכונים.
