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

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

จําเป็นต้องมีบทบาทขั้นต่ํา: แตกต่างกันไปตาม command

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
-c, --config <config>	เส้นทางของไฟล์การกําหนดค่า (ค่าเริ่มต้น: a365.config.json)
--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
-c, --config <config>	เส้นทางของไฟล์การกําหนดค่า (ค่าเริ่มต้น: a365.config.json)
--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>	ID สภาพแวดล้อม Dataverse
-s, --server-name <server-name>	ชื่อเซิร์ฟเวอร์ MCP ที่จะเผยแพร่
-a, --alias <alias>	นามแฝงสําหรับเซิร์ฟเวอร์ MCP
-d, --display-name <display-name>	ชื่อที่แสดงสําหรับเซิร์ฟเวอร์ MCP
-c, --config <config>	เส้นทางของไฟล์การกําหนดค่า (ค่าเริ่มต้น: a365.config.json)
--dry-run	แสดงสิ่งที่จะทําโดยไม่ต้องดําเนินการ
-?, -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 เพื่อยกเลิกการเผยแพร่
-c, --config <config>	เส้นทางของไฟล์การกําหนดค่า (ค่าเริ่มต้น: a365.config.json)
--dry-run	แสดงสิ่งที่จะทําโดยไม่ต้องดําเนินการ
-?, -h, --help	แสดงข้อมูลความช่วยเหลือและการใช้งาน

develop-mcp approve

อนุมัติเซิร์ฟเวอร์ MCP

a365 develop-mcp approve [options]

คําสั่งนี้อนุมัติเซิร์ฟเวอร์ MCP สําหรับการใช้งานในสภาพแวดล้อม

approve ตัวเลือก

Option	Description
-s, --server-name <server-name>	ชื่อเซิร์ฟเวอร์ MCP ที่จะอนุมัติ
-c, --config <config>	เส้นทางของไฟล์การกําหนดค่า (ค่าเริ่มต้น: a365.config.json)
--dry-run	แสดงสิ่งที่จะทําโดยไม่ต้องดําเนินการ
-?, -h, --help	แสดงข้อมูลความช่วยเหลือและการใช้งาน

develop-mcp block

บล็อกเซิร์ฟเวอร์ MCP

a365 develop-mcp block [options]

ใช้คําสั่งนี้เพื่อบล็อกเซิร์ฟเวอร์ MCP จากการใช้ในสภาพแวดล้อมของคุณ

block ตัวเลือก

Option	Description
-s, --server-name <server-name>	ชื่อเซิร์ฟเวอร์ MCP ที่จะบล็อก
-c, --config <config>	เส้นทางของไฟล์การกําหนดค่า (ค่าเริ่มต้น: a365.config.json)
--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>	ชื่อที่แสดงของผู้เผยแพร่หรือนักพัฒนา (REQUIRED)
--icon-url <icon-url>	URL สาธารณะไปยังไอคอน PNG สําหรับเซิร์ฟเวอร์ MCP (จําเป็น)
--output-path <output-path>	ไดเรกทอรีเป้าหมายสําหรับแพคเกจ ZIP ที่สร้างขึ้น (จําเป็น)
--dry-run	แสดงสิ่งที่จะทําโดยไม่ต้องดําเนินการ
-c, --config <config>	เส้นทางของไฟล์การกําหนดค่า (ค่าเริ่มต้น: a365.config.json)
-?, -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
--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	แสดงข้อมูลความช่วยเหลือและการใช้งาน