Agent 365 CLI develop-mcp 指令參考

管理 Dataverse 環境中的 MCP 伺服器。 此 develop-mcp 指令提供發佈、解除發佈、批准、阻擋、封包及註冊 MCP 伺服器的選項，以供 Dataverse 環境中使用。

最低要求角色：依子指揮部而異

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
-c、--config <config> 設定檔路徑（預設：a365.config.json）
--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 環境識別碼
-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> 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

從 Dataverse 環境中卸載 MCP 伺服器。

a365 develop-mcp unpublish [options]

使用此指令將 MCP 伺服器從指定的 Dataverse 環境中移除。

unpublish 選項

Option Description
-e、--environment-id <environment-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> 出版商或開發者顯示名稱（必填）
--icon-url <icon-url> MCP 伺服器 PNG 圖示的公開網址（必須）
--output-path <output-path> 產生的 ZIP 套件目標目錄（必須）
--dry-run 展示不執行的情況下會做什麼
-c、--config <config> 設定檔路徑（預設：a365.config.json）
-?， -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.json CLI 範本中的檔案結構。
  • 刪除任何互動式提示所需的值。

註冊成功後，請租戶管理員批准新的 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 企業租戶的必備功能
--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 顯示說明與使用資訊
  • Last updated on