หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
การอ้างอิงคําสั่ง Agent 365 CLI
จัดการเซิร์ฟเวอร์ MCP ในสภาพแวดล้อมแบบผกผันข้อมูล คําสั่งนี้ develop-mcp มีตัวเลือกในการเผยแพร่ ยกเลิกการเผยแพร่ ลงทะเบียน และให้สิทธิ์เอเจนต์สําหรับเซิร์ฟเวอร์ MCP เพื่อใช้งานในสภาพแวดล้อม Dataverse
Note
Agent 365 CLI จะไม่รวม develop-mcp approveคําสั่ง , develop-mcp block, และ develop-mcp package-mcp-server อีกต่อไป ขณะนี้ผู้ดูแลระบบผู้เช่าดําเนินการอนุมัติและบล็อกเซิร์ฟเวอร์ในศูนย์การจัดการ Microsoft — คําขอที่รอดําเนินการจะได้รับการตรวจสอบในหน้า ตัวแทนที่ร้องขอ CLI ไม่สร้างแพคเกจเซิร์ฟเวอร์ MCP สําหรับการส่งศูนย์การจัดการอีกต่อไป ผู้ดูแลระบบเตรียมความพร้อมและจัดการเซิร์ฟเวอร์โดยตรงในศูนย์การจัดการ
จําเป็นต้องมีบทบาทขั้นต่ํา: แตกต่างกันไปตาม command
Syntax
a365 develop-mcp [command] [options]
ตัวเลือก
| Option | Description |
|---|---|
-v, --verbose |
เปิดใช้งานการบันทึกแบบอย่างละเอียด |
-?, -h, --help |
แสดงวิธีใช้และข้อมูลการใช้งาน |
develop-mcp evaluate
ประเมินเซิร์ฟเวอร์ MCP ของคุณเทียบกับแนวทางปฏิบัติที่ดีที่สุดทางวิทยาศาสตร์เพื่อประเมินความพร้อมในการผลิต เครื่องมือนี้แสดงรายงานการประเมินที่ครอบคลุมพร้อมคะแนน คําอธิบาย และรายการดําเนินการ คําสั่งจะค้นพบเครื่องมือที่เซิร์ฟเวอร์ MCP เปิดเผย เรียกใช้ชุดของการตรวจสอบความหมายที่กําหนดและให้คะแนนด้วย AI กับสคีมา และสร้างรายงาน HTML ที่ให้คะแนนคุณภาพสคีมาและแสดงรายการการดําเนินการที่จัดลําดับความสําคัญสําหรับการปรับปรุง
a365 develop-mcp evaluate --server-url <server-url> [--auth-token <auth-token>] [options]
evaluate ตัวเลือก
| Option | Description |
|---|---|
-u, --server-url <server-url> |
Required. URL ปลายทาง HTTP ที่สตรีมได้ของเซิร์ฟเวอร์ MCP (โดยทั่วไปจะลงท้ายด้วย /mcp) |
--auth-token <auth-token> |
Optional. จําเป็นเฉพาะเมื่อเซิร์ฟเวอร์ MCP ต้องการการรับรองความถูกต้อง โทเค็นผู้ถือสําหรับเซิร์ฟเวอร์ ต้องการ A365_MCP_AUTH_TOKEN ตัวแปรสภาพแวดล้อม โทเค็นที่ส่งผ่านบนบรรทัดคําสั่งจะมองเห็นได้เพื่อประมวลผลรายการและประวัติเชลล์ |
-o, --output-dir <output-dir> |
ไดเร็กทอรีสําหรับรายการตรวจสอบและไฟล์รายงาน ค่าเริ่มต้นเป็นไดเร็กทอรีปัจจุบัน (.) |
--eval-engine <eval-engine> |
ตัวแทนการเข้ารหัสในเครื่องใดให้คะแนนการตรวจสอบความหมาย: auto (ค่าเริ่มต้น ลอง GitHub Copilot ตามด้วย Claude Code), github-copilot, claude-code หรือ none (ข้ามการให้คะแนน AI และคาดหวังรายการตรวจสอบที่ให้คะแนนไว้ล่วงหน้า) |
-v, --verbose |
เปิดใช้งานการบันทึกแบบอย่างละเอียด |
-?, -h, --help |
แสดงข้อมูลความช่วยเหลือและการใช้งาน |
evaluate ตัว อย่าง เช่น
ประเมินเซิร์ฟเวอร์ภายในด้วยการเลือกเครื่องยนต์อัตโนมัติ:
a365 develop-mcp evaluate --server-url "http://localhost:5000/mcp"
ประเมินเซิร์ฟเวอร์ที่รับรองความถูกต้อง ด้วยโทเค็นที่ให้มาผ่านตัวแปรสภาพแวดล้อมและสิ่งประดิษฐ์ที่เขียนลงในโฟลเดอร์ย่อย:
$env:A365_MCP_AUTH_TOKEN = "<bearer-token>"
a365 develop-mcp evaluate --server-url "https://my-mcp-server.contoso.com/mcp" --output-dir "./eval"
สร้างรายการตรวจสอบเท่านั้น แล้วให้คะแนนด้วย LLM ของคุณเอง:
a365 develop-mcp evaluate --server-url "https://my-mcp-server.contoso.com/mcp" --eval-engine none
บังคับกลไกการให้คะแนนเฉพาะ:
a365 develop-mcp evaluate --server-url "http://localhost:5000/mcp" --eval-engine claude-code
ตัวแปรสภาพแวดล้อม evaluate
ใช้ตัวแปรสภาพแวดล้อมต่อไปนี้เพื่อให้การรับรองความถูกต้องและเลือกควบคุมโมเดลที่กลไกจัดการการให้คะแนนภายในแต่ละเครื่องใช้
| Environment variable | Purpose |
|---|---|
A365_MCP_AUTH_TOKEN |
โทเค็นแบเรียร์สําหรับเซิร์ฟเวอร์ MCP ใช้เมื่อคุณไม่ส่ง --auth-token. ใช้ตัวแปรนี้แทนแฟล็ก เพราะจะช่วยให้โทเค็นไม่ปรากฏในรายการกระบวนการและประวัติเชลล์ |
A365_EVAL_COPILOT_MODEL |
แทนที่โมเดล GitHub Copilot ต้องการรหัสโมเดลที่แม่นยํา เช่น claude-haiku-4.5. |
A365_EVAL_CLAUDE_MODEL |
แทนที่โมเดล Claude Code รับนามแฝงโมเดล (เช่น haiku) หรือรหัสโมเดลเต็มรูปแบบ |
develop-mcp grant-agents-access
ให้สิทธิ์เซิร์ฟเวอร์ MCP แบบนํามาเอง (BYO) สําหรับตัวตนของตัวแทนที่ขาดสิทธิ์นั้น
a365 develop-mcp grant-agents-access --mcp-server-name <NAME> --agent-blueprint-id <GUID> [options]
สิทธิ์ขั้นต่ําที่ต้องการ: Global Administrator (หรือบทบาทอื่นที่มีสิทธิ์สร้างสิทธิ์ OAuth2 ทั่วทั้ง tenant)
ใช้คําสั่งนี้เพื่อค้นหาและแก้ไขตัวตนของเอเจนต์ที่ไม่สามารถเรียกใช้เซิร์ฟเวอร์ MCP แบบนํามาเอง (BYO) ได้เพราะขาด Tools.ListInvoke.All สิทธิ์สําหรับมัน คําสั่งจะแสดงอินสแตนซ์ของเอเจนต์ของบลูพริ้นท์ที่ระบุที่ขาดสิทธิ์ จากนั้นให้คุณเลือกว่าจะให้สิทธิ์กับอันไหน
ชื่อเซิร์ฟเวอร์ MCP จะแยกเป็นแอปพลิเคชัน Microsoft Entra โดยที่ - BYOต่อท้ายชื่อ ตัวอย่างเช่น ext_Learn1 จะแก้ไขเป็น ext_Learn1 - BYO. สิทธิ์นี้เองเป็นสิทธิ์ OAuth2 ที่ได้รับมอบหมายทั่วAllPrincipalsทั้ง tenant () บน service principal ของแอปพลิเคชันนั้น ดังนั้นจึงใช้กับทุกอินสแตนซ์เอเจนต์ปัจจุบันและอนาคตของแบบแปลน ไม่ใช่แค่รายการที่แสดงในเวลารันไทม์
โดยทั่วไปคุณไม่รู้ GUID ของแบบแปลนล่วงหน้า การผ่าน--agent-blueprint-idโดยไม่มีค่า หรือค่าที่ไม่ถูกต้อง จะพิมพ์ชื่อและรหัสบลูพริ้นท์ของ Microsoft โดยตรงเพื่อให้คุณค้นหาได้ การผ่าน --help จะพิมพ์รายชื่อเดียวกัน
หลังจากคําสั่งรายงานว่าเอเจนต์ขาดสิทธิ์ ให้ป้อน all เพื่อมอบสิทธิ์ให้กับทุกอินสแตนซ์ที่แสดง พร้อมรายการตัวเลขที่แสดงด้วยเครื่องหมายจุลภาค (เช่น 1,3) เพื่ออนุญาตสิทธิ์ให้กับอินสแตนซ์เฉพาะ หรือกด Enter เพื่อข้ามการอนุญาต Pass --yes to grant กับทุกอินสแตนซ์ที่ระบุโดยไม่ต้องแจ้ง เช่น ในสคริปต์
หากมีแอปพลิเคชัน Entra มากกว่าหนึ่งตัวที่ใช้ชื่อแสดงเดียวกัน <name> - BYO คําสั่งจะแสดงรายชื่อการจับคู่ทั้งหมดและถามว่าจะใช้ชื่อใดแทนการเดา
คําสั่งนี้ไม่ได้ใช้แอปไคลเอนต์ที่ตั้งค่าไว้ใน a365.config.json. แทนที่จะเป็นเช่นนั้น มันจะลงชื่อเข้าใช้ด้วยแอปพลิเคชัน Microsoft Graph Command Line Tools (14d82eec-204b-4c2f-b7e8-296a70dab67e) และร้องขอขอบเขตที่มอบหมายจาก Microsoft Graph ดังต่อไปนี้:
Application.Read.AllAgentIdentity.Read.AllDelegatedPermissionGrant.ReadWrite.All
ครั้งแรกที่คุณรันคําสั่งใน tenant คุณจะเห็นข้อความแจ้งความยินยอมของผู้ดูแลระบบสําหรับขอบเขตเหล่านี้ ผู้ดูแลระบบระดับโลกหรือผู้ดูแลระบบบทบาทพิเศษต้องมอบขอบเขตเหล่านี้ให้กับแอปพลิเคชัน Microsoft Graph Command Line Tools สําหรับองค์กร หลังจากได้รับความยินยอม แต่ละรันต้องการเพียงการลงชื่อเข้าใช้ครั้งเดียว หากคําสั่งไม่สามารถรับโทเค็นได้ ข้อความแสดงข้อผิดพลาดจะระบุชื่อแอปพลิเคชันและขอบเขตที่คําสั่งร้องขอ
grant-agents-access ตัวเลือก
| Option | Description |
|---|---|
--agent-blueprint-id <agent-blueprint-id> |
รหัสบลูปริ้นท์ (GUID) ของเอเจนต์สําหรับอินสแตนซ์เอเจนต์เพื่อตรวจสอบ หากคุณละเว้นตัวเลือกนี้หรือให้ค่าที่ไม่ถูกต้อง คําสั่งจะพิมพ์ชื่อบลูพริ้นท์และรหัสของฝ่ายแรก |
-s, --mcp-server-name <mcp-server-name> |
Required. ชื่อเซิร์ฟเวอร์ MCP แอปพลิเคชัน Entra จะดําเนินการเป็น <name> - BYO. |
--tenant-id <tenant-id> |
Azure ID ผู้เช่า AD ตั้งค่าเริ่มต้นเป็นบริบท Azure CLI ปัจจุบัน |
-y, --yes |
ให้สิทธิ์ที่ขาดหายไปแก่อินสแตนซ์เอเจนต์ทุกตัวที่ระบุโดยไม่ต้องแจ้ง |
--device-code |
ใช้การตรวจสอบสิทธิ์โค้ดอุปกรณ์แทนการไหลของเบราว์เซอร์แบบโต้ตอบ (WAM broker บน Windows) ใช้เมื่อ WAM ไม่สามารถแสดงหน้าต่างลงชื่อเข้าใช้ได้ เช่น เทอร์มินัลฝังตัวหรือเทอร์มินัลระยะไกล เปิด https://microsoft.com/devicelogin ในเบราว์เซอร์ของคุณ |
--dry-run |
รายงานว่าเอเจนต์ใดขาดสิทธิ์โดยไม่อนุญาต |
-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> |
ID สภาพแวดล้อม Dataverse |
--dry-run |
แสดงสิ่งที่จะทําโดยไม่ต้องดําเนินการ |
-v, --verbose |
เปิดใช้งานการบันทึกแบบอย่างละเอียด |
-?, -h, --help |
แสดงวิธีใช้และข้อมูลการใช้งาน |
develop-mcp publish
เผยแพร่เซิร์ฟเวอร์ MCP ไปยังสภาพแวดล้อม Dataverse
a365 develop-mcp publish [options]
ใช้คําสั่งนี้เพื่อเผยแพร่เซิร์ฟเวอร์ MCP ไปยังสภาพแวดล้อม Dataverse ที่ระบุ
Important
การเผยแพร่เซิร์ฟเวอร์ MCP จะไม่อนุมัติ การเผยแพร่จะส่งเซิร์ฟเวอร์ไปยัง tenant ของคุณและสร้างคําขออนุมัติที่รอดําเนินการเท่านั้น ก่อนที่เอเจนต์ใด ๆ จะสามารถใช้เซิร์ฟเวอร์ได้ ผู้ดูแลระบบผู้เช่าต้องอนุมัติในหน้าเครื่องมือที่ร้องขอในศูนย์ผู้ดูแลระบบ ศูนย์การจัดการ Microsoft 365 จนกว่าผู้ดูแลระบบจะอนุมัติคําขอ เซิร์ฟเวอร์จะยังคงไม่พร้อมใช้งานสําหรับเอเจนต์ เมื่อคําสั่งสําเร็จ CLI จะพิมพ์ข้อความเตือนให้ขอให้ผู้ดูแลระบบผู้เช่าอนุมัติเซิร์ฟเวอร์
เมื่อคุณเผยแพร่ CLI จะสร้างการลงทะเบียนแอป Microsoft Entra ต่อไปนี้ใน tenant ของคุณ:
| App registration | Purpose | When created |
|---|---|---|
<server-name>-PublicClients |
ถือสิทธิ์ OAuth ที่โฮสต์ไคลเอนต์ (เช่น Visual Studio Code และ Microsoft Copilot CLI) ใช้เพื่อเรียกใช้เซิร์ฟเวอร์ MCP ที่เผยแพร่ | CLI จะสร้างแอปนี้สําหรับทุกเซิร์ฟเวอร์ |
<server-name>-A365Proxy |
ทําหน้าที่เป็นแอปไคลเอนต์ลับที่มีความลับของไคลเอนต์ CLI จะส่งข้อมูลรับรองของแอปไปยังแพลตฟอร์ม ซึ่งแพลตฟอร์มจะใช้ข้อมูลเหล่านั้นเพื่อสร้างตัวเชื่อมต่อ Power Platform สําหรับเซิร์ฟเวอร์ | CLI จะสร้างแอปนี้เฉพาะสําหรับเซิร์ฟเวอร์ MCP แบบกําหนดเอง (ที่ไม่ใช่ Dataverse) เท่านั้น เซิร์ฟเวอร์ Dataverse ของฝ่ายแรก เช่น msdyn_DataverseMCPServerจะข้ามแอปนี้ไปเพราะแพลตฟอร์มมีแอปของตัวเองให้ใช้งาน |
เนื่องจากคําสั่งนี้สร้างการลงทะเบียนแอป บัญชีที่รัน CLI ต้องมีสิทธิ์ Application.ReadWrite.All Microsoft Graph หากไม่มีสิทธิ์ publish นี้ จะล้มเหลว หากการเผยแพร่ล้มเหลว CLI จะลบการลงทะเบียนแอปที่สร้างขึ้น หากคุณยกเลิกการเผยแพร่เซิร์ฟเวอร์ ให้ลบการลงทะเบียนแอปเหล่านี้ด้วยตนเอง
ใน tenant ที่จํากัดอายุการใช้งานของ client secret ด้วย appManagementPolicies นโยบาย ให้ใช้ --secret-lifetime-months กําหนดอายุการใช้งานภายในขีดจํากัดของ <server-name>-A365Proxy client secret
Note
จัดเตรียม --publisher-name เซิร์ฟเวอร์ MCP แบบกําหนดเอง (ผู้ใช้สร้างขึ้น) ค่าจะถูกเขียนลงในเมตาดาต้าของนักพัฒนาของแพคเกจที่เผยแพร่ และจําเป็นสําหรับเซิร์ฟเวอร์เหล่านี้ ระบบจะละเว้นเซิร์ฟเวอร์ของบุคคลที่หนึ่ง Microsoft เป็นเจ้าของ (เช่น msdyn_DataverseMCPServer) ซึ่งเผยแพร่เป็น "Microsoft" เสมอ เมื่อคุณละเว้น CLI จะแจ้งให้โต้ตอบ pass --yes เพื่อเผยแพร่โดยไม่มีข้อความแจ้งใน CI หรือบริบทสคริปต์
publish ตัวเลือก
| Option | Description |
|---|---|
-e, --environment-id <environment-id> |
ID สภาพแวดล้อม Dataverse |
-s, --server-name <server-name> |
ชื่อเซิร์ฟเวอร์ MCP ที่จะเผยแพร่ |
-a, --alias <alias> |
นามแฝงสําหรับเซิร์ฟเวอร์ MCP |
-d, --display-name <display-name> |
ชื่อที่แสดงสําหรับเซิร์ฟเวอร์ MCP |
-p, --publisher-name <publisher-name> |
ชื่อ Publisher ที่เขียนลงในเมตาดาต้าของแพคเกจที่เผยแพร่ จําเป็นสําหรับเซิร์ฟเวอร์ MCP แบบกําหนดเอง (ที่ผู้ใช้สร้างขึ้น) ละเว้นสําหรับเซิร์ฟเวอร์ของบุคคลที่หนึ่งที่ Microsoft เป็นเจ้าของ พร้อมท์แบบโต้ตอบเมื่อละเว้น |
--service-tree-id <service-tree-id> |
รหัสบริการ ServiceTree สําหรับการลงทะเบียนแอป Microsoft Entra ที่publishสร้าง จําเป็นใน tenant องค์กรของ Microsoft |
-l, --secret-lifetime-months <months> |
อายุการใช้งานเป็นเดือน (1-24) สําหรับ client secret บน<server-name>-A365Proxyแอป Microsoft Entra หากไม่ระบุ Microsoft Entra ID จะมีอายุการใช้งานเริ่มต้นประมาณ 2 ปี หากนโยบายของผู้ appManagementPolicies เช่าของคุณบังคับใช้ค่าสูงสุดที่สั้นกว่า ให้กําหนดค่าภายในขีดจํากัดนั้น |
-y, --yes |
ข้ามการโต้ตอบ "ดําเนินการเผยแพร่ต่อ? (y/N)" confirmation. ใช้ใน CI หรือบริบทสคริปต์ |
--dry-run |
แสดงสิ่งที่จะทําโดยไม่ต้องดําเนินการ |
-v, --verbose |
เปิดใช้งานการบันทึกแบบอย่างละเอียด |
-?, -h, --help |
แสดงวิธีใช้และข้อมูลการใช้งาน |
develop-mcp unpublish
ยกเลิกการเผยแพร่เซิร์ฟเวอร์ MCP จากสภาพแวดล้อม Dataverse
a365 develop-mcp unpublish [options]
ใช้คําสั่งนี้เพื่อลบเซิร์ฟเวอร์ MCP ออกจากสภาพแวดล้อม Dataverse ที่ระบุ
unpublish ตัวเลือก
| Option | Description |
|---|---|
-e, --environment-id <environment-id> |
ID สภาพแวดล้อม Dataverse |
-s, --server-name <server-name> |
ชื่อเซิร์ฟเวอร์ MCP เพื่อยกเลิกการเผยแพร่ |
--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> |
URL ของเซิร์ฟเวอร์ MCP ระยะไกล ต้องเป็น URL HTTP หรือ HTTPS ที่ถูกต้อง |
-a, --auth-type <auth-type> |
ชนิดการรับรองความถูกต้อง: EntraOAuth, , ExternalOAuthหรือ APIKeyNoAuth |
--publisher <publisher> |
ชื่อ Publisher (ใช้ในเมตาดาต้าของแพคเกจ) |
--description <description> |
คําอธิบายเซิร์ฟเวอร์ (ใช้ในข้อมูลเมตาของแพ็คเกจ) |
--tools <tools> |
ตัวอย่างเช่น รายการชื่อเครื่องมือที่คั่นด้วยจุลภาคที่เซิร์ฟเวอร์นี้เปิดเผย tool1,tool2,tool3 |
-f, --input-file <input-file> |
เส้นทางไปยังไฟล์ JSON ที่มีพารามิเตอร์การลงทะเบียน |
--remote-scopes <remote-scopes> |
ขอบเขตสําหรับเซิร์ฟเวอร์ MCP ระยะไกล เช่น api://{appId-guid}/{scopeName}. ใช้กับ EntraOAuth |
-t, --tenant-id <tenant-id> |
รหัสผู้เช่าทางเข้าสําหรับการลงทะเบียนแอป ค่าเริ่มต้นเป็นผู้เช่าปัจจุบันaz login |
--service-tree-id <service-tree-id> |
รหัส ServiceTree สําหรับการลงทะเบียนแอป Entra จําเป็นในผู้เช่าองค์กรของ Microsoft |
-l, --secret-lifetime-months <months> |
อายุการใช้งานเป็นเดือน (1-24) สําหรับข้อมูลลับไคลเอ็นต์ที่สร้างขึ้นบนแอป Entra ที่สร้างขึ้น ค่าเริ่มต้นเป็น 24 เดือน (2 ปี) ตั้งค่าที่น้อยกว่าขีดจํากัด appManagementPolicies ในผู้เช่าของคุณหากนโยบายผู้เช่าของคุณบังคับใช้ค่าสูงสุดที่สั้นลง |
--idp-authorization-url <url> |
URL การให้สิทธิ์ OAuth ภายนอก จําเป็นเมื่อ --auth-type เป็น ExternalOAuth |
--idp-token-url <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 |
แสดงวิธีใช้และข้อมูลการใช้งาน |