Ferramentas do MCP Server para o Assistente do Azure

O servidor MCP Azure ajuda você a gerenciar Assistente do Azure recursos, incluindo a aplicação de recomendações, a obtenção de detalhes, a listagem de recomendações e o fornecimento de resumos, tudo por meio de prompts de linguagem natural.

Assistente do Azure analisa seus recursos de Azure e fornece recomendações personalizadas e acionáveis para otimizar o custo, o desempenho, a confiabilidade e a segurança. Para obter mais informações, consulte Assistente do Azure documentação.

Observação

Parâmetros de ferramenta: as ferramentas do Servidor MCP do Azure definem parâmetros para os dados necessários para concluir tarefas. Alguns desses 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 de ferramenta.

Metadados: Obter

Obtém metadados Assistente do Azure para um tipo de recomendação específico. Retorna o nome de exibição do tipo de recomendação, a categoria, a subcategoria, o impacto, os tipos de recurso com suporte, a descrição, os possíveis benefícios e as ações de remediação. Use os metadados para entender a recomendação, avaliar seu impacto e planejar as etapas de correção.

Exemplo de comando da CLI

azmcp advisor metadata get \
  --recommendation-type-id <recommendation-type-id> \
  [--language <language>]
Parâmetro Tipo Obrigatório Descrição
recommendation-type-id cadeia Yes O ID estável do tipo de recomendação do Advisor (properties.recommendationTypeId) para pesquisar no catálogo global de metadados de recomendações. Essa ID é a chave de junção compartilhada com recomendações individuais.
language cadeia Não Localidade do catálogo usada para filtrar (properties.language). Usa en como padrão. Não diferencia maiúsculas de minúsculas. Valores suportados: en, cs, de, fr, es, hu, id, it, ja, ko, nl, pl, pt-br, pt-pt, ru, sv, tr, zh-hans, zh-hant. O Assistente aceita tags qualificadas por região, como en-US, e as mapeia para o idioma base (en).

Dicas de anotação da ferramenta:

Destrutivo Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Metadados: Lista

Lista os metadados das recomendações do Assistente do Azure, também conhecidos como tipos de recomendação. Ajuda você a descobrir quais recomendações Assistente do Azure podem produzir antes de implantar recursos como máquinas virtuais, mesmo quando não existem recomendações ativas. Mostra as desativações de serviços do Advisor que ocorrem em, antes ou depois de uma data de desativação especificada e localiza metadados sobre a desativação de serviços pela ID de rastreamento da Integridade do Serviço. Oferece suporte à descoberta de ambientes novos com o catálogo global do Azure Resource Graph e à filtragem por tipo de recurso para a integração de ambientes existentes. Aceita filtros opcionais para idioma, tipo de recurso, impacto, categoria, subcategoria, ID de acompanhamento e data de desativação. Retorna IDs de tipo localizadas, nomes, categorias, subcategorias, impacto, prioridade, descrições, benefícios, ações, escopo, consulta de origem e detalhes de desativação do serviço. Ordena resultados por impacto de Alto a Médio a Baixo e, em seguida, por nome de exibição.

Exemplo de comando da CLI

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 Não Idioma para metadados de recomendação localizados. O idioma padrão é inglês (en). Os idiomas de catálogo com suporte são en, cs, , de, es, hufr, , id, it, koja, , nl, pl, , pt-BR, pt-PT, ru, , sv, tr, , zh-Hanse zh-Hant. As variantes regionais são mapeadas para um idioma base com suporte quando disponível, como en-US para en e fr-CA para fr; as linguagens de catálogo específicas da localidade permanecem distintas.
resource-type cadeia Não Filtro de tipo de recurso Azure exato opcional, como microsoft.compute/virtualmachines. Use-o durante a integração brownfield para descobrir os tipos de recomendação aplicáveis a esse tipo de recurso. O filtro não diferencia maiúsculas de minúsculas.
impact cadeia Não Filtro de impacto de recomendação opcional. Os valores permitidos são High, Medium, ou Low. O filtro não diferencia maiúsculas de minúsculas. Por padrão, os resultados aparecem na ordem High, Medium e, em seguida, Low.
category cadeia Não Filtro opcional de categoria exata do Advisor. Os valores permitidos são Cost, HighAvailability, Security, Performance e OperationalExcellence. O filtro não diferencia maiúsculas de minúsculas.
sub-category cadeia Não Filtro de subcategoria de recomendação exata opcional. O filtro não diferencia maiúsculas de minúsculas. Os valores de catálogo conhecidos incluem ComputeOptimization, , DataPerformance, DataProtectionAndRecovery, EfficiencyOptimization, FailureMitigation, GovernanceAndCompliance, MonitoringAndAlerting, NetworkOptimization, Other, Personalized, RegionalResiliency, Reservations, , SafeAndSecureDeployment, SavingsPlan, Scalability, , ServiceUpgradeAndRetirement, StorageOptimization, , UsageOptimizatione ZoneResiliency. O catálogo pode adicionar valores ao longo do tempo, de modo que a ferramenta aceita outras subcategorias.
tracking-id cadeia Não Filtro opcional por ID exato de rastreamento do Service Health, como QNY1-HB8. O filtro não diferencia maiúsculas de minúsculas e se aplica em ServiceUpgradeAndRetirement metadados. Você pode omitir --sub-category, mas não pode especificar um valor diferente.
retirement-date cadeia Não Filtro opcional de data de descontinuação do serviço no formato <operator>:<yyyy-MM-dd>, por exemplo ge:2026-03-31. Os operadores com suporte são eq, lt, , le, gte ge. Aplica-se somente à ServiceUpgradeAndRetirement subcategoria. Você pode omitir --sub-category, mas não pode especificar um valor diferente.

Dicas de anotação da ferramenta:

Destrutivo Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Recomendação: Aplicar

Ajuda a aplicar as recomendações do Assistente do Azure em arquivos de infraestrutura como código (IaC), como modelos do Azure Resource Manager (ARM) e configurações do Terraform. Ele retorna regras a serem aplicadas ao arquivo IaC.

Exemplo de comando da CLI

azmcp advisor recommendation apply \
  --resource <resource>
Parâmetro Tipo Obrigatório Descrição
resource cadeia Yes O tipo de recurso do Azure para o qual obter as regras de arquivo de 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 Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Recomendação: Lista

Lista recomendações de Assistente do Azure individuais para uma assinatura, retornando um registro por recomendação. Use este comando apenas para exibir o conteúdo e os detalhes da recomendação. Para perguntas de agregação, classificação, comparação ou contagem, use advisor recommendation summary em vez disso. Retorna apenas recomendações ativas com status New e exclui recomendações ignoradas e adiadas. Dá suporte a filtros opcionais para categoria, impacto, tipo de recurso, recurso e pesquisa de texto livre. Um top parâmetro limita os itens retornados, com um padrão de 50 e um máximo de 100. Como o comando retorna no máximo 100 registros, o uso de seus resultados para cálculos agregados pode subcontar o total.

Exemplo de comando da CLI

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 Não Filtrar recomendações por categoria (por exemplo, Security, , Cost, Performance, HighAvailability, ). OperationalExcellence Correspondência exata sem diferenciar maiúsculas de minúsculas.
impact cadeia Não Filtrar recomendações por impacto nos negócios (HighouMediumLow). Correspondência exata sem diferenciar maiúsculas de minúsculas.
resource-type cadeia Não Filtrar recomendações por tipo de recurso de Azure afetado (por exemplo, Microsoft.Storage/storageAccounts). Correspondência exata sem diferenciar maiúsculas de minúsculas.
resource cadeia Não Filtrar recomendações por nome do recurso afetado ou ID completo do recurso do ARM. Correspondência de subcadeia de caracteres que não diferencia maiúsculas de minúsculas.
search cadeia Não Aplica um filtro de texto livre no texto do problema de recomendação (busca por trecho de texto sem diferenciar maiúsculas de minúsculas). Use isto sempre que uma solicitação incluir uma frase de tópico, como related to Microsoft Foundry, about encryption, mentioning right-size ou for Key Vault. Extraia os substantivos salientes da frase (por exemplo, , Foundry, encrypt, right-size) Key Vaulte passe-os aqui.
top cadeia Não Número máximo de itens a serem retornados. Para list: o padrão é 50 com um intervalo do lado do servidor de 1 a 100. Para summary: limite opcional de exibição para o número de buckets retornados (o padrão é todos). TotalRecommendations sempre reflete a população filtrada completa, independentemente de --top.
resource-group cadeia Não O nome do grupo de recursos do Azure.

Dicas de anotação da ferramenta:

Destrutivo Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Recomendação: Resumo

Esse comando agrega recomendações de Assistente do Azure ativas com status New e retorna contagens por bucket mais um total preciso. Use este comando para perguntas de agregação, classificação, comparação e contagem. Os filtros se aplicam antes da agregação. Agrupar resultados por recommendation-type, category, impactou resource-type. O agrupamento padrão é category, que apresenta temas de alto nível, como Custo, Segurança e Confiabilidade. O top parâmetro limita os buckets exibidos, mas TotalRecommendations sempre reflete a população filtrada completa. O comando preserva o Unknown bucket como o resultado final; inclua-o como a linha final quando você exibe grupos em uma tabela.

Exemplo de comando da CLI

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 Não Campo pelo qual agrupar o resumo. Um de: recommendation-type, category, impact, resource-type. O padrão é category, que exibe os temas de alto nível (Custo, Segurança, Confiabilidade e muito mais), para que prompts como summarize the key themes from my Advisor recommendations funcionem sem especificar um campo.
category cadeia Não Filtrar recomendações por categoria (por exemplo, Security, , Cost, Performance, HighAvailability, ). OperationalExcellence Correspondência exata sem diferenciar maiúsculas de minúsculas.
impact cadeia Não Filtrar recomendações por impacto nos negócios (HighouMediumLow). Correspondência exata sem diferenciar maiúsculas de minúsculas.
resource-type cadeia Não Filtrar recomendações por tipo de recurso de Azure afetado (por exemplo, Microsoft.Storage/storageAccounts). Correspondência exata sem diferenciar maiúsculas de minúsculas.
resource cadeia Não Filtrar recomendações por nome do recurso afetado ou ID completo do recurso do ARM. Correspondência de subcadeia de caracteres que não diferencia maiúsculas de minúsculas.
search cadeia Não Filtro de texto livre aplicado ao texto do problema de recomendação (correspondência de subcadeia de caracteres que não diferencia maiúsculas de minúsculas). Use esse filtro sempre que sua solicitação incluir uma frase atual, como related to Microsoft Foundry, about encryption, mentioning right-sizeou for Key Vault. Extraia os substantivos salientes da frase (por exemplo, , Foundry, encrypt, right-size) Key Vaulte passe-os aqui.
top cadeia Não Número máximo de itens a serem retornados. Para list: o valor padrão é 50, limitado ao intervalo de 1 a 100 (limite aplicado no servidor). Para summary: limite opcional de exibição para o número de buckets retornados (o padrão é todos). TotalRecommendations sempre reflete a população filtrada completa, independentemente de --top.
resource-group cadeia Não O nome do grupo de recursos do Azure.

Dicas de anotação da ferramenta:

Destrutivo Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Conteúdo relacionado

  • Last updated on