מדריך לחיבור Open WebUI עם שרתי MCP

 

טֶכנוֹלוֹגִיָה פרוטוקול הקשר מודל (MCP) זה מאפשר למודלים של שפות בינה מלאכותית לחרוג מסביבת הצ'אט ולקיים אינטראקציה עם כלים חיצוניים ונתונים בזמן אמת. לכן, חיבור Open WebUI לשרתי MCP זה רעיון מצוין אם אתם רוצים לקחת את המשחק שלכם לשלב הבא.

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

כיצד לחבר את Open WebUI עם שרתי MCP

החל מגרסה 0.6.31, Open WebUI כבר כולל תמיכה מקורית עבור MCPעם זאת, ישנה הסתייגות חשובה: זה עובד רק באמצעות HTTP ניתן להזרמהמשמעות הדבר היא שלא ניתן להתחבר ישירות לשרת המשתמש ב-stdio (תקן קלט/פלט), מכיוון שארכיטקטורת האינטרנט של הפלטפורמה דורשת תקשורת מבוססת HTTP כדי לנהל בצורה מאובטחת משתמשים וסשנים מרובים.

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

בנוגע לאימות בעת חיבור Open WebUI לשרתי MCP, ישנן מספר אפשרויות בהתאם למיקום השרת. אם מדובר בהגדרה מקומית ובעלת סיכון נמוך, בחר "אַף לֹא אֶחָד"אבל היזהרו: אם תבחרו באפשרות "Bearer" ותשאירו את המפתח ריק, שרתים רבים ידחו את החיבור. עבור סביבות מקצועיות יותר, תוכלו להשתמש ב- OAuth 2.1, באופן סטטי (עם מזהה לקוח וסוד) או דינמי, מה שמאפשר לבינה מלאכותית לבצע אימות בצורה מאובטחת לפני גישה לנתונים.

שימוש ב-MCPO כגשר לשרתים מקומיים

מה קורה אם הורדת שרת MCP שמשתמש ב-stdio ולא ב-HTTP? כאן הדברים מתחילים להיות מעניינים. MCPO (תזמור פרוטוקול הקשר מודל)תוכנית זו פועלת כפרוקסי שמתרגם את השרתים "המסורתיים" הללו לפורמט OpenAPI תואם ל-HTTP, מה שגורם ל-Open WebUI לראות אותם ככלים סטנדרטיים.

כדי להגדיר מערכת זו ולחבר את Open WebUI לשרתי MCP, הדרך הקלה ביותר היא להשתמש ב-Docker. ראשית, עליך לפרוס את המכולה של פתח את ממשק המשתמש של WebUI עם Ollama ואז אתה מפעיל את מיכל ה-MCPO. האחרון זקוק לקובץ בשם config.json היכן שאתה מגדיר אילו שרתי MCP ברצונך לחבר. לאחר יצירת הקובץ במחשב שלך, עליך להעתיק אותו לאמצעי האחסון של המכולה באמצעות פקודות Docker כדי שהמתזמר ידע אילו כלים להפעיל.

ברגע ש-MCPO פועל על פורט 8000, עליך לחזור ל-Open WebUI ולהוסיף את הכלי שמצביע על הכתובת. http://host.docker.internal:8000אם יש לך מספר שרתים שתצורתם נקבעה ב-JSON, תצטרך להוסיף כל אחד מהם, תוך ציון הנתיב הספציפי שלו, לדוגמה, הוספת נקודת הקצה של שרת התיעוד של Microsoft לסוף כתובת ה-URL.

קונפיגורציה ואופטימיזציה של המודל

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

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

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

לאחר חיבור Open WebUI עם שרתי MCP ותצורה נכונה של זרימת העבודה בין המודל, תזמורת MCPO וממשק Open WebUI, ניתן להפוך חלון צ'אט פשוט למרכז פיקוד המסוגל להריץ סקריפטים, להתייעץ עם מדריכים טכניים ולנהל נתונים מורכבים באמצעות תקן Model Context Protocol, ובכך להבטיח תקשורת חלקה ואבטחה שתמיד נמצאות תחת שליטת המנהל.