Introducción a las herramientas de Azure App Configuration para azure MCP Server

El Azure servidor MCP permite administrar Azure recursos, incluidos los almacenes de App Configuration, mediante mensajes de lenguaje natural. Puede administrar rápidamente las opciones de configuración y las marcas de características sin necesidad de recordar una sintaxis compleja.

Azure App Configuration proporciona un servicio para administrar de forma centralizada la configuración de la aplicación y las marcas de características. Los programas modernos, especialmente los que se ejecutan en una nube, suelen tener muchos componentes distribuidos. La propagación de valores de configuración entre estos componentes puede conducir a errores difíciles de solucionar durante la implementación de una aplicación. Use App Configuration para almacenar todas las opciones de configuración de la aplicación y proteger su acceso en un solo lugar.

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.

Cuenta: Enumerar almacenes

Azure MCP Server puede enumerar los almacenes de App Configuration en una suscripción. Esto resulta útil para comprobar rápidamente el estado de los recursos de App Configuration.

Algunas solicitudes de ejemplo incluyen:

  • Lista de almacenes: "Enumerar todos los almacenes de App Configuration en mi suscripción".
  • Mostrar tiendas: "¿Qué tiendas de App Configuration tengo?"
  • Buscar almacenes: "Necesito ver mis recursos de App Configuration"
  • Almacenes de consultas: "¿Puede mostrarme todos mis almacenes de App Config?"
  • Verificar almacenes: "Almacenes de App Configuration en la suscripción abc123"

Sugerencias de anotación de herramientas:

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

Clave-valor: Eliminar configuración

Elimina una configuración de clave-valor de un almacén de App Configuration. Si especifica una etiqueta, la herramienta solo elimina esa versión etiquetada. Si omite una etiqueta, la herramienta elimina el valor de clave con la etiqueta predeterminada.

Algunas solicitudes de ejemplo incluyen:

  • Eliminar una configuración: "Quitar la clave 'AppName:TemporaryConfig' de mi almacén de configuración de aplicaciones 'myappconfigstore'".
  • Eliminar una configuración etiquetada: «Elimine la configuración "AppName:FeatureFlag" con la etiqueta "test" del almacén de App Configuration "myappconfigstore"»
  • Quitar configuración: "Eliminar la clave 'ProductionEndpointUrl' del almacén de configuración de la aplicación 'contoso-appconfig'"
  • Limpiar configuración: "Elimine la clave "TestSettings" con la etiqueta "en desuso" de la tienda de App Configuration "myappconfigstore"
  • Purge config: "Eliminar la configuración temporal "TempConfig" de app-config-dev"
Parámetro Obligatorio u opcional Descripción
Cuenta Obligatorio Nombre del almacén de configuración de la aplicación (por ejemplo, my-appconfig).
Clave Obligatorio Nombre de la clave para acceder al almacén de configuración de aplicaciones.
Etiqueta Opcional Etiqueta que se va a aplicar a la clave de configuración. Las etiquetas se usan para agrupar y organizar la configuración.

Sugerencias de anotación de herramientas:

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

Clave-valor: Obtención de los valores de clave

Obtiene los pares clave-valor en un almacén de App Configuration. Este comando puede proporcionar una de las siguientes acciones:

  • Recuperar un par clave-valor específico por su clave y etiqueta opcional
  • Enumere los valores de clave si no se proporciona ninguna clave.

La enumeración de los valores de clave puede filtrarse opcionalmente por un filtro de clave y un filtro de etiqueta. Cada clave-valor incluye su clave, valor, etiqueta, tipo de contenido, ETag, hora de última modificación y estado de bloqueo.

Algunas solicitudes de ejemplo incluyen:

  • Enumerar todas las configuraciones de clave-valor: "Enumerar todas las configuraciones de clave-valor en el almacén de App Configuration 'myappconfigstore'"
  • Mostrar configuración de clave-valor: "Muéstrame la configuración de clave-valor en el almacén de App Configuration 'contoso-appconfig'"
  • Filtrar por prefijo de clave: "Enumera todas las configuraciones de clave-valor con un nombre de clave que empiece por 'prod-' en el almacén de App Configuration 'production-config'"
  • Obtener contenido de clave específico: «Mostrar el contenido de la clave 'AppName:ConnectionString' en el almacén de configuración de aplicaciones 'eastus-config'»
  • Configuración específica del entorno: "Enumere todas las configuraciones de clave-valor que comienzan con 'dev-' en el almacén de configuración de aplicaciones 'development-config'"
  • Obtener configuración etiquetada: "Muéstrame la configuración clave-valor con la etiqueta 'staging' en el almacén de App Configuration 'app-config-staging'"
  • Configuración de API: "Mostrar el contenido de la clave "ApiSettings:Endpoint" en el almacén de App Configuration "api-config"
  • Configuraciones de base de datos: "Enumerar todos los conjuntos de claves y valores cuyo nombre de clave empiece con 'Database' en el almacén de configuración de aplicaciones 'backend-config'"
  • Banderas de características: "Muéstrame la configuración de clave-valor con la etiqueta 'features' en el almacén de App Configuration 'feature-config'"
  • Punto de conexión del servicio: «Muestra el contenido de la clave "Endpoints:ApiBaseUrl" en el almacén de App Configuration "service-config".»
Parámetro Obligatorio u opcional Descripción
Cuenta Obligatorio Nombre del almacén de configuración de aplicaciones (por ejemplo, my-appconfig).
Clave Opcional Nombre de la clave para acceder al almacén de configuración de aplicaciones.
Etiqueta Opcional Etiqueta que se va a aplicar a la clave de configuración. Las etiquetas se usan para agrupar y organizar la configuración.
Filtro de claves Opcional Especifica el filtro de clave, si existe, que se va a usar al recuperar los valores de clave. El filtro puede ser una coincidencia exacta, por ejemplo, un filtro de foo obtendría todos los valores de clave con una clave de foo, o el filtro puede incluir un carácter * al final de la cadena para las búsquedas de caracteres comodín (por ejemplo, App*). Si se omite, se recuperan todas las claves.
Filtro de etiqueta Opcional Especifica el filtro de etiqueta, si existe, que se va a usar al recuperar los valores de clave. El filtro puede ser una coincidencia exacta, por ejemplo, un filtro de foo obtendría todos los valores de clave con una etiqueta de foo, o el filtro puede incluir un carácter * al final de la cadena para las búsquedas de caracteres comodín (por ejemplo, Prod*). Este filtro distingue mayúsculas de minúsculas. Si se omite, se recuperan automáticamente todas las etiquetas.

Sugerencias de anotación de herramientas:

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

Clave-valor: establecer un bloqueo de clave-valor

Establece el estado de bloqueo de un par clave-valor en un almacén de App Configuration. Este comando puede bloquear y desbloquear los valores de clave.

Algunas solicitudes de ejemplo incluyen:

  • Bloquear una configuración: "Bloquear la clave 'AppName:ConnectionString' en el almacén de App Configuration 'myappconfigstore'".
  • Bloquear una configuración etiquetada: "Bloquear la clave "AppName:ApiEndpoint" con la etiqueta "production" en el almacén de App Configuration "contoso-appconfig".
  • Ajuste una configuración: "Desbloquee la clave 'AppName:ConnectionString' en el almacén de configuración de aplicaciones 'myappconfigstore'."
  • Desbloquee una configuración con etiqueta: "Desbloquee la clave 'AppName:ApiEndpoint' con la etiqueta 'production' en el almacén de App Configuration 'contoso-appconfig'."
Parámetro Obligatorio u opcional Descripción
Cuenta Obligatorio El nombre del almacén de App Configuration (por ejemplo, my-appconfig).
Clave Obligatorio Nombre de la clave para acceder al almacén de configuración de aplicaciones.
Etiqueta Opcional Etiqueta que se va a aplicar a la clave de configuración. Las etiquetas se usan para agrupar y organizar la configuración.
tipo de contenido de Opcional Tipo de contenido del valor de configuración. Se usa para indicar cómo se debe interpretar o analizar el valor.
Lock Opcional Indica si un valor de clave está bloqueado (establecido en read-only) o desbloqueado (read-only quitado).

Sugerencias de anotación de herramientas:

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

Clave-valor: establecer la configuración de clave-valor

Establezca o actualice una configuración de clave-valor en un almacén de App Configuration.

Algunas solicitudes de ejemplo incluyen:

  • Crear una configuración: "Crea una nueva clave 'AppName:ApiUrl' con el valor 'https://api.example.com' en mi almacén de App Configuration 'myappconfigstore'."
  • Actualice una configuración: "Actualice la clave "AppName:MaxRetries" al valor "5" en el almacén de App Configuration "myappconfigstore"
  • Crear una configuración etiquetada: "Establece 'AppName:LogLevel' con el valor 'Debug' y con la etiqueta 'dev' en mi almacén de App Configuration 'contoso-appconfig'."
  • Agregar nueva configuración: "Agregue una nueva configuración denominada "ApiEndpoint" con el valor de dirección URL "https://api.contoso.com" a mi "eastus-config"
  • Cambiar el valor existente: "La clave 'MaxThreads' a sido establecida al valor '10' en el almacén de configuración de aplicaciones 'appconfig-prod'"
Parámetro Obligatorio u opcional Descripción
Nombre de cuenta Obligatorio El nombre del almacén de App Configuration.
Clave Obligatorio Nombre de clave de la configuración que se va a establecer.
Valor Obligatorio Valor que se va a establecer para la clave.
Etiqueta Opcional Etiqueta de la configuración que se va a establecer.
Etiquetas Opcional Etiquetas que se van a asociar a la clave de configuración. Las etiquetas deben tener el formato key=value. Puede especificar varias etiquetas.
tipo de contenido de Opcional Tipo de contenido del valor de configuración. Este valor indica cómo se debe interpretar o analizar el valor.

Sugerencias de anotación de herramientas:

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