Referência de comando da CLI develop do Agent 365

Gerenciar servidores de ferramentas MCP para desenvolvimento de agente. O develop comando fornece opções para gerenciar servidores de ferramenta MCP (Protocolo de Contexto de Modelo) para desenvolvimento de agente. Você pode listar servidores disponíveis, exibir servidores configurados e adicionar ou remover servidores MCP da configuração do agente.

Função mínima necessária: Nenhuma (gerenciamento de manifesto local)

Syntax

a365 develop [command] [options]

Opções

Option	Description
-c, --config <config>	Caminho do arquivo de configuração. Default: a365.config.json
-v, --verbose	Habilitar o registro em log detalhado
-?, , -h--help	Mostrar informações de ajuda e uso.

develop list-available

Liste todos os servidores MCP disponíveis no catálogo (o que você pode instalar).

a365 develop list-available [options]

Esse comando exibe todos os servidores MCP disponíveis no catálogo e você pode instalá-los para uso com o desenvolvimento do agente.

list-available opções

Option	Description
--dry-run	Mostre o que o comando faria sem executá-lo.
--skip-auth	Skip authentication. Somente para teste. O comando provavelmente falhará sem autenticação válida.
-?, , -h--help	Mostrar informações de ajuda e uso.

Note

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

develop list-configured

Listar servidores MCP configurados no momento de seu local ToolingManifest.json.

a365 develop list-configured [options]

Este comando mostra todos os servidores MCP configurados no momento no arquivo de ToolingManifest.json local.

list-configured opções

Option	Description
--project-path <path>	Caminho para o diretório do projeto agente contendo ToolingManifest.json. Sobrescreve DeploymentProjectPath de a365.config.json.
--dry-run	Mostre o que o comando faria sem executá-lo.
-?, , -h--help	Mostrar informações de ajuda e uso.

develop add-mcp-servers

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

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

Esse comando adiciona os servidores MCP especificados à ToolingManifest.json pasta do projeto. Ele não concede permissões ao blueprint do agente.

Important

Esse comando só atualiza ToolingManifest.json – ele não concede permissões para o blueprint do agente. Como você aplica as permissões depende de onde você está 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 que o blueprint já existir: um Administrador Global deve executar a365 setup permissions mcp separadamente. O administrador deve verificar se isso deploymentProjectPath aponta para a pasta do projeto contendo o arquivo atualizado ToolingManifest.jsonde .

Argumentos de add-mcp-servers

Especifique um ou mais nomes de servidor MCP a serem adicionados à configuração do agente. Você pode fornecer vários nomes de servidor separados por espaços.

Argument	Description
<servers>	Nomes dos servidores MCP a serem adicionados

add-mcp-servers opções

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

Option	Description
--project-path <path>	Caminho para o diretório do projeto agente contendo ToolingManifest.json. Sobrescreve DeploymentProjectPath de a365.config.json.
--dry-run	Mostre o que o comando faria sem executá-lo.
-?, , -h--help	Mostrar informações de ajuda e uso.

develop remove-mcp-servers

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

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

Esse comando remove os servidores MCP especificados da configuração do agente atual.

Argumentos de remove-mcp-servers

Argument	Description
<servers>	Nomes dos servidores MCP a serem removidos

remove-mcp-servers opções

Option	Description
--project-path <path>	Caminho para o diretório do projeto agente contendo ToolingManifest.json. Sobrescreve DeploymentProjectPath de a365.config.json.
--dry-run	Mostre o que o comando faria sem executá-lo.
-?, , -h--help	Mostrar informações de ajuda e uso.

develop add-permissions

Adicione permissões de API do servidor MCP para Microsoft Entra aplicativos para cenários de desenvolvimento em que você precisa configurar aplicativos personalizados para acessar servidores MCP.

a365 develop add-permissions [options]

add-permissions opções

Use essas opções para adicionar permissões e escopos de API necessários ao registro do aplicativo, aproveitando valores do manifesto de ferramentas.

Option	Description
-c, --config <config>	Caminho do arquivo de configuração (padrão: a365.config.json)
-m, --manifest <manifest>	Caminho para ToolingManifest.json (padrão: <deploymentProjectPath>/ToolingManifest.json)
--app-id <app-id>	ID do aplicativo (cliente) para adicionar permissões (padrão: clientAppId da configuração)
--scopes <scopes>	Escopos específicos a serem adicionados (separados por espaço) (padrão: todos os escopos de ToolingManifest.json)
--dry-run	Mostrar o que o comando faria sem fazer alterações
-v, --verbose	Mostrar saída detalhada
-?, , -h--help	Mostrar informações de ajuda e uso.

Important

O aplicativo especificado por --app-id ou clientAppId deve ter a permissão Application.ReadWrite.All no Microsoft Entra. Esse comando é para aplicativos cliente personalizados. Para configurar permissões para blueprints de agente, use a365 setup permissions mcp em vez disso.

develop get-token

Recupere tokens de portador para testar servidores MCP durante o desenvolvimento usando a autenticação interativa do navegador.

a365 develop get-token [options]

get-token opções

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

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

get-token opções de recurso

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

• --resource: use uma palavra-chave para selecionar um recurso predefinido:
  • mcp (padrão): Ferramentas do Agente 365 para servidores MCP
  • powerplatform: API do Power Platform
• --resource-id: insira um GUID (ID de aplicativo de recurso) personalizado para recursos não cobertos por palavras-chave

Important

Vocês não podem usar --resource juntos --resource-id . Ao usar qualquer uma das opções, inclua --scopes. Somente o fluxo MCP padrão dá suporte à resolução de escopo baseada em manifesto.

develop start-mock-tooling-server

Inicie um servidor de ferramentas fictício para fins de teste e desenvolvimento.

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

Esse comando inicia um servidor de ferramentas fictício para fins de teste e desenvolvimento. Usando esse servidor, você pode simular interações de servidor MCP sem exigir implementações reais do servidor.

start-mock-tooling-server opções

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

Option	Description	Default
-p, --port <port>	Número da porta para o servidor fictício	5309
-v, --verbose	Habilitar o registro em log detalhado	false
-?, -h, --help	Mostrar informações de ajuda e uso	-
-bg	Executar o servidor em um novo terminal	-