代理 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 服务器 API 权限添加到Microsoft Entra应用程序，以便在其中配置自定义应用程序以访问 MCP 服务器。

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或 raw （默认值： table）
--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 （默认值）：适用于 MCP 服务器的代理 365 工具
    • 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