Ferramentas do servidor Azure MCP para o Assistente do Azure

O Azure MCP Server ajuda-o a gerir os recursos do Assistente do Azure, incluindo a aplicação de recomendações, obtenção de detalhes, listagem de recomendações e fornecimento de resumos, tudo através de prompts em linguagem natural.

O Assistente do Azure analisa os seus recursos Azure e fornece recomendações personalizadas e acionáveis para otimizar custos, desempenho, fiabilidade e segurança. Para mais informações, consulte a documentação do Assistente do Azure.

Observação

Parâmetros da ferramenta: as ferramentas do Servidor MCP do Azure definem parâmetros para os dados de que precisam para concluir tarefas. Alguns destes parâmetros são específicos para cada ferramenta e estão documentados aqui. Outros parâmetros são globais e compartilhados por todas as ferramentas. Para obter mais informações, consulte Parâmetros da ferramenta.

Metadados: Obter

Obtém metadados do Assistente do Azure para um tipo específico de recomendação. Devolve o nome a apresentar, a categoria, a subcategoria, o impacto, os tipos de recursos suportados, a descrição, os benefícios potenciais e as ações de remediação do tipo de recomendação. Use os metadados para compreender a recomendação, avaliar o seu impacto e planear os passos de remediação.

Comando CLI de exemplo

azmcp advisor metadata get \
  --recommendation-type-id <recommendation-type-id> \
  [--language <language>]
Parâmetro Tipo Obrigatório Descrição
recommendation-type-id cadeia (de caracteres) Sim O ID de tipo de recomendação estável do Advisor (properties.recommendationTypeId) para consultar no catálogo global de recomendações-metadados. Este ID é a chave de associação partilhada pelas recomendações individuais.
language cadeia (de caracteres) No Configuração regional do catálogo pela qual filtrar (properties.language). O valor padrão é en. Não diferencia maiúsculas de minúsculas. Valores suportados: en, cs, de, es, fr, hu, id, it, ja, ko, nl, pl, pt-br, pt-pt, ru, sv, tr, zh-hans, zh-hant. O Advisor aceita etiquetas qualificadas por região, como , en-US e mapeia-as para a língua base (en).

Dicas de anotação da ferramenta:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Localidade obrigatória

Metadados: Lista

Lista metadados de recomendação do Assistente do Azure, também conhecidos como tipos de recomendação. Ajuda-te a descobrir que recomendações o Assistente do Azure pode produzir antes de implementares recursos como máquinas virtuais, mesmo quando não existem recomendações ativas. Mostra as descontinuações de serviços no Advisor que ocorrem na data de descontinuação especificada, antes dela ou depois dela, e localiza metadados sobre a descontinuação do serviço através do ID de rastreio do Service Health. Suporta descoberta greenfield com o catálogo global Azure Resource Graph e filtragem por tipo de recurso para integração brownfield. Aceita filtros opcionais para idioma, tipo de recurso, impacto, categoria, subcategoria, ID de rastreio e data de reforma. Devolve IDs de tipos localizados, nomes, categorias, subcategorias, impacto, prioridade, descrições, benefícios, ações, âmbito, consulta de origem e detalhes da descontinuação do serviço. Ordena os resultados por impacto, de Alto a Médio a Baixo, e depois por nome a apresentar.

Comando CLI de exemplo

azmcp advisor metadata list \
  [--language <language>] \
  [--resource-type <resource-type>] \
  [--impact <impact>] \
  [--category <category>] \
  [--sub-category <sub-category>] \
  [--tracking-id <tracking-id>] \
  [--retirement-date <retirement-date>]
Parâmetro Tipo Obrigatório Descrição
language cadeia (de caracteres) No Linguagem para metadados de recomendação localizada. A predefinição é Inglês (en). Os idiomas de catálogo suportados são en, cs, de, fr, es, hu, id, it, ko, sv, tr, zh-Hans, ja, pl, zh-Hant, nl, pt-BR, pt-PT e ru. As variantes regionais são mapeadas para um idioma base suportado, quando disponível, como en-US para en e fr-CA para fr; os idiomas de catálogo específicos da região permanecem distintos.
resource-type cadeia (de caracteres) No Filtro de tipo de recurso exato do Azure opcional, como microsoft.compute/virtualmachines. Utilize-o durante a integração em brownfield para descobrir tipos de recomendações aplicáveis a esse tipo de recurso. O filtro não diferencia maiúsculas de minúsculas.
impact cadeia (de caracteres) No Filtro opcional do impacto das recomendações. Os valores permitidos são High, Mediumou Low. O filtro não diferencia maiúsculas de minúsculas. Por defeito, os resultados aparecem em High, Medium, e depois Low em ordem.
category cadeia (de caracteres) No Filtro exato opcional da categoria de Consultor. Os valores permitidos são Cost, HighAvailability, Security, Performance, e OperationalExcellence. O filtro não diferencia maiúsculas de minúsculas.
sub-category cadeia (de caracteres) No Filtro opcional de subcategoria de recomendação exata. O filtro não diferencia maiúsculas de minúsculas. Valores de catálogo conhecidos incluem ComputeOptimization, DataPerformance, DataProtectionAndRecovery, FailureMitigation, EfficiencyOptimization, GovernanceAndCompliance, MonitoringAndAlerting, NetworkOptimization, Other, Personalized, RegionalResiliency, ServiceUpgradeAndRetirement, Reservations, SavingsPlan, ZoneResiliency, SafeAndSecureDeployment, Scalability, StorageOptimization e UsageOptimization. O catálogo pode adicionar valores ao longo do tempo, por isso a ferramenta aceita outras subcategorias.
tracking-id cadeia (de caracteres) No Filtro opcional exato de ID de monitorização de Saúde do Serviço, como QNY1-HB8. O filtro é insensível a maiúsculas minúsculas e aplica-se dentro dos ServiceUpgradeAndRetirement metadados. Podes omitir --sub-category, mas não podes especificar um valor diferente.
retirement-date cadeia (de caracteres) No Filtro opcional por data de desativação do serviço no formato <operator>:<yyyy-MM-dd>, por exemplo ge:2026-03-31. Os operadores suportados são eq, lt, le, gt, e ge. Aplica-se apenas à ServiceUpgradeAndRetirement subcategoria. Podes omitir --sub-category, mas não podes especificar um valor diferente.

Dicas de anotação da ferramenta:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Localidade obrigatória

Recomendação: Candidatar-se

Ajuda a aplicar recomendações do Assistente do Azure a ficheiros infrastructure-as-code (IaC), como templates do Azure Resource Manager (ARM) e configurações do Terraform. Retorna regras a aplicar ao ficheiro IaC.

Comando CLI de exemplo

azmcp advisor recommendation apply \
  --resource <resource>
Parâmetro Tipo Obrigatório Descrição
resource cadeia (de caracteres) Sim O tipo de recurso do Azure para o qual obter as regras do ficheiro IaC. Opções disponíveis: aad_domainservices, apimanagement_service, cognitiveservices_accounts, compute_virtualmachines, compute_virtualmachinescalesets, containerregistry_registries, containerservice_managedclusters, dbforpostgresql_flexibleservers, documentdb_databaseaccounts, keyvault_vaults, kubernetes_connectedclusters, kubernetesconfiguration_extensions, netapp_volumes, network_applicationgatewaywebapplicationfirewallpolicies, network_expressrouteports, network_frontdoorwebapplicationfirewallpolicies, sql_managedinstances, storage_storageaccounts, web_serverfarms, web_staticsites

Dicas de anotação da ferramenta:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Localidade obrigatória

Recomendação: Lista

Lista recomendações individuais do Assistente do Azure para uma subscrição, devolvendo um registo por recomendação. Use este comando apenas para visualizar conteúdos e detalhes das recomendações. Para perguntas agregadas, de ranking, comparação ou contagem, use advisor recommendation summary em vez disso. Só devolve recomendações ativas com estado New e exclui recomendações rejeitadas e adiadas. Suporta filtros opcionais para categoria, impacto, tipo de recurso, recurso e pesquisa em texto livre. Um top parâmetro limita os itens devolvidos, com um padrão de 50 e um máximo de 100. Como o comando devolve no máximo 100 registos, usar os seus resultados para cálculos agregados pode subestimar o total.

Comando CLI de exemplo

azmcp advisor recommendation list \
  [--category <category>] \
  [--impact <impact>] \
  [--resource-type <resource-type>] \
  [--resource <resource>] \
  [--search <search>] \
  [--top <top>] \
  [--resource-group <resource-group>]
Parâmetro Tipo Obrigatório Descrição
category cadeia (de caracteres) No Filtrar recomendações por categoria (por exemplo, Security, Cost, Performance, HighAvailability, OperationalExcellence). Correspondência exata sem distinção entre maiúsculas e minúsculas.
impact cadeia (de caracteres) No Filtre as recomendações por impacto no negócio (High, Medium, ou Low). Correspondência exata sem distinção entre maiúsculas e minúsculas.
resource-type cadeia (de caracteres) No Filtrar recomendações por tipo de recurso Azure impactado (por exemplo, Microsoft.Storage/storageAccounts). Correspondência exata sem distinção entre maiúsculas e minúsculas.
resource cadeia (de caracteres) No Filtre as recomendações pelo nome do recurso afetado ou pelo ID completo do recurso ARM. Correspondência de substring insensível a maiúsculas minúsculas.
search cadeia (de caracteres) No Aplica um filtro de texto livre ao texto do problema de recomendação (correspondência de subcadeias sem distinção entre maiúsculas e minúsculas). Utilize isto sempre que uma solicitação incluir uma expressão temática como related to Microsoft Foundry, about encryption, mentioning right-size ou for Key Vault. Extrai os substantivos salientes da frase (por exemplo, Foundry, encrypt, right-size, Key Vault) e passa-os aqui.
top cadeia (de caracteres) No Número máximo de itens a devolver. Para list: o valor predefinido é 50, com um intervalo no servidor de 1 a 100. Para summary: limite opcional de apresentação do número de buckets devolvidos (por predefinição, todos). TotalRecommendations Reflete sempre a população filtrada completa, independentemente de --top.
resource-group cadeia (de caracteres) No O nome do grupo de recursos do Azure.

Dicas de anotação da ferramenta:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Localidade obrigatória

Recomendação: Resumo

Este comando agrega recomendações ativas do Assistente do Azure com o estado New e devolve as contagens por bucket, além de um total preciso. Use este comando para perguntas de agregado, classificação, comparação e contagem. Os filtros aplicam-se antes da agregação. Agrupar resultados por recommendation-type, category, impact, ou resource-type. O agrupamento padrão é category, que destaca temas de alto nível como Custo, Segurança e Fiabilidade. O top parâmetro limita os buckets exibidos, mas TotalRecommendations reflete sempre a população totalmente filtrada. O comando preserva o Unknown balde como resultado final; inclua-o como a última linha quando apresenta grupos numa tabela.

Comando CLI de exemplo

azmcp advisor recommendation summary \
  [--group-by <group-by>] \
  [--category <category>] \
  [--impact <impact>] \
  [--resource-type <resource-type>] \
  [--resource <resource>] \
  [--search <search>] \
  [--top <top>] \
  [--resource-group <resource-group>]
Parâmetro Tipo Obrigatório Descrição
group-by cadeia (de caracteres) No Campo pelo qual agrupar o resumo. Um de: recommendation-type, category, impact, resource-type. A predefinição é category, que apresenta os temas de alto nível (Custo, Segurança, Fiabilidade, entre outros), pelo que instruções como summarize the key themes from my Advisor recommendations funcionam sem nomear um campo.
category cadeia (de caracteres) No Filtrar recomendações por categoria (por exemplo, Security, Cost, Performance, HighAvailability, OperationalExcellence). Correspondência exata sem distinção entre maiúsculas e minúsculas.
impact cadeia (de caracteres) No Filtre as recomendações por impacto no negócio (High, Medium, ou Low). Correspondência exata sem distinção entre maiúsculas e minúsculas.
resource-type cadeia (de caracteres) No Filtrar recomendações por tipo de recurso Azure impactado (por exemplo, Microsoft.Storage/storageAccounts). Correspondência exata sem distinção entre maiúsculas e minúsculas.
resource cadeia (de caracteres) No Filtre as recomendações pelo nome do recurso afetado ou pelo ID completo do recurso ARM. Correspondência de substring insensível a maiúsculas minúsculas.
search cadeia (de caracteres) No Filtro de texto livre aplicado ao texto do problema de recomendação (correspondência por subcadeia sem distinção entre maiúsculas e minúsculas). Use este filtro sempre que o seu pedido incluir uma frase temática como related to Microsoft Foundry, about encryption, mentioning right-size, ou for Key Vault. Extrai os substantivos salientes da frase (por exemplo, Foundry, encrypt, right-size, Key Vault) e passa-os aqui.
top cadeia (de caracteres) No Número máximo de itens a devolver. Para list: o valor predefinido é 50, limitado ao intervalo de 1 a 100 (limite aplicado no servidor). Para summary: limite opcional de apresentação do número de buckets devolvidos (por predefinição, todos). TotalRecommendations Reflete sempre a população filtrada completa, independentemente de --top.
resource-group cadeia (de caracteres) No O nome do grupo de recursos do Azure.

Dicas de anotação da ferramenta:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Localidade obrigatória