Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
El servidor de Protocolo de contexto de modelo de Azure (MCP) le permite administrar recursos de Azure App Service con avisos de lenguaje natural. Puede implementar y actualizar aplicaciones web y API, configurar la configuración de la aplicación, diagnosticar problemas en tiempo de ejecución y enumerar o recuperar los detalles de la aplicación.
Azure App Service es una plataforma totalmente administrada para crear, implementar y escalar aplicaciones web y API; para más información, consulte la documentación de Azure App Service.
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.
Agregar conexión de base de datos
Esta herramienta agrega una conexión de base de datos a un Azure App Service mediante la cadena de conexión de una base de datos existente. Configura las opciones de conexión de App Service para que la aplicación pueda acceder a la base de datos y al servidor de bases de datos especificados. Si no proporciona una cadena de conexión, la herramienta genera una cadena de conexión predeterminada.
Algunas solicitudes de ejemplo incluyen:
- "Agregar la base de datos "ordersdb" del tipo de base de datos "SqlServer" con el servidor de bases de datos "contoso-sql.database.windows.net" a la aplicación "webapp-prod" en el grupo de recursos "rg-prod".
- Configurar la base de datos "userdb" del tipo "MySQL" en el servidor de bases de datos "contoso-mysql.mysql.database.azure.com" para la aplicación "api-staging" en el grupo de recursos "rg-staging".
- Conectar la base de datos de tipo "PostgreSQL" llamada "appdata" con el servidor de bases de datos "pgserver.postgres.database.azure.com" a la aplicación "backend-app" en el grupo de recursos "rg-backend".
- Añadir la base de datos CosmosDB catalogdb, de tipo CosmosDB, con el servidor de bases de datos contoso-cosmos.documents.azure.com, a la aplicación ecommerce-app en el grupo de recursos rg-ecommerce.
- Añade la base de datos inventory de tipo SqlServer en el servidor de bases de datos adventure-works-sql.database.windows.net a la aplicación inventory-service del grupo de recursos rg-inventory.
- "Configurar el tipo de base de datos "analytics" "PostgreSQL" en el servidor de bases de datos "contoso-pg.postgres.database.azure.com" para la aplicación "analytics-api" en el grupo de recursos "rg-analytics" mediante la cadena de conexión "Server=tcp:contoso-pg.postgres.database.azure.com; Database=analytics; User Id=<your-username>; Password=<your-password>'."
- "Agregar el tipo de base de datos "customers" "MySQL" con el servidor de bases de datos "adventure-works-mysql.mysql.database.azure.com" a la aplicación "crm-web" en el grupo de recursos "rg-crm" mediante la cadena de conexión "Server=adventure-works-mysql.mysql.database.azure.com; Database=customers; Uid=<your-username>; Pwd=<your-password>'."
- Conecte la base de datos "sessiondb" de tipo "CosmosDB" en el servidor de bases de datos "fabrikam-cosmos.documents.azure.com" a la aplicación "session-service" en el grupo de recursos "rg-session".
- Configurar la base de datos 'orders' de tipo 'SqlServer' en el servidor de bases de datos 'fabrikam-sql.database.windows.net' para la aplicación 'order-processor' en el grupo de recursos 'rg-orders'.
- "Configure el tipo de base de datos "logs" "PostgreSQL" en el servidor de bases de datos "fabrikam-pg.postgres.database.azure.com" para la aplicación "logger-app" en el grupo de recursos "rg-logging" con la cadena de conexión "Host=fabrikam-pg.postgres.database.azure.com; Database=logs; Username=<your-username>; Password=<your-password>'."
| Parámetro | Obligatorio u opcional | Description |
|---|---|---|
| Nombre de la aplicación | Obligatorio | Nombre de Azure App Service (por ejemplo, my-webapp). |
| Base de datos | Obligatorio | Nombre de la base de datos a la que se va a conectar (por ejemplo, mydb). |
| Servidor de bases de datos | Obligatorio | Nombre del servidor o punto de conexión de la base de datos (por ejemplo, contoso-server.database.windows.net). |
| Tipo de base de datos | Obligatorio | Tipo de base de datos:SqlServer, MySQL, PostgreSQLy Cosmos DB. |
| Grupo de recursos | Obligatorio | Nombre del grupo de recursos de Azure. Este grupo de recursos es un contenedor lógico para los recursos de Azure. |
| Cadena de conexión | Opcional | Cadena de conexión de la base de datos. Si no se proporciona, se genera un valor predeterminado. |
Sugerencias de anotación de herramientas:
| Destructivo | Idempotente | Abrir mundo | Solo lectura | Secret | Requisito local |
|---|---|---|---|---|---|
| ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
Cambio del estado de la aplicación web
Esta herramienta actualiza el estado en ejecución de una aplicación web de Azure App Service mediante uno de los siguientes estados:
-
start: Inicia una aplicación web detenida. -
stop: detiene una aplicación web en ejecución. -
restart: reinicia una aplicación web en ejecución.
Cuando se usa restart, esta herramienta puede realizar un reinicio temporal y esperar sincrónicamente para que la operación se complete antes de volver.
Esta herramienta devuelve un mensaje que indica el resultado de la operación.
Algunas solicitudes de ejemplo incluyen:
- "Inicie la aplicación web con el nombre de la aplicación "api-staging" en el grupo de recursos "rg-staging" y cambie el estado "start".
- Detiene la aplicación de App Service con nombre webapp-prod del grupo de recursos rg-prod con el cambio de estado stop.
- Reinicia la aplicación con nombre “shop-api” en el grupo de recursos “rg-ecommerce” con el cambio de estado “restart” y reinicio suave “true”.
- Reinicia la aplicación con nombre “my-webapp” en el grupo de recursos “rg-dev” con el cambio de estado “restart”, reinicio suave “false” y espera a que finalice “true”.
| Parámetro | Obligatorio u opcional | Description |
|---|---|---|
| Nombre de la aplicación | Obligatorio | Nombre de Azure App Service (por ejemplo, my-webapp). |
| Grupo de recursos | Obligatorio | Nombre del grupo de recursos de Azure. Este grupo de recursos es un contenedor lógico para los recursos de Azure. |
| Cambio de estado | Obligatorio | La acción de cambio de estado que se va a realizar. Los valores válidos son: start, stop, restart. |
| Reinicio suave | Opcional | Cuando el cambio de estado es restart, indica si debe realizarse un reinicio parcial. |
| Esperar a que finalice | Opcional | Cuando el cambio de estado es restart, indica si se debe esperar sincrónicamente a que se complete la operación de cambio de estado antes de devolver. |
Sugerencias de anotación de herramientas:
| Destructivo | Idempotente | Abrir mundo | Solo lectura | Secret | Requisito local |
|---|---|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
Diagnóstico de aplicaciones web
Esta herramienta ejecuta un detector especificado en una aplicación web de Azure App Service y devuelve los resultados de diagnóstico del detector. La salida incluye los resultados del detector y los datos de diagnóstico relacionados para ayudarle a investigar el estado y el comportamiento de la aplicación.
Algunas solicitudes de ejemplo incluyen:
- "Diagnostique la aplicación web "webapp-prod" en el grupo de recursos "rg-prod" con el detector "Availability".
- "Diagnosticar la aplicación web "my-webapp" en el grupo de recursos "webapp-dev" con el detector "CpuAnalysis" entre "2025-03-01T00:00:00Z" y "2025-03-01T01:00:00Z" con el intervalo "PT5M".
| Parámetro | Obligatorio u opcional | Description |
|---|---|---|
| Nombre de la aplicación | Obligatorio | Nombre de Azure App Service (por ejemplo, my-webapp). |
| Identificador del detector | Obligatorio | El ID del detector de diagnóstico que se va a ejecutar. Usa el campo id de la herramienta appservice webapp diagnostic list. |
| Grupo de recursos | Obligatorio | Nombre del grupo de recursos de Azure. Este grupo de recursos es un contenedor lógico para los recursos de Azure. |
| Hora de finalización | Opcional | Hora de finalización en formato ISO (por ejemplo, 2023-01-01T00:00:00Z). |
| Intervalo | Opcional | Intervalo de tiempo (por ejemplo, PT1H durante 1 hora, PT5M durante 5 minutos). |
| Hora de inicio | Opcional | Hora de inicio en formato ISO (por ejemplo, 2023-01-01T00:00:00Z). |
Sugerencias de anotación de herramientas:
| Destructivo | Idempotente | Abrir mundo | Solo lectura | Secret | Requisito local |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Obtención de detalles de implementación
Esta herramienta recupera información detallada sobre las implementaciones en una aplicación web de Azure App Service. Devuelve metadatos como el nombre de la implementación, si la implementación está activa, las horas de inicio y finalización, que crearon y realizaron la implementación y el tipo de implementación.
Algunas solicitudes de ejemplo incluyen:
- "Enumere las implementaciones de la aplicación web "webapp-prod" en el grupo de recursos "rg-prod".
- "Obtenga la implementación 'd4f8c9a2-1b3e-4c5d-9f7a-123456abcdef' para la aplicación web 'webapp-prod' en el grupo de recursos 'rg-prod'".
| Parámetro | Obligatorio u opcional | Description |
|---|---|---|
| Nombre de la aplicación | Obligatorio | Nombre de Azure App Service (por ejemplo, my-webapp). |
| Grupo de recursos | Obligatorio | Nombre del grupo de recursos de Azure. Este grupo de recursos es un contenedor lógico para los recursos de Azure. |
| Identificador de implementación | Opcional | Identificador de la implementación. |
Sugerencias de anotación de herramientas:
| Destructivo | Idempotente | Abrir mundo | Solo lectura | Secret | Requisito local |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Obtención de detalles de la aplicación web
Recupera información detallada sobre las aplicaciones web de Azure App Service, incluidos el nombre de la aplicación, el grupo de recursos, la ubicación, la pila en tiempo de ejecución, el estado y los nombres de host.
Algunas solicitudes de ejemplo incluyen:
- "Enumerar las aplicaciones web en mi suscripción".
- "Mostrarme las aplicaciones web en el grupo de recursos 'rg-prod'".
- "Obtenga los detalles de la aplicación web "api-staging" en el grupo de recursos "rg-staging".
| Parámetro | Obligatorio u opcional | Description |
|---|---|---|
| Nombre de la aplicación | Opcional | Nombre de la aplicación web de Azure App Service (por ejemplo, contoso-webapp). Esta herramienta devuelve detalles de una aplicación web específica cuando proporciona App name; si no proporciona App name, devuelve información de todas las aplicaciones web de la suscripción o de los resource group y subscription especificados. |
| Grupo de recursos | Opcional | Nombre del grupo de recursos de Azure. Este grupo de recursos es un contenedor lógico para los recursos de Azure. |
Sugerencias de anotación de herramientas:
| Destructivo | Idempotente | Abrir mundo | Solo lectura | Secret | Requisito local |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Obtención de la configuración de la aplicación
Esta herramienta recupera la configuración de la aplicación para una aplicación web de Azure App Service y devuelve pares clave-valor para cada configuración. La configuración de la aplicación puede incluir cadenas de conexión y otros valores confidenciales, por lo que tratar los valores devueltos como secretos y limitar su exposición.
Algunas solicitudes de ejemplo incluyen:
- "Enumere la configuración de la aplicación web "my-webapp" en el grupo de recursos "rg-prod".
- Obtener la configuración de la aplicación web orders-api en el grupo de recursos rg-staging.
| Parámetro | Obligatorio u opcional | Description |
|---|---|---|
| Nombre de la aplicación | Obligatorio | Nombre de la aplicación web de Azure App Service (por ejemplo, my-webapp). |
| Grupo de recursos | Obligatorio | Nombre del grupo de recursos de Azure que contiene la aplicación web (por ejemplo, prod-rg). |
Sugerencias de anotación de herramientas:
| Destructivo | Idempotente | Abrir mundo | Solo lectura | Secret | Requisito local |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ✅ | ❌ |
Enumerar detectores de diagnóstico
Esta herramienta recupera información detallada sobre los detectores de una aplicación web de Azure App Service especificada. Para cada detector, devuelve el nombre del detector, el tipo de detector, la descripción, la categoría y los tipos de análisis. Los resultados le ayudan a investigar problemas y a comprender los diagnósticos disponibles para la aplicación web.
Algunas solicitudes de ejemplo incluyen:
- "Enumere los detectores de diagnóstico para la aplicación web "my-webapp" en el grupo de recursos "rg-prod".
| Parámetro | Obligatorio u opcional | Description |
|---|---|---|
| Nombre de la aplicación | Obligatorio | Nombre de Azure App Service (por ejemplo, my-webapp). |
| Grupo de recursos | Obligatorio | Nombre del grupo de recursos de Azure. Este grupo de recursos es un contenedor lógico para los recursos de Azure. |
Sugerencias de anotación de herramientas:
| Destructivo | Idempotente | Abrir mundo | Solo lectura | Secret | Requisito local |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Actualización de la configuración de la aplicación
Esta herramienta actualiza una configuración de aplicación para una aplicación web de App Service. Puede elegir uno de los tres tipos de actualización: add, seto delete.
-
add: crea una nueva configuración de aplicación con el nombre y el valor especificados. Si la configuración de la aplicación ya existe, se produce un error en la operación y se devuelve un error. -
set: crea o actualiza el valor de una configuración de aplicación. Si la configuración de la aplicación no existe,setse comporta comoadd. Si existe, el valor se sobrescribe. -
delete: quita la configuración de aplicación especificada. Si la configuración de la aplicación no existe, no se realiza ninguna acción.
Para los tipos de actualización add y set, se requieren tanto el nombre como el valor de la configuración de la aplicación. Para el tipo de delete actualización, solo se requiere el nombre de configuración de la aplicación.
Algunas solicitudes de ejemplo incluyen:
- Añadir la configuración de aplicación feature-flag con el valor true a la aplicación my-webapp en el grupo de recursos rg-prod con el tipo de actualización de configuración add.
- Establecer el nombre de la configuración de la aplicación db-connection-string con el valor Server=tcp:contoso-sql.database.windows.net;Initial Catalog=orders en la aplicación orders-webapp del grupo de recursos rg-orders con el tipo de actualización de la configuración set.
- Elimina la configuración de aplicación denominada old-api-key de la aplicación legacy-service del grupo de recursos rg-archive con el tipo de actualización de configuración delete.
| Parámetro | Obligatorio u opcional | Description |
|---|---|---|
| Nombre de la aplicación | Obligatorio | Nombre de Azure App Service (por ejemplo, my-webapp). |
| Grupo de recursos | Obligatorio | Nombre del grupo de recursos de Azure que contiene la aplicación web. |
| Nombre de la configuración | Obligatorio | Nombre de la configuración de la aplicación. |
| Establecimiento del tipo de actualización | Obligatorio | Tipo de actualización que se va a realizar en la configuración de la aplicación. Valores válidos: add, set, delete. |
| Valor de configuración | Opcional | Valor de la configuración de la aplicación. Requerido para los tipos de actualización add y set. |
Sugerencias de anotación de herramientas:
| Destructivo | Idempotente | Abrir mundo | Solo lectura | Secret | Requisito local |
|---|---|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |