代理 365 CLI develop 命令参考

重要

需要成为 Frontier 预览计划的一部分，才能获得 抢先体验Microsoft Agent 365。 Frontier将你直接连接到Microsoft最新的人工智能创新。 Frontier预览受现有客户协议的预览条款约束。 由于这些功能仍在开发中，其可用性和功能可能会随着时间发生变化。

管理 MCP 工具服务器进行代理开发。 该 develop 命令提供用于管理 MCP（模型上下文协议）工具服务器以用于代理开发的选项。 可以列出可用服务器、查看配置的服务器，以及从代理配置中添加或删除 MCP 服务器。

所需的最低角色：无（本地清单管理）

Syntax

a365 develop [command] [options]

选项

选项	Description
-c、--config <config>	配置文件路径。 默认值：a365.config.json
-v、--verbose	启用详细日志记录
-?、-h、--help	显示帮助和使用情况信息。

develop list-available

列出目录中可用的所有 MCP 服务器（可以安装的内容）。

a365 develop list-available [options]

此命令显示目录中可用的所有 MCP 服务器，可以安装它们以用于代理开发。

list-available 选项

选项	Description
-c、--config <config>	配置文件路径。 默认值：a365.config.json
--dry-run	显示命令在未执行的情况下执行的作。
--skip-auth	跳过身份验证。 仅用于测试。 该命令可能失败，且没有有效的身份验证。
-?、-h、--help	显示帮助和使用情况信息。

develop list-configured

列出当前从本地 ToolingManifest.json配置的 MCP 服务器。

a365 develop list-configured [options]

此命令显示当前在本地 ToolingManifest.json 文件中配置的所有 MCP 服务器。

list-configured 选项

选项	Description
-c、--config <config>	配置文件路径。 默认值：a365.config.json
--dry-run	显示命令在未执行的情况下执行的作。
-?、-h、--help	显示帮助和使用情况信息。

develop add-mcp-servers

将 MCP 服务器添加到当前代理配置。

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

此命令将指定的 MCP 服务器添加到 ToolingManifest.json 项目文件夹中。 它不向代理蓝图授予权限。

重要

此命令仅更新 ToolingManifest.json — 它不会向代理蓝图授予权限。 应用权限的方式取决于你在安装过程中的位置：

• 初始设置之前：继续作 a365 setup all。 MCP 权限在初始蓝图创建过程中应用。
• 蓝图已存在后：全局管理员必须单独运行 a365 setup permissions mcp 。 管理员必须首先运行 a365 config display ，以验证 deploymentProjectPath 其 a365.config.json 指向包含更新 ToolingManifest.json的项目文件夹。

add-mcp-servers 参数

指定要添加到代理配置的一个或多个 MCP 服务器名称。 可以提供由空格分隔的多个服务器名称。

论点	Description
<servers>	要添加的 MCP 服务器的名称

add-mcp-servers 选项

使用这些选项自定义命令的行为 add-mcp-servers ，包括配置文件选择和试运行测试。

选项	Description
-c、--config <config>	配置文件路径。 默认值：a365.config.json
--dry-run	显示命令在未执行的情况下执行的作。
-?、-h、--help	显示帮助和使用情况信息。

develop remove-mcp-servers

从当前代理配置中删除 MCP 服务器。

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

此命令从当前代理配置中删除指定的 MCP 服务器。

remove-mcp-servers 参数

论点	Description
<servers>	要删除的 MCP 服务器的名称

remove-mcp-servers 选项

选项	Description
-c、--config <config>	配置文件路径。 默认值：a365.config.json
--dry-run	显示命令在未执行的情况下执行的作。
-?、-h、--help	显示帮助和使用情况信息。

develop add-permissions

将 MCP 服务器 API 权限添加到Microsoft Entra应用程序，以便在其中配置自定义应用程序以访问 MCP 服务器。

a365 develop add-permissions [options]

add-permissions 选项

使用这些选项可将所需的 API 权限和范围添加到应用注册，并利用工具清单中的值。

选项	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	显示帮助和使用情况信息。

重要

由 --app-id 或 clientAppId 指定的应用程序必须在 Microsoft Entra 中具有 Application.ReadWrite.All 权限。 此命令适用于自定义客户端应用程序。 若要配置代理蓝图的权限，请改用 a365 setup permissions mcp 。

develop get-token

使用交互式浏览器身份验证检索持有者令牌，以便在开发过程中测试 MCP 服务器。

a365 develop get-token [options]

get-token 选项

使用这些选项可以请求访问令牌、控制范围、刷新行为，然后选择输出格式。

选项	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）

重要

--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 。

选项	Description	违约
-p, --port <port>	模拟服务器的端口号	5309
-v, --verbose	启用详细日志记录	假
-?, -h, --help	显示帮助和使用情况信息	-
-bg	在新终端上运行服务器	-