Referência de comando CLI develop do Agente 365

Gerir servidores de ferramentas MCP para desenvolvimento de agentes. O develop comando fornece opções para gerir servidores de ferramentas MCP (Model Context Protocol) para desenvolvimento de agentes. Pode listar servidores disponíveis, visualizar servidores configurados e adicionar ou remover servidores MCP da configuração do seu agente.

Função mínima exigida: Nenhuma (gestão local de manifestos)

Syntax

a365 develop [command] [options]

Opções

Option	Description
-c, --config <config>	Caminho do ficheiro de configuração. Default: a365.config.json
-v, --verbose	Ativar registo verboso
-?, -h, --help	Mostrar informações de ajuda e utilização.

develop list-available

Lista todos os servidores MCP disponíveis no catálogo (o que podes instalar).

a365 develop list-available [options]

Este comando mostra todos os servidores MCP disponíveis no catálogo e pode instalá-los para uso no desenvolvimento do seu agente.

list-available Opções

Option	Description
--dry-run	Mostra o que o comando faria sem o executar.
--skip-auth	Skip authentication. Apenas para testes. O comando provavelmente falha sem autenticação válida.
-?, -h, --help	Mostrar informações de ajuda e utilização.

Note

develop list-available não requer a365.config.json. Lê o ambiente a partir da A365_ENVIRONMENT variável ambiente (por defeito para prod).

develop list-configured

Liste os servidores MCP atualmente configurados do seu local ToolingManifest.json.

a365 develop list-configured [options]

Este comando mostra todos os servidores MCP que configuraste atualmente no teu ficheiro ToolingManifest.json local.

list-configured Opções

Option	Description
--project-path <path>	Caminho para o diretório do projeto agente que contém ToolingManifest.json. Sobrescreve DeploymentProjectPath de a365.config.json.
--dry-run	Mostra o que o comando faria sem o executar.
-?, -h, --help	Mostrar informações de ajuda e utilização.

develop add-mcp-servers

Adicionar servidores MCP à configuração atual do agente.

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

Este comando adiciona os servidores MCP especificados na ToolingManifest.json pasta do seu projeto. Não concede permissões ao blueprint do agente.

Important

Este comando apenas atualiza ToolingManifest.json – não concede permissões ao blueprint do agente. A forma como aplicas permissões depende de onde estás no processo de configuração:

• Antes da configuração inicial: Prossiga com a365 setup all. As permissões MCP são aplicadas como parte da criação inicial do blueprint.
• Depois de o blueprint já existir: Um Administrador Global deve ser executado a365 setup permissions mcp separadamente. O administrador deve verificar que isso deploymentProjectPath aponta para a pasta do projeto que contém o arquivo atualizado ToolingManifest.json.

add-mcp-servers Argumentos

Especifique um ou mais nomes de servidores MCP para adicionar à configuração do seu agente. Pode fornecer vários nomes de servidores separados por espaços.

Argument	Description
<servers>	Nomes dos servidores MCP a adicionar

add-mcp-servers Opções

Use estas opções para personalizar o comportamento do add-mcp-servers comando.

Option	Description
--project-path <path>	Caminho para o diretório do projeto agente que contém ToolingManifest.json. Sobrescreve DeploymentProjectPath de a365.config.json.
--dry-run	Mostra o que o comando faria sem o executar.
-?, -h, --help	Mostrar informações de ajuda e utilização.

develop remove-mcp-servers

Remover os servidores MCP da configuração atual do agente.

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

Este comando remove servidores MCP especificados da sua configuração atual de agentes.

remove-mcp-servers Argumentos

Argument	Description
<servers>	Nomes dos servidores MCP a remover

remove-mcp-servers Opções

Option	Description
--project-path <path>	Caminho para o diretório do projeto agente que contém ToolingManifest.json. Sobrescreve DeploymentProjectPath de a365.config.json.
--dry-run	Mostra o que o comando faria sem o executar.
-?, -h, --help	Mostrar informações de ajuda e utilização.

develop add-permissions

Adicione permissões da API do servidor MCP às aplicações Microsoft Entra para cenários de desenvolvimento onde precisa de configurar aplicações personalizadas para aceder a servidores MCP.

a365 develop add-permissions [options]

add-permissions Opções

Use estas opções para adicionar permissões e âmbitos necessários da API ao registo da sua aplicação, aproveitando valores do manifesto de ferramentas.

Option	Description
-c, --config <config>	Caminho do ficheiro de configuração (predefinido: a365.config.json)
-m, --manifest <manifest>	Caminho para ToolingManifest.json (padrão: <deploymentProjectPath>/ToolingManifest.json)
--app-id <app-id>	ID da aplicação (cliente) para adicionar permissões a (por defeito: clientAppId from config)
--scopes <scopes>	Escopos específicos a adicionar (separados por espaço) (padrão: Todos os escopos de ToolingManifest.json)
--dry-run	Mostra o que o comando faria sem fazer alterações
-v, --verbose	Mostrar resultados detalhados
-?, -h, --help	Mostrar informações de ajuda e utilização.

Important

A aplicação especificada por --app-id ou clientAppId deve ter a permissão Application.ReadWrite.All em Microsoft Entra. Este comando é para aplicações cliente personalizadas. Para configurar permissões para os blueprints dos agentes, use a365 setup permissions mcp em vez disso.

develop get-token

Recuperar tokens portadores para testar servidores MCP durante o desenvolvimento usando autenticação interativa do navegador.

a365 develop get-token [options]

get-token Opções

Use estas opções para solicitar um token de acesso, controlar os escopos, atualizar o comportamento e escolher o formato de saída.

Option	Description
-c, --config <config>	Caminho do ficheiro de configuração (predefinido: a365.config.json)
--app-id <app-id>	ID da aplicação (cliente) para autenticação (predefinido: clientAppId from config)
-m, --manifest <manifest>	Caminho para ToolingManifest.json (padrão: <deploymentProjectPath>/ToolingManifest.json)
--scopes <scopes>	Escopos específicos a solicitar (separados por espaço) (padrão: Ler de ToolingManifest.json)
-o, --output <output>	Formato de saída: table, , ou json (por defeito: rawtable)
--force-refresh	Forçar a atualização do token a contornar a cache
--resource <resource>	Palavra-chave Resource para obter token para: mcp (padrão) ou powerplatform
--resource-id <resource-id>	ID de aplicação de recurso personalizado (GUID) para recursos não cobertos por --resource palavras-chave
-v, --verbose	Mostrar a saída detalhada, incluindo o token completo
-?, -h, --help	Mostrar informações de ajuda e utilização.

get-token Opções de recursos

Use as opções --resource e --resource-id para obter tokens para diferentes recursos Azure:

• --resource: Usar uma palavra-chave para selecionar um recurso pré-definido:
  • mcp (por defeito): Agent 365 Tools para servidores MCP
  • powerplatform: API Power Platform
• --resource-id: Introduza um ID de aplicação de recurso personalizado (GUID) para recursos não cobertos por palavras-chave

Important

Não podem usar --resource e --resource-id juntos. Quando usar qualquer uma das opções, inclua --scopes. Apenas o fluxo MCP por defeito suporta resolução de âmbito baseada em manifestos.

develop start-mock-tooling-server

Inicie um servidor de ferramentas simuladas para fins de teste e desenvolvimento.

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

Este comando inicia um servidor de ferramentas simuladas para fins de teste e desenvolvimento. Ao usar este servidor, pode simular interações com servidores MCP sem exigir implementações reais do servidor.

start-mock-tooling-server Opções

Use estas opções para personalizar o comportamento do start-mock-tooling-server comando.

Option	Description	Default
-p, --port <port>	Número de porta para o servidor simulado	5309
-v, --verbose	Ativar registo verboso	false
-?, -h, --help	Mostrar ajuda e informação de utilização	-
-bg	Executa o servidor num novo terminal	-