การอ้างอิงคําสั่ง Agent 365 CLI develop-mcp

จัดการเซิร์ฟเวอร์ MCP ในสภาพแวดล้อมแบบผกผันข้อมูล คําสั่งนี้ develop-mcp มีตัวเลือกในการเผยแพร่ ยกเลิกการเผยแพร่ และลงทะเบียนเซิร์ฟเวอร์ MCP เพื่อใช้ในสภาพแวดล้อม Dataverse

Note

develop-mcp approveคําสั่ง , develop-mcp blockและ develop-mcp package-mcp-server จะถูกลบออกจาก Agent 365 CLI ขณะนี้ผู้ดูแลระบบผู้เช่าดําเนินการอนุมัติและบล็อกเซิร์ฟเวอร์ในศูนย์การจัดการ 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

ดูวิธีประเมินเซิร์ฟเวอร์ MCP

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 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 ที่ระบุ

เมื่อคุณเผยแพร่ CLI จะสร้างการลงทะเบียนแอป <server-name>-PublicClients Microsoft Entra ในผู้เช่าของคุณ แอปนี้มีสิทธิ์ OAuth ที่โฮสต์ไคลเอ็นต์ (เช่น Visual Studio Code และ Microsoft 365 Copilot CLI) ใช้เพื่อเรียกใช้เซิร์ฟเวอร์ MCP ที่เผยแพร่ เนื่องจากคําสั่งสร้างการลงทะเบียนแอป บัญชีที่เรียกใช้ CLI ต้องมีสิทธิ์ Application.ReadWrite.All Microsoft Graph การวิ่ง publish โดยไม่มีมันล้มเหลว

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 เป็นเจ้าของ พร้อมท์แบบโต้ตอบเมื่อละเว้น
-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	แสดงข้อมูลความช่วยเหลือและการใช้งาน