herramientas de servidor MCP de Azure para Azure Advisor

El Azure servidor MCP le ayuda a administrar Azure Advisor recursos, como aplicar recomendaciones, obtener detalles, enumerar recomendaciones y proporcionar resúmenes, todo ello a través de mensajes de lenguaje natural.

Azure Advisor analiza los recursos de Azure y ofrece recomendaciones personalizadas y accionables para optimizar el costo, el rendimiento, la confiabilidad y la seguridad. Para obtener más información, consulte Azure Advisor documentación.

Nota:

Parámetros de herramienta: las herramientas del servidor MCP de Azure definen parámetros para los datos que necesitan para completar las tareas. Algunos de estos parámetros son específicos de cada herramienta y se documentan aquí. Otros parámetros son globales y compartidos por todas las herramientas. Para obtener más información, consulte Parámetros de la herramienta.

Metadatos: Obtener

Obtiene Azure Advisor metadatos para un tipo de recomendación específico. Devuelve el nombre para mostrar del tipo de recomendación, la categoría, la subcategoría, el impacto, los tipos de recursos admitidos, la descripción, los beneficios potenciales y las acciones de corrección. Use los metadatos para comprender la recomendación, evaluar su impacto y planear los pasos de corrección.

Comando de la CLI de ejemplo

azmcp advisor metadata get \
  --recommendation-type-id <recommendation-type-id> \
  [--language <language>]
Parámetro Type Obligatorio Descripción
recommendation-type-id string Identificador estable del tipo de recomendación de Advisor (properties.recommendationTypeId) para buscar en el catálogo global de metadatos de recomendaciones. Este identificador es la clave de unión que se comparte con las recomendaciones individuales.
language string No Configuración regional del catálogo en la que se va a filtrar (properties.language). Tiene como valor predeterminado en. No distingue entre mayúsculas y minúsculas. Valores admitidos: de, es, id, sv, zh-hans, pt-br, tr, ko, nl, pl, ru, zh-hant, it, pt-pt, hu, ja, fr, cs, en. Advisor acepta etiquetas calificadas por regiones, como en-US y las asigna al idioma base (en).

Sugerencias de anotación de herramientas:

Destructivo Idempotente Abrir mundo Solo lectura Secret Se requiere un recurso local

Metadatos: Lista

Enumera los metadatos de recomendación de Azure Advisor, también conocidos como tipos de recomendación. Le ayuda a detectar qué recomendaciones Azure Advisor pueden generar antes de implementar recursos como máquinas virtuales, incluso cuando no existen recomendaciones activas. Muestra las retiradas del servicio Advisor que se producen en, antes o después de una fecha de retirada especificada, y busca los metadatos de retirada del servicio por el identificador de seguimiento de Service Health. Permite la detección de entornos greenfield con el catálogo global de Azure Resource Graph y el filtrado por tipo de recurso para la incorporación de entornos brownfield. Acepta filtros opcionales para idioma, tipo de recurso, impacto, categoría, subcategoría, identificador de seguimiento y fecha de retirada. Devuelve identificadores de tipo localizados, nombres, categorías, subcategorías, impacto, prioridad, descripciones, beneficios, acciones, ámbito, consulta de origen y detalles sobre la retirada del servicio. Ordena los resultados por impacto de Alto a Medio a Bajo y, a continuación, por nombre para mostrar.

Comando de la CLI de ejemplo

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 Type Obligatorio Descripción
language string No Idioma para metadatos de recomendación localizados. El valor predeterminado es inglés (en). Los idiomas del catálogo admitidos son en, cs, de, es, ja, ru, id, it, hu, ko, pt-PT, pl, nl, fr, sv, tr, pt-BR, zh-Hans y zh-Hant. Las variantes regionales se corresponden con un idioma base admitido cuando existe, como en-US con en y fr-CA con fr; los idiomas del catálogo específicos de cada configuración regional permanecen distintos.
resource-type string No Filtro de tipo de recurso de Azure exacto opcional, como microsoft.compute/virtualmachines. Úselo durante la incorporación de brownfield para detectar los tipos de recomendación aplicables a ese tipo de recurso. El filtro no distingue mayúsculas de minúsculas.
impact string No Filtro opcional del impacto de las recomendaciones. Los valores permitidos son High, Mediumo Low. El filtro no distingue mayúsculas de minúsculas. De forma predeterminada, los resultados aparecen en High, Mediumy luego Low orden.
category string No Filtro exacto opcional de la categoría Advisor. Los valores permitidos son Cost, HighAvailability, Security, Performance y OperationalExcellence. El filtro no distingue mayúsculas de minúsculas.
sub-category string No Filtro de subcategoría de recomendación exacta opcional. El filtro no distingue mayúsculas de minúsculas. Los valores de catálogo conocidos incluyen ComputeOptimization, DataPerformance, DataProtectionAndRecovery, EfficiencyOptimization, NetworkOptimization, MonitoringAndAlerting, Other, RegionalResiliency, GovernanceAndCompliance, Reservations, FailureMitigation, Personalized, SavingsPlan, SafeAndSecureDeployment, ServiceUpgradeAndRetirement, StorageOptimization, Scalability, UsageOptimization y ZoneResiliency. El catálogo puede agregar valores a lo largo del tiempo, por lo que la herramienta acepta otras subcategorías.
tracking-id string No Filtro de identificador de seguimiento de Service Health exacto opcional, como QNY1-HB8. El filtro no distingue mayúsculas de minúsculas y se aplica dentro de ServiceUpgradeAndRetirement los metadatos. Puede omitir --sub-category, pero no puede especificar un valor diferente.
retirement-date string No Filtro opcional de fecha de retirada del servicio en <operator>:<yyyy-MM-dd> formato, por ejemplo ge:2026-03-31. Los operadores admitidos son eq, lt, le, gty ge. Solo se aplica a la ServiceUpgradeAndRetirement subcategoría. Puede omitir --sub-category, pero no puede especificar un valor diferente.

Sugerencias de anotación de herramientas:

Destructivo Idempotente Abrir mundo Solo lectura Secret Se requiere un recurso local

Recomendación: Aplicar

Le ayuda a aplicar las recomendaciones de Azure Advisor a archivos de infraestructura como código (IaC), como plantillas de Azure Resource Manager (ARM) y configuraciones de Terraform. Devuelve las reglas que se aplicarán al archivo IaC.

Comando de la CLI de ejemplo

azmcp advisor recommendation apply \
  --resource <resource>
Parámetro Type Obligatorio Descripción
resource string Tipo de recurso Azure para obtener reglas de archivo IaC. Opciones disponibles: 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

Sugerencias de anotación de herramientas:

Destructivo Idempotente Abrir mundo Solo lectura Secret Se requiere un recurso local

Recomendación: Lista

Enumera recomendaciones de Azure Advisor individuales para una suscripción y devuelve un registro por recomendación. Use este comando solo para ver el contenido y los detalles de la recomendación. En el caso de las preguntas de agregado, clasificación, comparación o recuento, use advisor recommendation summary en su lugar. Devuelve solo las recomendaciones activas con el estado New y excluye las recomendaciones descartadas y pospuestas. Admite filtros opcionales para la categoría, el impacto, el tipo de recurso, el recurso y la búsqueda de texto libre. Los top límites de parámetros devuelven elementos, con un valor predeterminado de 50 y un máximo de 100. Dado que el comando devuelve como máximo 100 registros, usar sus resultados en cálculos agregados podría subestimar el total.

Comando de la CLI de ejemplo

azmcp advisor recommendation list \
  [--category <category>] \
  [--impact <impact>] \
  [--resource-type <resource-type>] \
  [--resource <resource>] \
  [--search <search>] \
  [--top <top>] \
  [--resource-group <resource-group>]
Parámetro Type Obligatorio Descripción
category string No Filtre las recomendaciones por categoría (por ejemplo, Security, Cost, Performance, HighAvailability, OperationalExcellence). Coincidencia exacta sin distinción entre mayúsculas y minúsculas.
impact string No Filtre las recomendaciones por impacto empresarial (High, Mediumo Low). Coincidencia exacta sin distinción entre mayúsculas y minúsculas.
resource-type string No Filtre las recomendaciones por tipo de recurso Azure afectado (por ejemplo, Microsoft.Storage/storageAccounts). Coincidencia exacta sin distinción entre mayúsculas y minúsculas.
resource string No Filtre las recomendaciones por el nombre del recurso afectado o el identificador completo del recurso de ARM. Coincidencia de subcadena sin distinción entre mayúsculas y minúsculas.
search string No Aplica un filtro de texto libre al texto del problema de recomendación (coincidencia de subcadena sin distinción entre mayúsculas y minúsculas). Úselo siempre que una solicitud incluya una frase temática como related to Microsoft Foundry, about encryption, mentioning right-sizeo for Key Vault. Extraiga los nombres destacados de la frase (por ejemplo, Foundry, encrypt, right-size, Key Vault) y páselos aquí.
top string No Número máximo de elementos que se van a devolver. Para list: el valor predeterminado es 50 con un intervalo del lado servidor de 1 a 100. Para summary: límite de visualización opcional del número de cubos devueltos (el valor predeterminado es todos). TotalRecommendations siempre refleja la población filtrada completa independientemente de --top.
resource-group string No El nombre del grupo de recursos de Azure.

Sugerencias de anotación de herramientas:

Destructivo Idempotente Abrir mundo Solo lectura Secret Se requiere un recurso local

Recomendación: Resumen

Este comando agrega recomendaciones de Azure Advisor activas con estado New y devuelve recuentos por cubo más un total preciso. Use este comando para preguntas de agregado, clasificación, comparación y recuento. Los filtros se aplican antes de la agregación. Agrupa los resultados por recommendation-type, category, impacto resource-type. La agrupación predeterminada es category, que expone temas de alto nivel, como Costo, Seguridad y Confiabilidad. El parámetro top limita los intervalos mostrados, pero TotalRecommendations siempre refleja el conjunto completo filtrado. El comando conserva el Unknown cubo como resultado final; incluyelo como la fila final al mostrar grupos en una tabla.

Comando de la CLI de ejemplo

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 Type Obligatorio Descripción
group-by string No Campo por el que se va a agrupar el resumen. Uno de: recommendation-type, category, impact, resource-type. El valor predeterminado es category, que muestra los temas de alto nivel (Coste, Seguridad, Fiabilidad y más), por lo que consultas como summarize the key themes from my Advisor recommendations funcionan sin especificar un campo.
category string No Filtre las recomendaciones por categoría (por ejemplo, Security, Cost, Performance, HighAvailability, OperationalExcellence). Coincidencia exacta sin distinción entre mayúsculas y minúsculas.
impact string No Filtre las recomendaciones por impacto empresarial (High, Mediumo Low). Coincidencia exacta sin distinción entre mayúsculas y minúsculas.
resource-type string No Filtre las recomendaciones por tipo de recurso Azure afectado (por ejemplo, Microsoft.Storage/storageAccounts). Coincidencia exacta sin distinción entre mayúsculas y minúsculas.
resource string No Filtre las recomendaciones por el nombre del recurso afectado o el identificador completo del recurso de ARM. Coincidencia de subcadena sin distinción entre mayúsculas y minúsculas.
search string No Filtro de texto libre aplicado al texto del problema de recomendación (coincidencia de subcadena sin distinción entre mayúsculas y minúsculas). Use este filtro siempre que la solicitud incluya una frase temática como related to Microsoft Foundry, about encryption, mentioning right-sizeo for Key Vault. Extraiga los nombres destacados de la frase (por ejemplo, Foundry, encrypt, right-size, Key Vault) y páselos aquí.
top string No Número máximo de elementos que se van a devolver. Para list: el valor predeterminado es 50, limitado a 1-100 (límite del servidor). Para summary: límite de visualización opcional del número de cubos devueltos (el valor predeterminado es todos). TotalRecommendations siempre refleja el conjunto filtrado completo, independientemente de --top.
resource-group string No El nombre del grupo de recursos de Azure.

Sugerencias de anotación de herramientas:

Destructivo Idempotente Abrir mundo Solo lectura Secret Se requiere un recurso local