代理 365 CLI
在 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 环境 ID |
-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 环境 ID |
-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]
使用此命令从指定的 Dataverse 环境中删除 MCP 服务器。
unpublish 选项
| Option | Description |
|---|---|
-e、--environment-id <environment-id> |
Dataverse 环境 ID |
-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
在Microsoft管理中心生成 MCP 服务器包以供提交。
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 图标的公共 URL（必需） |
--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.jsonCLI模板。 - 省略任何需要交互提示的值。
注册成功后，请租户管理员批准新的MCP服务器，确保代理可以使用。 如果你注册了 ExternalOAuth，也将显示的重定向 URI 添加到你的外部 IDP 应用中。
Important
如果注册失败，而 Microsoft Entra 应用注册创建后，应用不会自动回滚。 在重新尝试前，先在Azure门户手动删除它们。
register-external-mcp-server 选项
某些选项仅适用于特定认证类型，如描述栏所述。
| Option | Description |
|---|---|
-s、--server-name <server-name> |
MCP服务器名称。 例如，必须以 ext_ 最多20字符开头 ext_MyServer |
-u、--server-url <server-url> |
远程MCP服务器URL。 必须是有效的 HTTP 或 HTTPS URL |
-a、--auth-type <auth-type> |
认证类型： EntraOAuth， ExternalOAuth， APIKey， 或 NoAuth |
--publisher <publisher> |
Publisher 名称（用于包元数据） |
--description <description> |
服务器描述（用于包元数据） |
--tools <tools> |
例如，该服务器暴露的工具名称列表被逗号分隔 tool1,tool2,tool3 |
-f、--input-file <input-file> |
指向带有注册参数的JSON文件的路径 |
--remote-scopes <remote-scopes> |
例如 api://{appId-guid}/{scopeName}，远程MCP服务器的示域。 与 EntraOAuth 配合使用 |
-t、--tenant-id <tenant-id> |
Entra租户ID用于应用注册。 默认归 az login 当前租户 |
--service-tree-id <service-tree-id> |
用于Entra应用注册的ServiceTree ID。 Microsoft企业租户中必备 |
--idp-authorization-url <url> |
外部OAuth授权URL。
--auth-type
ExternalOAuth 时必需 |
--idp-token-url <url> |
外部OAuth令牌URL。
--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 |
显示帮助和使用情况信息 |