Ferramentas do MCP Server para o Assistente do Azure

O servidor MCP Azure ajuda você a trabalhar com Assistente do Azure por meio de prompts de linguagem natural. Você pode listar, resumir, priorizar e atualizar recomendações, explorar metadados de recomendação, obter diretrizes de correção e verificar o status dos grupos de serviços.

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, a categoria, a subcategoria, o impacto, o tipo de recurso compatível, a descrição, os benefícios potenciais e um link para a documentação (saiba mais) de um tipo de recomendação. Use os metadados para entender o significado de uma recomendação e avaliar seu impacto.

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 A ID de tipo de recomendação estável do Advisor (properties.recommendationTypeId) a ser pesquisada no catálogo global de metadados de recomendação. Essa é a chave de junção compartilhada com recomendações individuais. Required.
language cadeia Não Localidade do catálogo para filtrar (properties.language). O padrão é 'en'. Não diferencia maiúsculas de minúsculas. Valores com suporte: en, cs, de, es, fr, hu, id, it, ja, ko, nl, pl, pt-br, pt-pt, ru, sv, tr, zh-hans, zh-hant. Tags qualificadas por região, como 'en-US', são aceitas e mapeadas para o idioma base ('en').

Dicas de anotação da ferramenta:

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

Metadados: Lista

Lista o catálogo global de metadados de recomendação do Assistente do Azure, também conhecido 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 Assistente 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. 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. Para obter recomendações atuais ou recursos afetados, use Recommendation: List em vez disso.

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 padrão é inglês ('en'). As linguagens de catálogo com suporte são en, cs, de, es, fr, hu, id, it, ja, ko, nl, pl, pt-BR, pt-PT, ru, sv, tr, zh-Hans e 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 opcional exato do tipo de recurso do Azure, 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. Correspondência sem diferenciar maiúsculas de minúsculas.
impact cadeia Não Filtro de impacto de recomendação opcional. Os valores permitidos são Alto, Médio ou Baixo. Correspondência sem diferenciar maiúsculas de minúsculas. Os resultados não filtrados são ordenados em Alto, Médio e Baixo.
category cadeia Não Filtro opcional de categoria exata do Advisor. Os valores permitidos são Cost, HighAvailability, Security, Performance e OperationalExcellence. Não diferencia maiúsculas de minúsculas.
sub-category cadeia Não Filtro de subcategoria de recomendação exata opcional, com correspondência sem diferenciar 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, UsageOptimization e ZoneResiliency. O catálogo pode adicionar valores ao longo do tempo, por isso outras subcategorias são aceitas.
tracking-id cadeia Não Filtro de ID de acompanhamento exato do Service Health opcional, como QNY1-HB8. Encontrado sem diferenciar maiúsculas de minúsculas nos metadados ServiceUpgradeAndRetirement. --subcategoria pode ser omitida, 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 à subcategoria ServiceUpgradeAndRetirement; --sub-category pode ser omitido, 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: Lista

Lista recomendações de Assistente do Azure individuais e seus detalhes de recursos afetados em uma assinatura ou grupo de serviços. Dá suporte a filtros para categoria, subcategoria, impacto, status, ID do tipo de recomendação, recurso afetado, tipo de recurso, texto gratuito, IDs de acompanhamento do Service Health e data de desativação. Retorna recomendações na forma de recurso de Azure Resource Manager (ARM), além de um indicador que mostra se os resultados foram truncados. O name de cada recomendação é seu ID de recomendação.

Use essa ferramenta para exibir recomendações individuais. Para contagens, totais, classificações ou análise agrupada, use Recommendation: Summary em vez disso. Para encontrar as recomendações principais ou mais críticas entre tipos, comece com um resumo priorizado e use essa ferramenta com a ID do tipo de recomendação selecionada e com prioritized definido como true para ordenar suas recomendações individuais.

Exemplo de comando da CLI

azmcp advisor recommendation list \
  [--service-group <service-group>] \
  [--resource-group <resource-group>] \
  [--category <category>] \
  [--impact <impact>] \
  [--status <status>] \
  [--recommendation-type-id <recommendation-type-id>] \
  [--resource-type <resource-type>] \
  [--resource <resource>] \
  [--search <search>] \
  [--sub-category <sub-category>] \
  [--tracking-ids <tracking-id1> <tracking-id2>] \
  [--retirement-date <retirement-date>] \
  [--top <top>] \
  [--prioritized <true|false>] \
  [--show-prioritization-signals <true|false>]
Parâmetro Tipo Obrigatório Descrição
service-group cadeia Não O grupo de serviços do Azure para o qual listar recomendações, fornecido como o segmento de nome de sua ID de recurso do ARM. Especifique um grupo de serviços ou uma assinatura, não ambos. Se você omitir ambos, a ferramenta usará a assinatura padrão configurada.
resource-group cadeia Não O nome do grupo de recursos do Azure. Aplica-se somente ao escopo da assinatura.
category cadeia Não Filtrar recomendações por categoria: Cost, HighAvailability, Security, Performance ou OperationalExcellence. Correspondência exata, sem distinção entre maiúsculas e minúsculas.
impact cadeia Não Filtrar recomendações por impacto nos negócios: High, Mediumou Low. Correspondência exata, sem distinção entre maiúsculas e minúsculas.
status cadeia Não Filtrar recomendações por status: New, Postponed, Dismissed ou Completed. Usa New como padrão.
recommendation-type-id cadeia Não Filtrar recomendações por GUID (ID do tipo de recomendação). Correspondência exata, sem distinção entre maiúsculas e minúsculas.
resource-type cadeia Não Filtrar recomendações por tipo de recurso de Azure afetado, como Microsoft.Storage/storageAccounts. Correspondência exata, sem distinção entre maiúsculas e minúsculas.
resource cadeia Não Filtrar recomendações por nome do recurso afetado ou ID completo do recurso do ARM. Correspondência de substring, sem distinção entre maiúsculas e minúsculas.
search cadeia Não Filtro de texto livre no texto do problema de recomendação, como encryption ou right-size. Correspondência de substring, sem distinção entre maiúsculas e minúsculas. Prefira um filtro estruturado quando se ajusta à solicitação.
sub-category cadeia Não Filtrar recomendações por subcategoria, como ServiceUpgradeAndRetirement ou ZoneResiliency. Não diferencia maiúsculas de minúsculas.
tracking-ids Matriz de cadeias de caracteres Não Filtrar recomendações por uma ou mais IDs de rastreamento do Service Health, como QNY1-HB8. Passe várias IDs como valores separados por espaço. Aplica-se dentro da ServiceUpgradeAndRetirement subcategoria.
retirement-date cadeia Não Filtrar recomendações por data de desativação do serviço no <operator>:<yyyy-MM-dd> formato, por exemplo ge:2026-03-31. Os operadores com suporte são eq, lt, , le, gte ge. Aplica-se dentro da ServiceUpgradeAndRetirement subcategoria.
top inteiro Não Número máximo de registros de recomendação a serem retornados. O padrão é 50, com um intervalo de 1 a 100.
prioritized boolean Não Ordena as recomendações correspondentes por prioridade. Requer recommendation-type-id. As recomendações de custo são ordenadas pela economia anual; outras categorias são ordenadas pela pontuação de criticidade. Usa false como padrão.
show-prioritization-signals boolean Não Inclui os sinais de priorização para cada recomendação quando disponível. Requer prioritized definido como true. Usa false como padrão.

Dicas de anotação da ferramenta:

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

Recomendação: Resumo

Resume as recomendações do Assistente do Azure em uma assinatura ou grupo de serviços, fornecendo contagens, totais, classificações e distribuições processadas no servidor. Use para responder a perguntas como: "quantas existem?", "quais são as subdivisões?", "quais são as mais comuns?" ou "quais tipos de recurso possuem o maior número de recomendações?". Agrupar resultados por recommendation-type, category, impact, resource-type, status, sub-category ou retirement-date. O agrupamento padrão é category. Todos os agrupamentos, exceto status, incluem apenas recomendações ativas com status New.

Defina prioritized como true para classificar os tipos de recomendação ativos por prioridade, para solicitações como recomendações principais, mais críticas ou o que corrigir primeiro. Cada tipo classificado inclui sua contagem de recursos afetados e os sinais que explicam sua classificação. Para ver as recomendações individuais para um tipo ranqueado, use Recommendation: List com sua ID de tipo de recomendação.

TotalRecommendations sempre reflete a população filtrada completa, mesmo quando top limita os grupos retornados.

Exemplo de comando da CLI

azmcp advisor recommendation summary \
  [--service-group <service-group>] \
  [--resource-group <resource-group>] \
  [--group-by <group-by>] \
  [--prioritized <true|false>] \
  [--category <category>] \
  [--impact <impact>] \
  [--recommendation-type-id <recommendation-type-id>] \
  [--resource-type <resource-type>] \
  [--resource <resource>] \
  [--search <search>] \
  [--sub-category <sub-category>] \
  [--retirement-date <retirement-date>] \
  [--top <top>]
Parâmetro Tipo Obrigatório Descrição
service-group cadeia Não O grupo de serviços do Azure a ser resumido, fornecido como o segmento de nome da sua ID de recurso do ARM. Especifique um grupo de serviços ou uma assinatura, não ambos. Se você omitir ambos, a ferramenta usará a assinatura padrão configurada.
resource-group cadeia Não O nome do grupo de recursos do Azure. Aplica-se somente ao escopo da assinatura.
group-by cadeia Não Campo para agrupar o resumo por: recommendation-type, category, impact, resource-type, status, sub-category ou retirement-date. Usa category como padrão. Omita quando prioritized estiver true, porque resumos priorizados sempre agrupam por tipo de recomendação.
prioritized boolean Não Classifica os tipos de recomendação ativos por prioridade em vez de contá-los. O ranking considera a pontuação de prioridade, a economia anual, a criticidade, a data de desativação e a contagem de recursos afetados. Usa false como padrão.
category cadeia Não Filtrar recomendações por categoria: Cost, HighAvailability, Security, Performance ou OperationalExcellence. Não diferencia maiúsculas de minúsculas.
impact cadeia Não Filtrar recomendações por impacto nos negócios: High, Mediumou Low. Não diferencia maiúsculas de minúsculas.
recommendation-type-id cadeia Não Filtrar recomendações por GUID (ID do tipo de recomendação). Correspondência exata, sem distinção entre maiúsculas e minúsculas.
resource-type cadeia Não Filtrar recomendações por tipo de recurso de Azure afetado, como Microsoft.Storage/storageAccounts. Correspondência exata, sem distinção entre maiúsculas e minúsculas.
resource cadeia Não Filtrar recomendações por nome do recurso afetado ou ID completo do recurso do ARM. Correspondência de substring, sem distinção entre maiúsculas e minúsculas.
search cadeia Não Filtro de texto livre no texto do problema de recomendação, como encryption ou right-size. Correspondência de substring, sem distinção entre maiúsculas e minúsculas. Prefira um filtro estruturado quando se ajusta à solicitação.
sub-category cadeia Não Filtrar recomendações por subcategoria, como ServiceUpgradeAndRetirement, ZoneResiliencyou RegionalResiliency. Correspondência exata, sem distinção entre maiúsculas e minúsculas.
retirement-date cadeia Não Filtrar recomendações por data de desativação do serviço no <operator>:<yyyy-MM-dd> formato, por exemplo le:2026-12-31. Os operadores com suporte são eq, lt, , le, gte ge. Os operadores le e lt incluem desativações que já passaram do prazo, mas ainda estão ativas.
top inteiro Não Número máximo de grupos a serem retornados, de 1 a 100. O padrão é para todos os grupos ou para 10 quando prioritized for true.

Dicas de anotação da ferramenta:

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

Recomendação: Atualizar

Atualiza o estado de uma recomendação do Assistente do Azure em uma assinatura ou grupo de serviços. Marque uma recomendação como concluída, ignore-a, adie-a temporariamente até uma data e hora futuras ou reative-a definindo-a como New. Retorna a recomendação atualizada na forma de recurso do ARM. Você não pode atualizar recomendações de segurança ou recomendações que a plataforma resolve.

Exemplo de comando da CLI

azmcp advisor recommendation update \
  --recommendation-id <recommendation-id> \
  --recommendation-status <recommendation-status> \
  [--service-group <service-group>] \
  [--postponed-until-date-time <postponed-until-date-time>] \
  [--recommendation-dismiss-reason <recommendation-dismiss-reason>]
Parâmetro Tipo Obrigatório Descrição
recommendation-id cadeia Yes O ID estável da recomendação do Assistente a ser atualizada.
recommendation-status cadeia Yes O novo estado da recomendação: New, Postponed, Dismissed ou Completed. Use New para reativar uma recomendação adiada, descartada ou concluída.
service-group cadeia Não O grupo de serviços do Azure que contém a recomendação, fornecido como o segmento de nome do ID de recurso ARM. Especifique um grupo de serviços ou uma assinatura, não ambos. Se você omitir ambos, a ferramenta usará a assinatura padrão configurada.
postponed-until-date-time cadeia Não A data e a hora futuras até as quais a recomendação será adiada, no formato ISO 8601 com um deslocamento de fuso horário. Necessário quando recommendation-status é Postponed.
recommendation-dismiss-reason cadeia Não O motivo para descartar a recomendação:ExcessiveCostInvestmentRequired, ImplementationStepsAreUnclear, IncompatibleWithTheCurrentConfiguration, RiskIsAcceptable, TooComplexOrImpracticalToImplement, AnAlternativeSolutionIsAlreadyInPlace ou Other. Quando omitido, o padrão é Other.

Dicas de anotação da ferramenta:

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

Correção: obter

Obtém o pacote de correção para um tipo de recomendação do Assistente do Azure, que explica como corrigi-la. Dependendo da recomendação, o pacote contém orientação manual passo a passo, artefatos prontos para execução nos formatos CLI do Azure, PowerShell, Bicep, modelo ARM e Terraform, ou ambos. Ele também inclui etapas ordenadas, parâmetros, verificação e características, como se a correção é destrutiva ou reversível, sua confiança e seu esforço.

Exemplo de comando da CLI

azmcp advisor remediation get \
  --recommendation-type-id <recommendation-type-id>
Parâmetro Tipo Obrigatório Descrição
recommendation-type-id cadeia Yes A identificação do tipo de recomendação do Assistente (GUID) para o qual obter o pacote de correção, no formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

Dicas de anotação da ferramenta:

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

Inteligência de grupo de serviços: obter

Obtém o status Assistente do Azure atual e a criticidade de um grupo de serviços ou de todos os grupos de serviços acessíveis quando você não especifica um. Os valores de status são On Track, Attention Needed, At Risk, Unavailable e Critical. Cada resultado inclui o nome e a ID do grupo de serviços, a criticidade, o status, a descrição do status, onde se concentrar, a meta quando definida e a hora da última atualização. A resposta também explica como o status é calculado. Se você tiver acesso a vários tenants, especifique o tenant.

Exemplo de comando da CLI

azmcp advisor servicegroupintelligence get \
  [--service-group <service-group>] \
  [--criticality <criticality>] \
  [--status <status>] \
  [--top <top>]
Parâmetro Tipo Obrigatório Descrição
service-group cadeia Não O nome do grupo de serviços, como commerce, e não a ID completa do recurso do ARM. Se você o omitir, a ferramenta retornará todos os grupos de serviços acessíveis.
criticality cadeia Não Filtrar por tier de criticidade: MissionCritical (Tier 0), BusinessCritical (Tier 1), BusinessOperational (Tier 2), Administrative (Tier 3) ou NotApplicable. Não diferencia maiúsculas de minúsculas. Tier0 a Tier3 e 0 a 3 também são aceitos.
status cadeia Não Filtrar por status: On Track, Attention Needed, At Risk, Critical ou Unavailable. Não diferencia maiúsculas de minúsculas e espaços são opcionais.
top inteiro Não Número máximo de grupos de serviços a serem retornados, de 1 a 500. O padrão é 50.

Dicas de anotação da ferramenta:

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

Conteúdo relacionado

  • Última atualização em