Agent 365 CLI
管理 Dataverse 環境中的 MCP 伺服器。 此 develop-mcp 指令提供發布、取消發佈及註冊 MCP 伺服器的選項，以供 Dataverse 環境中使用。
Note
develop-mcp approveAgent 365 CLI 中的 、 develop-mcp blockdevelop-mcp package-mcp-server 、 和 指令已被移除。 租戶管理員現在可在 Microsoft 管理中心執行伺服器審核與封鎖——待處理的請求會在 Requested Agents 頁面進行審查。 CLI 不再產生 MCP 伺服器套件供管理中心提交;管理員直接在管理中心接入並管理伺服器。
最低要求角色：依子指揮部而異
Syntax
a365 develop-mcp [command] [options]
選項
| Option | Description |
|---|---|
-v、--verbose |
啟用詳細日誌記錄 |
-?、-h、--help |
顯示說明與使用資訊 |
develop-mcp list-environments
列出所有可用於 MCP 伺服器管理的 Dataverse 環境。
a365 develop-mcp list-environments [options]
此指令顯示所有可管理 MCP 伺服器的 Dataverse 環境。
list-environments 選項
| Option | Description |
|---|---|
--dry-run |
展示不執行的情況下會做什麼 |
-v、--verbose |
啟用詳細日誌記錄 |
-?、-h、--help |
顯示說明與使用資訊 |
develop-mcp list-servers
列出特定 Dataverse 環境中的 MCP 伺服器。
a365 develop-mcp list-servers [options]
此指令顯示目前部署於指定 Dataverse 環境中的所有 MCP 伺服器。
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 環境。
發佈時，CLI 會在租戶中建立一個 <server-name>-PublicClients Microsoft Entra 應用程式註冊。 此應用程式持有用戶端主機（如 Visual Studio Code 與 Microsoft 365 Copilot CLI）用來呼叫已發佈 MCP 伺服器的 OAuth 權限。 由於該指令會建立應用程式註冊，執行 CLI 的帳號必須擁有 Application.ReadWrite.All Microsoft Graph 權限。 不帶它跑 publish 會失敗。
Note
提供 --publisher-name 自訂（使用者創建）MCP 伺服器。 該值會寫入已發佈套件的開發者元資料，且是這些伺服器所必需的。 對於第一方Microsoft擁有的伺服器（例如 msdyn_DataverseMCPServer）會忽略，這些伺服器總是以「Microsoft」形式發佈。 當你省略時，CLI 會互動式地提示;在 CI 或腳本化情境中，無需提示即可通過 --yes 發佈。
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 伺服器的顯示名稱 |
-p、--publisher-name <publisher-name> |
Publisher 名稱寫入已發佈套件的元資料。 自訂（使用者創建）MCP 伺服器所必需;被第一方 Microsoft 擁有的伺服器忽略。 省略時會互動提示。 |
-y、--yes |
跳過互動式的「繼續發佈嗎？ (y/N)" confirmation. 在 CI 或腳本情境中使用。 |
--dry-run |
展示不執行的情況下會做什麼 |
-v、--verbose |
啟用詳細日誌記錄 |
-?、-h、--help |
顯示說明與使用資訊 |
develop-mcp unpublish
從 Dataverse 環境中卸載 MCP 伺服器。
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 register-external-mcp-server
請用 Entra、外部 OAuth、API 金鑰或無認證註冊外部 MCP 伺服器。
a365 develop-mcp register-external-mcp-server [options]
使用此指令向你的租戶註冊一個外部託管（第三方）MCP 伺服器。 此指令建立平台所需的 Microsoft Entra 應用程式註冊，呼叫 Agent 365 平台加入 MCP 伺服器，並設定新應用程式註冊的 URI 重定向與 API 權限。
伺服器名稱必須以 ext_ 前綴開頭，且長度最多為 20 個字元，例如 ext_MyServer。 工具名稱必須與遠端 MCP 伺服器所顯示的名稱完全一致。 名稱不匹配會導致工具呼叫在執行時失敗。
你可以用三種方式提供參數：
- 把它們當作命令列選項傳遞。
- 提供一個帶有
--input-file的 JSON 檔案。 命令列選項會覆寫檔案中的數值。 請參見register-external-mcp-server-sample.jsonCLI 範本中的檔案結構。 - 刪除任何互動式提示所需的值。
註冊成功後，請租戶管理員批准新的 MCP 伺服器，讓客服人員才能使用。 如果你註冊了 ExternalOAuth，也將顯示的重定向 URI 加入你的外部 IDP 應用程式。
Important
如果在建立 Microsoft Entra 應用程式註冊後註冊失敗，應用程式不會自動回滾。 在重試前，先在 Azure 入口網站手動刪除它們。
register-external-mcp-server 選項
部分選項僅對特定認證類型必要，詳見描述欄。
| Option | Description |
|---|---|
-s、--server-name <server-name> |
MCP 伺服器名稱。 例如，必須以 ext_ 20 個字元開頭，最多 20 個字元 ext_MyServer |
-u、--server-url <server-url> |
遠端 MCP 伺服器的網址。 必須是有效的 HTTP 或 HTTPS URL |
-a、--auth-type <auth-type> |
認證類型：EntraOAuth、、ExternalOAuthAPIKey、或NoAuth |
--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> |
用 Entra 租戶 ID 來註冊應用程式。 預設為現有 az login 租戶 |
--service-tree-id <service-tree-id> |
ServiceTree ID 用於 Entra 應用程式註冊。 Microsoft 企業租戶的必備功能 |
-l、--secret-lifetime-months <months> |
在建立的 Entra 應用程式中產生的客戶端秘密，壽命以月為單位（1 到 24）。 預設為24個月（2年）。 如果你的房客保單規定最高限額較短，請將價值設定低於 appManagementPolicies 上限 |
--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 用戶端 ID。
--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-Keytoken。
--auth-type
APIKey 時需要 |
--dry-run |
展示不執行的情況下會做什麼 |
-v、--verbose |
啟用詳細日誌記錄 |
-?、-h、--help |
顯示說明與使用資訊 |