הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
הערה
- הכלים והדוגמאות בתיעוד זה ממחישים את היכולות הנוכחיות. שמות הכלים, תיאורים, פרמטרים, פורמטי תגובה והפונקציונליות הזמינה יכולים להשתנות עם הזמן.
- כשאתה בונה סוכנים, אינטגרציות או לוגיקת אורקסטרציה, אל תקודד תלות קשיחת על שמות כלים מסוימים, מבני פרמטרים, מטא-דאטה של כלי או סכימות תגובה. במקום זאת, עצב את הפתרון שלך כך שיגלה וישתמש בכלים זמינים בזמן הריצה.
- ככל שהפלטפורמה מתפתחת, Microsoft עשויה להוסיף, להסיר, לשנות שם או לשנות כלים ומטא-דאטה של כלים. עיצוב לפי יכולות ולא לפי מזהי כלים ספציפיים מסייע לשמור על תאימות בין עדכוני השירות.
היכולת הזו פועלת מאחורי הקלעים כאשר בודקים חיבור לשרת כלי MCP חיצוני מווידג'ט ניהול הרישום.
מה הוא עושה
כאשר אתה בוחר Test Connection בטופס רישום שרת MCP, כלי זה מאשר שסוכן השירות יכול להגיע לנקודת הקצה החיצונית של השרת. הוא מבצע בדיקת אבטחה על ה-URL, מקבל אסימון אימות באמצעות הטווח המוגדר ושולח בקשת כלים/רשימה לשרת.
אם החיבור מצליח, הכלי מחזיר את רשימת הכלים שהשרת מציג. ניתן לבחור ולשמר את תמונת הכלי הזו עם ההרשמה. אם החיבור נכשל, הכלי מחזיר קוד אימות או חיבור יציב שהווידג'ט ממפה לעותק מקומי; הוא לא מהדהד את טקסט התגובה של נקודת קצה או תלות.
נסה הנחיות כמו
לא ישים. הכלי הזה נקרא אוטומטית כאשר בודקים חיבור מווידג'ט הניהול. הוא לא מופעל על ידי הקלדת הנחיה.
מה שתראו בצ'אט
ווידג'ט ההרשמה מציג את תוצאת הבדיקה בתוך הקו. בהצלחה, אתה רואה רשימה של כלים זמינים מהשרת עם שמותיהם ותיאוריהם. במקרה של כישלון, אתה רואה אימות מקומי או שגיאת חיבור.
עצות שימושיות
- תמיד תבדוק לפני שאתה שומר. צילום הכלי מבדיקה מוצלחת נדרש לרישום חדש.
- למבחן יש פסק זמן של 15 שניות. אם השרת איטי בהגיב, הוא עלול להיכשל גם אם השרת טכנית נגיש.
- כשלים באימות בדרך כלל אומרים שהטווח האימות המוגדר לא תואם לרישום אפליקציית Entra של השרת.
- אם הבדיקה מצליחה, היא גם חותמת על רשומת הרישום: "הבדיקה האחרונה" (Last Tested).
מה קורה הלאה?
לאחר בדיקה מוצלחת, אפשר:
- שמור את הרישום הזה.
- בדוק את הכלים שהשרת הזה מספק.
האם זה משנה את הנתונים?
כן, זה יכול לשנות נתונים.
בדיקה מוצלחת חותמת את חותמת הזמן "האחרונה שנבדקה" על רשומת הרישום. הוא לא משנה את תצורת הרישום.
דרישות מוקדמות
כלי זה זמין בשרת MCP של Dynamics 365 Customer Service. ראו את הערת הזמינות בראש דף זה לפרטים. אין צורך בתצורה נוספת.
סיכום הכלים
| מאפיין | ערך: |
|---|---|
| שם המשתמש | בדיקת חיבור MCP חיצוני |
| שם הכלי הפנימי | test_mcp_registration_connection |
| מטרה | בודק קישוריות לנקודת קצה חיצונית של שרת MCP לפני שמירת רישום |
התנהגות כלי
בודק את הקישוריות לנקודת קצה חיצונית של שרת MCP לפני שמירת הרשמה. מאמת את כתובת ה-URL של נקודת הקצה מול הגבלות SSRF, רוכש טוקן OBO באמצעות טווח האימות שצוין, ומוציא tools/list בקשה לאמת שהשרת מגיב. זהו כלי תמיכה בווידג'טים שמופעל אוטומטית מווידג'ט ניהול הרישום.
ביאורים
| ביאור | ערך: | משמעות |
|---|---|---|
readOnlyHint |
false |
ניתן לחתום lastTestedAt על הרישום כאשר registrationId הוא מסופק. |
destructiveHint |
false |
בדיקות לא מסירות או משחיתות נתונים. |
idempotentHint |
false |
בדיקה מוצלחת יכולה לכתוב חותמת זמן חדשה lastTestedAt . |
openWorldHint |
לא הוגדר | משתמש כברירת מחדל. |
מושגי קלט
נקודת הקצה
| קלט | תיאור | נדרש |
|---|---|---|
endpoint |
endpoint (כתובת HTTPS, נדרש). כתובת השרת של MCP לבדיקה. |
כן |
טווח אימות
| קלט | תיאור | נדרש |
|---|---|---|
authScope |
authScope (מיתר נדרש). טווח היקוד של Entra OBO לרכישת טוקנים (לדוגמה, api://contoso-app/.default). |
כן |
מזהה רישום
| קלט | תיאור | נדרש |
|---|---|---|
registrationId |
registrationId (UUID, אופציונלי). כאשר הוא מסופק, חותמות lastTestedAt על רשומת הרישום לאחר בדיקה מוצלחת. |
לא |
כתובת הארגון
| קלט | תיאור | נדרש |
|---|---|---|
orgUrl |
orgUrl (אופציונלי). מחליף את כתובת ה-URL הסביבתית שנבחרה כרגע. |
לא |
תגובה והתנהגות ממשק משתמש
כלי MCP זה נתמך על ידי אפליקציית MCP.
סוג תגובה
עדכון ווידג'ט עם תוצאות בדיקות
מחזיר את ספירת הכלים שהתגלתה ואת תמונת הכלים בהצלחה. כישלונות אימות חוזרים RegistrationValidationFailed; כישלונות לאחר האימות מחזירים ConnectionTestFailedאת .
הווידג'ט ממפה את הקודים היציבים לעותק שגיאה מקומי.
הערות ניתוב
הכלי הזה נקרא בלעדית על ידי הווידג'ט manage_mcp_registration . אל תפעיל את זה ישירות.
כלים קשורים
| כלי | קשר |
|---|---|
manage_mcp_registration |
כלי המשגר שפותח את ווידג'ט ההרשמה |
save_mcp_registration |
שומר את הרישום לאחר בדיקה מוצלחת |
delete_registration |
מסיר רישום MCP כאשר type הוא "mcp" |
סיווג מוטציות נתונים
בעיקר לקריאה בלבד עם תופעות לוואי אופציונליות. בדיקת הקישוריות עצמה היא לקריאה בלבד. כאשר registrationId ניתנת והבדיקה מצליחה, היא חותמת lastTestedAt על רשומת הרישום.