Referência de comando CLI develop-mcp do Agente 365

Gerir servidores MCP em ambientes Dataverse. O develop-mcp comando oferece opções para publicar, despublicar, aprovar, bloquear, empacotar e registar servidores MCP para utilização em ambientes Dataverse.

Papel mínimo exigido: Varia consoante o subcomando

Syntax

a365 develop-mcp [command] [options]

Opções

Option	Description
-v, --verbose	Ativar registo verboso
-?, -h, --help	Mostrar ajuda e informação de utilização

develop-mcp list-environments

Liste todos os ambientes Dataverse disponíveis para gestão de servidores MCP.

a365 develop-mcp list-environments [options]

Este comando mostra todos os ambientes Dataverse onde pode gerir servidores MCP.

list-environments Opções

Option	Description
-c, --config <config>	Caminho do ficheiro de configuração (padrão: a365.config.json)
--dry-run	Mostra o que seria feito sem executar
-v, --verbose	Ativar registo verboso
-?, -h, --help	Mostrar ajuda e informação de utilização

develop-mcp list-servers

Liste servidores MCP num ambiente Dataverse específico.

a365 develop-mcp list-servers [options]

Este comando mostra todos os servidores MCP atualmente implementados no ambiente Dataverse especificado.

list-servers Opções

Option	Description
-e, --environment-id <environment-id>	ID do ambiente Dataverse
-c, --config <config>	Caminho do ficheiro de configuração (padrão: a365.config.json)
--dry-run	Mostra o que seria feito sem executar
-v, --verbose	Ativar registo verboso
-?, -h, --help	Mostrar ajuda e informação de utilização

develop-mcp publish

Publique um servidor MCP num ambiente Dataverse.

a365 develop-mcp publish [options]

Use este comando para publicar um servidor MCP no ambiente Dataverse especificado.

publish Opções

Option	Description
-e, --environment-id <environment-id>	ID do ambiente Dataverse
-s, --server-name <server-name>	Nome do servidor MCP a publicar
-a, --alias <alias>	Alias para o servidor MCP
-d, --display-name <display-name>	Nome de exibição para o servidor MCP
-c, --config <config>	Caminho do ficheiro de configuração (padrão: a365.config.json)
--dry-run	Mostra o que seria feito sem executar
-?, -h, --help	Mostrar ajuda e informação de utilização

develop-mcp unpublish

Despublicar um servidor MCP de um ambiente Dataverse.

a365 develop-mcp unpublish [options]

Use este comando para remover um servidor MCP do ambiente Dataverse especificado.

unpublish Opções

Option	Description
-e, --environment-id <environment-id>	ID do ambiente Dataverse
-s, --server-name <server-name>	Nome do servidor MCP para despublicar
-c, --config <config>	Caminho do ficheiro de configuração (padrão: a365.config.json)
--dry-run	Mostra o que seria feito sem executar
-?, -h, --help	Mostrar ajuda e informação de utilização

develop-mcp approve

Aprove um servidor MCP.

a365 develop-mcp approve [options]

Este comando aprova um servidor MCP para utilização no ambiente.

approve Opções

Option	Description
-s, --server-name <server-name>	Nome do servidor MCP para aprovação
-c, --config <config>	Caminho do ficheiro de configuração (padrão: a365.config.json)
--dry-run	Mostra o que seria feito sem executar
-?, -h, --help	Mostrar ajuda e informação de utilização

develop-mcp block

Bloqueia um servidor MCP.

a365 develop-mcp block [options]

Use este comando para bloquear a utilização de um servidor MCP no seu ambiente.

block Opções

Option	Description
-s, --server-name <server-name>	Nome do servidor MCP para bloquear
-c, --config <config>	Caminho do ficheiro de configuração (padrão: a365.config.json)
--dry-run	Mostra o que seria feito sem executar
-?, -h, --help	Mostrar ajuda e informação de utilização

develop-mcp package-mcp-server

Gerar o pacote do servidor MCP para submissão no Microsoft Admin Center.

a365 develop-mcp package-mcp-server [options]

Use este comando para criar um pacote de implementação para um servidor MCP que possa submeter ao centro de administração da Microsoft.

package-mcp-server Opções

Option	Description
--server-name <server-name>	Nome do servidor MCP (OBRIGATÓRIO)
--developer-name <developer-name>	Nome de exibição do editor ou programador (OBRIGATÓRIO)
--icon-url <icon-url>	URL público para um ícone PNG para o servidor MCP (OBRIGATÓRIO)
--output-path <output-path>	Diretório alvo para o pacote ZIP gerado (OBRIGATÓRIO)
--dry-run	Mostra o que seria feito sem executar
-c, --config <config>	Caminho do ficheiro de configuração (padrão: a365.config.json)
-?, -h, --help	Mostrar ajuda e informação de utilização

develop-mcp register-external-mcp-server

Registe um servidor MCP externo com Entra, OAuth externo, chave API ou sem autenticação.

a365 develop-mcp register-external-mcp-server [options]

Use este comando para registar um servidor MCP alojado externamente (de terceiros) junto do seu inquilino. O comando cria os registos da aplicação Microsoft Entra de que a plataforma precisa, chama a plataforma Agent 365 para adicionar o servidor MCP e configura URIs de redirecionamento e permissões da API nos novos registos de aplicações.

O nome do servidor deve começar com o ext_ prefixo e ter no máximo 20 caracteres, por ext_MyServerexemplo. Os nomes das ferramentas devem corresponder exatamente aos nomes expostos pelo servidor MCP remoto. Nomes incompatíveis fazem com que as invocações de ferramentas falhem em tempo de execução.

Pode fornecer parâmetros de três formas:

• Passa-os como opções de linha de comandos.
• Forneça um ficheiro JSON com --input-file. As opções da linha de comandos sobrepõem valores do ficheiro. Veja register-external-mcp-server-sample.json nos templates de CLI para a estrutura do ficheiro.
• Omita qualquer valor necessário a ser solicitado de forma interativa.

Depois de o registo ser bem-sucedido, peça ao administrador do seu inquilino para aprovar o novo servidor MCP antes que os agentes possam usá-lo. Se se registou com ExternalOAuth, adicione também o URI de redirecionamento apresentado à sua aplicação externa IDP.

Important

Se o registo falhar após a criação dos registos da aplicação Microsoft Entra, as aplicações não são automaticamente revertidas. Apague-os manualmente no portal do Azure antes de tentar novamente.

register-external-mcp-server Opções

Algumas opções são necessárias apenas para tipos específicos de autenticação, conforme descrito na coluna de descrição.

Option	Description
-s, --server-name <server-name>	Nome do servidor MCP. Deve começar com ext_ e ter no máximo 20 caracteres, por exemplo ext_MyServer
-u, --server-url <server-url>	URL remoto do servidor MCP. Deve ser um URL HTTP ou HTTPS válido
-a, --auth-type <auth-type>	Tipo de autenticação: EntraOAuth, ExternalOAuth, APIKey, ou NoAuth
--publisher <publisher>	Nome do Publisher (usado nos metadados do pacote)
--description <description>	Descrição do servidor (usada nos metadados dos pacotes)
--tools <tools>	Lista separada por vírgulas de nomes de ferramentas exposta por este servidor, por exemplo tool1,tool2,tool3
-f, --input-file <input-file>	Caminho para um ficheiro JSON com os parâmetros de registo
--remote-scopes <remote-scopes>	Escopos para o servidor MCP remoto, por api://{appId-guid}/{scopeName}exemplo. Utilizado com EntraOAuth
-t, --tenant-id <tenant-id>	Entra o ID do inquilino para o registo da aplicação. Passa por defeito ao inquilino atual az login
--service-tree-id <service-tree-id>	Identificador ServiceTree para o registo da aplicação Entra. Obrigatório nos tenants corporativos da Microsoft
--idp-authorization-url <url>	URL de autorização OAuth externa. Necessário quando --auth-type é ExternalOAuth
--idp-token-url <url>	URL externo do token OAuth. Necessário quando --auth-type é ExternalOAuth
--idp-scopes <scopes>	Oscilações OAuth externas. Necessário quando --auth-type é ExternalOAuth
--idp-client-id <client-id>	ID de cliente OAuth externo. Necessário quando --auth-type é ExternalOAuth
--idp-client-secret <client-secret>	Segredo externo do cliente OAuth. Necessário quando --auth-type é ExternalOAuth
--api-key-location <location>	Localização da chave API: Header ou Query. Necessário quando --auth-type é APIKey
--api-key-name <name>	Parâmetro de chave API ou nome do cabeçalho, por exemplo X-API-Key ou token. Necessário quando --auth-type é APIKey
--dry-run	Mostra o que seria feito sem executar
-v, --verbose	Ativar registo verboso
-?, -h, --help	Mostrar ajuda e informação de utilização