Agent 365 CLI develop 指令參考

管理 MCP 工具伺服器以進行代理開發。 此 develop 指令提供管理 MCP（模型情境協定）工具伺服器以進行代理開發的選項。 你可以列出可用伺服器、查看已設定的伺服器，並從代理設定中新增或移除 MCP 伺服器。

最低需求角色：無（地方清單管理）

Syntax

a365 develop [command] [options]

選項

Option Description
-c、--config <config> 設定檔路徑。 Default: a365.config.json
-v、--verbose 啟用詳細日誌記錄
-?、 、 -h--help 顯示說明和使用資訊。

develop list-available

列出目錄中所有可用的 MCP 伺服器（你能安裝的設備）。

a365 develop list-available [options]

此指令會顯示目錄中所有可用的 MCP 伺服器，您可以安裝它們以配合代理程式開發。

list-available 選項

Option Description
--dry-run 展示指令在不執行的情況下會做什麼。
--skip-auth Skip authentication. 只是測試用。 指令很可能在沒有有效驗證的情況下失敗。
-?、 、 -h--help 顯示說明和使用資訊。

Note

develop list-available 不需要 a365.config.json。 它從環境變數讀取環境 A365_ENVIRONMENT （預設為 prod）。

develop list-configured

從你本地 ToolingManifest.json的 MCP 伺服器列出目前已設定的伺服器。

a365 develop list-configured [options]

這個指令會顯示你目前在本地 ToolingManifest.json 檔案中設定的所有 MCP 伺服器。

list-configured 選項

Option Description
--project-path <path> 包含 ToolingManifest.json的代理專案目錄路徑。 覆蓋 DeploymentProjectPatha365.config.json。
--dry-run 展示指令在不執行的情況下會做什麼。
-?、 、 -h--help 顯示說明和使用資訊。

develop add-mcp-servers

將 MCP 伺服器加入目前的代理配置。

a365 develop add-mcp-servers [<servers>...] [options]

這個指令會將指定的 MCP 伺服器加入 ToolingManifest.json 你的專案資料夾。 它不會授權代理藍圖。

Important

這個指令只會更新 ToolingManifest.json ，不會授權代理藍圖。 你如何套用權限取決於你設定流程的哪個階段：

  • 在初始設定前：先進行。a365 setup all MCP 權限會在初始藍圖建立時被應用。
  • 藍圖已存在後：全域管理員必須獨立執行 a365 setup permissions mcp 。 管理員必須確認該指向 deploymentProjectPath 包含更新 ToolingManifest.json. 的專案資料夾。

add-mcp-servers 引數

指定一個或多個 MCP 伺服器名稱，加入你的代理設定中。 你可以提供多個伺服器名稱，並以空格分隔。

Argument Description
<servers> 需新增的 MCP 伺服器名稱

add-mcp-servers 選項

利用這些選項來自訂指令的 add-mcp-servers 行為。

Option Description
--project-path <path> 包含 ToolingManifest.json的代理專案目錄路徑。 覆蓋 DeploymentProjectPatha365.config.json。
--dry-run 展示指令在不執行的情況下會做什麼。
-?、 、 -h--help 顯示說明和使用資訊。

develop remove-mcp-servers

將 MCP 伺服器從目前代理設定中移除。

a365 develop remove-mcp-servers [<servers>...] [options]

此指令會從你目前的代理設定中移除指定的 MCP 伺服器。

remove-mcp-servers 引數

Argument Description
<servers> 需移除的 MCP 伺服器名稱

remove-mcp-servers 選項

Option Description
--project-path <path> 包含 ToolingManifest.json的代理專案目錄路徑。 覆蓋 DeploymentProjectPatha365.config.json。
--dry-run 展示指令在不執行的情況下會做什麼。
-?、 、 -h--help 顯示說明和使用資訊。

develop add-permissions

在開發情境中，為需要設定自訂應用程式以存取 MCP 伺服器的 Microsoft Entra 應用程式新增 API 權限。

a365 develop add-permissions [options]

add-permissions 選項

利用這些選項，利用工具清單中的數值，為你的應用程式註冊新增必要的 API 權限和範圍。

Option Description
-c、--config <config> 設定檔路徑（預設： a365.config.json）
-m、--manifest <manifest> 路徑（ ToolingManifest.json 預設： <deploymentProjectPath>/ToolingManifest.json）
--app-id <app-id> 應用程式（客戶端）ID 以新增權限（預設： clientAppId 來自設定）
--scopes <scopes> 可新增的特定範圍（空格分離）（預設：所有範圍 ToolingManifest.json）
--dry-run 展示指令在不做修改的情況下會做什麼
-v、--verbose 展示詳細成果
-?、 、 -h--help 顯示說明和使用資訊。

Important

由 --app-id 或 clientAppId 指定的應用程式必須在 Microsoft Entra 中取得 Application.ReadWrite.All 權限。 此指令用於自訂客戶端應用程式。 若要設定代理藍圖的權限，請使用 a365 setup permissions mcp [

develop get-token

在開發過程中使用互動式瀏覽器認證，取得 MCP 伺服器測試的持有憑證。

a365 develop get-token [options]

get-token 選項

使用這些選項請求存取權杖、控制範圍、刷新行為及選擇輸出格式。

Option Description
-c、--config <config> 設定檔路徑（預設： a365.config.json）
--app-id <app-id> 應用程式（客戶端）ID用於認證（預設： clientAppId 來自設定）
-m、--manifest <manifest> 路徑（ ToolingManifest.json 預設： <deploymentProjectPath>/ToolingManifest.json）
--scopes <scopes> 特定請求範圍（空格分離）（預設：讀取）ToolingManifest.json
-o、--output <output> 輸出格式：table、 ，或json（預設：rawtable）
--force-refresh 強制令牌刷新繞過快取
--resource <resource> 資源關鍵字用來取得代幣： mcp （預設值）或 powerplatform
--resource-id <resource-id> 針對未被 --resource 關鍵字涵蓋的資源的自訂資源應用程式 ID（GUID）
-v、--verbose 顯示詳細輸出，包括完整令牌
-?、 、 -h--help 顯示說明和使用資訊。

get-token 資源選項

使用 --resource 和 --resource-id 選項來取得不同Azure資源的代幣：

  • --resource：使用關鍵字選擇預設資源：
    • mcp （預設）：Agent 365 用於 MCP 伺服器的工具
    • powerplatform： Power Platform API
  • --resource-id輸入自訂資源應用程式 ID（GUID）以指定未被關鍵字涵蓋的資源

Important

你不能一起使用--resource。--resource-id 使用任一選項時，請包含 --scopes。 只有預設的 MCP 流程支援基於清單的範圍解析。

develop start-mock-tooling-server

啟動一個模擬工具伺服器，用於測試和開發目的。

a365 develop start-mock-tooling-server [options]

此指令啟動一個模擬工具伺服器，用於測試與開發目的。 透過使用此伺服器，你可以模擬 MCP 伺服器的互動，而不需要實際的伺服器實作。

start-mock-tooling-server 選項

利用這些選項來自訂指令的 start-mock-tooling-server 行為。

Option Description Default
-p, --port <port> 模擬伺服器的埠號 5309
-v, --verbose 啟用詳細日誌記錄 false
-?, -h, --help 顯示說明與使用資訊 -
-bg 在新的終端機上運行伺服器 -
  • Last updated on