הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
חומר עזר לפקודה של CLI
נהל שרתי MCP בסביבות Dataverse. הפקודה develop-mcp מספקת אפשרויות לפרסום, ביטול פרסום, אישור, חסימה, אריזה ורישום שרתי MCP לשימוש בסביבות Dataverse.
תפקיד מינימלי נדרש: משתנה לפי תת-פיקוד
Syntax
a365 develop-mcp [command] [options]
אפשרויות
| Option | Description |
|---|---|
-v, --verbose |
הפעלת רישום ארוך |
-?, , -h--help |
הצגת מידע אודות עזרה ושימוש |
develop-mcp list-environments
פרט את כל הסביבות Dataverse הזמינות לניהול שרתי MCP.
a365 develop-mcp list-environments [options]
פקודה זו מציגה את כל סביבות Dataverse שבהן ניתן לנהל שרתי MCP.
list-environments אפשרויות
| Option | Description |
|---|---|
--dry-run |
הצג מה ניתן לעשות מבלי לבצע |
-v, --verbose |
הפעלת רישום ארוך |
-?, , -h--help |
הצגת מידע אודות עזרה ושימוש |
develop-mcp list-servers
פרט שרתי MCP בסביבה Dataverse ספציפית.
a365 develop-mcp list-servers [options]
פקודה זו מציגה את כל שרתי ה-MCP המוצבים כרגע בסביבת Dataverse המוגדרת.
list-servers אפשרויות
| Option | Description |
|---|---|
-e, --environment-id <environment-id> |
מזהה סביבת Dataverse |
--dry-run |
הצג מה ניתן לעשות מבלי לבצע |
-v, --verbose |
הפעלת רישום ארוך |
-?, , -h--help |
הצגת מידע אודות עזרה ושימוש |
develop-mcp publish
פרסום שרת MCP לסביבה Dataverse.
a365 develop-mcp publish [options]
השתמש בפקודה זו כדי לפרסם שרת MCP בסביבת Dataverse שצוינה.
publish אפשרויות
| Option | Description |
|---|---|
-e, --environment-id <environment-id> |
מזהה סביבת Dataverse |
-s, --server-name <server-name> |
שם שרת MCP לפרסום |
-a, --alias <alias> |
כינוי לשרת MCP |
-d, --display-name <display-name> |
שם תצוגה לשרת MCP |
--dry-run |
הצג מה ניתן לעשות מבלי לבצע |
-?, , -h--help |
הצגת מידע אודות עזרה ושימוש |
develop-mcp unpublish
ביטול פרסום של שרת MCP מתוך סביבה Dataverse.
a365 develop-mcp unpublish [options]
השתמש בפקודה זו כדי להסיר שרת MCP מסביבת Dataverse שצוינה.
unpublish אפשרויות
| Option | Description |
|---|---|
-e, --environment-id <environment-id> |
מזהה סביבת Dataverse |
-s, --server-name <server-name> |
שם שרת MCP להסרת פרסום |
--dry-run |
הצג מה ניתן לעשות מבלי לבצע |
-?, , -h--help |
הצגת מידע אודות עזרה ושימוש |
develop-mcp approve
אשר שרת MCP.
a365 develop-mcp approve [options]
פקודה זו מאשרת שרת MCP לשימוש בסביבה.
approve אפשרויות
| Option | Description |
|---|---|
-s, --server-name <server-name> |
שם שרת MCP לאישור |
--dry-run |
הצג מה ניתן לעשות מבלי לבצע |
-?, , -h--help |
הצגת מידע אודות עזרה ושימוש |
develop-mcp block
חסימת שרת MCP.
a365 develop-mcp block [options]
השתמש בפקודה זו כדי לחסום את השימוש בשרת MCP בסביבה שלך.
block אפשרויות
| Option | Description |
|---|---|
-s, --server-name <server-name> |
שם שרת MCP לחסימה |
--dry-run |
הצג מה ניתן לעשות מבלי לבצע |
-?, , -h--help |
הצגת מידע אודות עזרה ושימוש |
develop-mcp package-mcp-server
צור חבילת שרת MCP לשליחה במרכז הניהול של Microsoft.
a365 develop-mcp package-mcp-server [options]
השתמש בפקודה זו כדי ליצור חבילת פריסה לשרת MCP שניתן לשלוח למרכז המנהל של Microsoft.
package-mcp-server אפשרויות
| Option | Description |
|---|---|
--server-name <server-name> |
שם שרת MCP (נדרש) |
--developer-name <developer-name> |
שם תצוגה של Publisher או מפתח (נדרש) |
--icon-url <icon-url> |
כתובת URL ציבורית לאייקון PNG עבור שרת MCP (נדרש) |
--output-path <output-path> |
תיקיית היעד עבור חבילת ZIP שנוצרה (נדרש) |
--dry-run |
הצג מה ניתן לעשות מבלי לבצע |
-?, , -h--help |
הצגת מידע אודות עזרה ושימוש |
develop-mcp register-external-mcp-server
רשום שרת MCP חיצוני עם Entra, OAuth חיצוני, מפתח API או ללא אימות.
a365 develop-mcp register-external-mcp-server [options]
השתמש בפקודה זו כדי לרשום שרת MCP חיצוני (צד שלישי) עם הדייר שלך. הפקודה יוצרת את רישומים לאפליקציית Microsoft Entra שהפלטפורמה צריכה, קוראת לפלטפורמת Agent 365 להוסיף את שרת ה-MCP, ומגדירה הפניה מחדש של URI והרשאות API בהרשמות האפליקציות החדשות.
שם השרת חייב להתחיל בקידומת ext_ ולהיות באורך לכל היותר 20 תווים, לדוגמה ext_MyServer. שמות הכלים חייבים להתאים בדיוק לשמות שנחשפו על ידי שרת MCP המרוחק. שמות לא תואמים גורמים לכישלון בקריאות כלים בזמן ריצה.
ניתן לספק פרמטרים בשלוש דרכים:
- העבר אותם כאפשרויות שורת פקודה.
- ספק קובץ JSON עם
--input-file. אפשרויות שורת הפקודה מחליפות ערכים מהקובץ. ראוregister-external-mcp-server-sample.jsonבתבניות ה-CLI את מבנה הקבצים. - השמיטו כל ערך נדרש שיוגש באופן אינטראקטיבי.
לאחר שההרשמה תצליח, בקש ממנהל הדיירים שלך לאשר את שרת ה-MCP החדש לפני שהסוכנים יוכלו להשתמש בו. אם נרשמת ל- ExternalOAuth, הוסף גם את ה-URI המוצג לאפליקציית IDP החיצונית שלך.
Important
אם ההרשמה נכשלת לאחר יצירת הרשמות לאפליקציית Microsoft Entra, האפליקציות לא יוחזרו אוטומטית. מחק אותם ידנית בפורטל Azure לפני שאתה מנסה שוב.
register-external-mcp-server אפשרויות
חלק מהאפשרויות נדרשות רק לסוגי אימות ספציפיים, כפי שמתואר בעמודת התיאור.
| Option | Description |
|---|---|
-s, --server-name <server-name> |
שם שרת MCP. חייב להתחיל עם ext_ ולהיות לכל היותר 20 תווים, למשל. ext_MyServer |
-u, --server-url <server-url> |
כתובת שרת MCP מרוחקת. חייב להיות כתובת URL תקינה של HTTP או HTTPS |
-a, --auth-type <auth-type> |
סוג אימות: EntraOAuth, ExternalOAuth, APIKey, או NoAuth |
--publisher <publisher> |
שם Publisher (משמש במטא-דאטה של חבילות) |
--description <description> |
תיאור שרת (בשימוש במטא-דאטה של חבילה) |
--tools <tools> |
לדוגמה, רשימה מופרדת בפסיקים של שמות כלים שנחשפו על ידי שרת זה tool1,tool2,tool3 |
-f, --input-file <input-file> |
נתיב לקובץ JSON עם פרמטרי הרישום |
--remote-scopes <remote-scopes> |
לדוגמה, טווחים לשרת api://{appId-guid}/{scopeName}MCP המרוחק . בשימוש עם EntraOAuth |
-t, --tenant-id <tenant-id> |
מזהה שוכר של Entra לרישום האפליקציה. ברירת מחדל לדייר הנוכחי az login |
--service-tree-id <service-tree-id> |
ServiceTree ID להרשמת אפליקציית Entra. נדרש בדיירים תאגידיים של Microsoft |
--idp-authorization-url <url> |
כתובת ההרשאה החיצונית של OAuth. נדרש כאשר --auth-type הוא ExternalOAuth |
--idp-token-url <url> |
כתובת אסימון חיצונית של OAuth. נדרש כאשר --auth-type הוא ExternalOAuth |
--idp-scopes <scopes> |
טווחים חיצוניים ל-OAuth. נדרש כאשר --auth-type הוא ExternalOAuth |
--idp-client-id <client-id> |
מזהה לקוח חיצוני OAuth. נדרש כאשר --auth-type הוא ExternalOAuth |
--idp-client-secret <client-secret> |
סוד לקוח חיצוני של OAuth. נדרש כאשר --auth-type הוא ExternalOAuth |
--api-key-location <location> |
מיקום מפתח ה-API: Header או Query. נדרש כאשר --auth-type הוא APIKey |
--api-key-name <name> |
לדוגמה, פרמטר מפתח API או שם כותרת, X-API-Key או token. נדרש כאשר --auth-type הוא APIKey |
--dry-run |
הצג מה ניתן לעשות מבלי לבצע |
-v, --verbose |
הפעלת רישום ארוך |
-?, , -h--help |
הצגת מידע אודות עזרה ושימוש |