Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Il server MCP (Azure Model Context Protocol) consente di gestire le risorse del servizio app di Azure con prompt del linguaggio naturale. È possibile distribuire e aggiornare app Web e API, configurare le impostazioni dell'app, diagnosticare i problemi di runtime ed elencare o recuperare i dettagli dell'app.
Servizio app di Azure è una piattaforma completamente gestita per la creazione, la distribuzione e il ridimensionamento di api e app Web; Per altre informazioni, vedere la documentazione del Servizio app di Azure.
Annotazioni
Parametri degli strumenti: gli strumenti del server MCP di Azure definiscono i parametri per i dati necessari per completare le attività. Alcuni di questi parametri sono specifici di ogni strumento e sono documentati qui. Altri parametri sono globali e condivisi da tutti gli strumenti. Per altre informazioni, vedere Parametri degli strumenti.
Aggiungere una connessione al database
Questo strumento aggiunge una connessione di database a un servizio app di Azure usando la stringa di connessione per un database esistente. Configura le impostazioni di connessione del servizio app in modo che l'app possa accedere al database e al server di database specificati. Se non si specifica una stringa di connessione, lo strumento genera una stringa di connessione predefinita.
Alcuni prompt di esempio includono:
- Aggiungi il database 'ordersdb' di tipo 'SqlServer' con il server di database 'contoso-sql.database.windows.net' all'app 'webapp-prod' nel gruppo di risorse 'rg-prod'.
- Configurare il database 'userdb' di tipo 'MySQL' sul server di database 'contoso-mysql.mysql.database.azure.com' per l'applicazione 'api-staging' nel gruppo di risorse 'rg-staging'.
- Connetti il database 'appdata' di tipo 'PostgreSQL' al server di database 'pgserver.postgres.database.azure.com' per l'applicazione 'backend-app' nel gruppo di risorse 'rg-backend'.
- "Aggiungere il database CosmosDB 'catalogdb' del tipo 'CosmosDB' con il server di database 'contoso-cosmos.documents.azure.com' all'app 'ecommerce-app' nel gruppo di risorse 'rg-ecommerce'."
- Aggiungi il database 'inventory' di tipo 'SqlServer' sul server di database 'adventure-works-sql.database.windows.net' all'app 'inventory-service' nel gruppo di risorse 'rg-inventory'.
- "Configurare il tipo di database 'analytics' del database 'PostgreSQL' nel server di database 'contoso-pg.postgres.database.azure.com' per l'app 'analytics-api' nel gruppo di risorse 'rg-analytics' usando la stringa di connessione 'Server=tcp:contoso-pg.postgres.database.azure.com; Database=analytics; ID utente=<nomeutente>; Password=<your-password>'."
- "Aggiungi il database 'customers' di tipo 'MySQL' con il server di database 'adventure-works-mysql.mysql.database.azure.com' all'applicazione 'crm-web' nel gruppo di risorse 'rg-crm' usando la stringa di connessione 'Server=adventure-works-mysql.mysql.database.azure.com;Database=customers;Uid=<your-username>;Pwd=<your-password>'."
- Connetti il database 'sessiondb' di tipo 'CosmosDB' sul server di database 'fabrikam-cosmos.documents.azure.com' all'applicazione 'session-service' nel gruppo di risorse 'rg-session'.
- Configurare il database 'orders' tipo 'SqlServer' sul server di database 'fabrikam-sql.database.windows.net' per l'app 'order-processor' nel gruppo di risorse 'rg-orders'.
- "Configurare il tipo di database 'logs' del database 'PostgreSQL' nel server di database 'fabrikam-pg.postgres.database.azure.com' per l'app 'logger-app' nel gruppo di risorse 'rg-logging' con la stringa di connessione 'Host=fabrikam-pg.postgres.database.azure.com; Database=logs; Username=<your-username>; Password=<your-password>'."
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Nome dell'app | Obbligatorio | Nome del servizio app di Azure, ad esempio my-webapp. |
| Banca dati | Obbligatorio | Nome del database a cui connettersi, ad esempio mydb. |
| Server di database | Obbligatorio | Nome o endpoint del server per il database, ad esempio contoso-server.database.windows.net. |
| Tipo di database | Obbligatorio | Tipo di database:SqlServer, MySQL, PostgreSQLe Cosmos DB. |
| Gruppo di risorse | Obbligatorio | Nome del gruppo di risorse di Azure. Questo gruppo di risorse è un contenitore logico per le risorse di Azure. |
| Stringa di connessione | Opzionale | Stringa di connessione per il database. Se non specificato, viene generato un valore predefinito. |
Suggerimenti di annotazione degli strumenti:
| Distruttivo | Idempotente | Open World | Sola lettura | Secret | Campo locale obbligatorio |
|---|---|---|---|---|---|
| ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
Modificare lo stato dell'app Web
Questo strumento aggiorna lo stato di esecuzione di un'app Web Servizio app di Azure usando uno degli stati seguenti:
-
start: avvia un'app Web arrestata. -
stop: arresta un'app Web in esecuzione. -
restart: riavvia un'app Web in esecuzione.
Quando si usa restart, questo strumento può eseguire un riavvio leggero e attendere in modo sincrono il completamento dell'operazione prima di tornare.
Questo strumento restituisce un messaggio che indica il risultato dell'operazione.
Alcuni prompt di esempio includono:
- "Avviare l'app Web con il nome dell'app 'api-staging' nel gruppo di risorse 'rg-staging' e modificare lo stato 'start'".
- Arresta l'app di App Service 'webapp-prod' nel gruppo di risorse 'rg-prod' con cambio di stato su 'stop'.
- Riavvia l'app 'shop-api' nel gruppo di risorse 'rg-ecommerce' con cambio di stato 'restart' e riavvio soft 'true'.
- "Riavviare il nome dell'app "my-webapp" nel gruppo di risorse 'rg-dev' con la modifica dello stato 'restart', il riavvio temporaneo 'false' e attendere il completamento 'true'.
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Nome dell'app | Obbligatorio | Nome del servizio app di Azure, ad esempio my-webapp. |
| Gruppo di risorse | Obbligatorio | Nome del gruppo di risorse di Azure. Questo gruppo di risorse è un contenitore logico per le risorse di Azure. |
| Modifica dello stato | Obbligatorio | Azione di modifica dello stato da eseguire. I valori validi sono: start, stop, restart. |
| Riavvio leggero | Opzionale | Quando la modifica dello stato è restart, indica se eseguire un riavvio temporaneo. |
| Attendere il completamento | Opzionale | Quando la modifica dello stato è restart, indica se attendere in modo sincrono il completamento dell'operazione di modifica dello stato prima della restituzione. |
Suggerimenti di annotazione degli strumenti:
| Distruttivo | Idempotente | Open World | Sola lettura | Secret | Campo locale obbligatorio |
|---|---|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
Diagnosticare l'app Web
Questo strumento esegue un rilevatore specificato in un'app Web del servizio app di Azure e restituisce i risultati di diagnostica del rilevatore. L'output include i risultati del rilevamento e i dati di diagnostica correlati per analizzare l'integrità e il comportamento dell'app.
Alcuni prompt di esempio includono:
- Eseguire la diagnosi della webapp 'webapp-prod' nel gruppo di risorse 'rg-prod' con il rilevatore 'Disponibilità'.
- "Diagnosticare l'app Web 'my-webapp' nel gruppo di risorse 'webapp-dev' con rilevamento 'CpuAnalysis' tra '2025-03-01T00:00:00Z' e '2025-03-01T01:00:00Z' con intervallo 'PT5M'".
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Nome dell'app | Obbligatorio | Nome del servizio app di Azure, ad esempio my-webapp. |
| ID rilevatore | Obbligatorio | L'ID del rilevatore diagnostico da eseguire. Usa il campo id dello strumento appservice webapp diagnostic list. |
| Gruppo di risorse | Obbligatorio | Nome del gruppo di risorse di Azure. Questo gruppo di risorse è un contenitore logico per le risorse di Azure. |
| Ora di fine | Opzionale | Ora di fine in formato ISO (ad esempio, 2023-01-01T00:00:00Z). |
| Intervallo | Opzionale | Intervallo di tempo(ad esempio, PT1H per 1 ora, PT5M per 5 minuti). |
| Ora di inizio | Opzionale | Ora di inizio in formato ISO (ad esempio, 2023-01-01T00:00:00Z). |
Suggerimenti di annotazione degli strumenti:
| Distruttivo | Idempotente | Open World | Sola lettura | Secret | Locale richiesto |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Ottenere i dettagli della distribuzione
Questo strumento recupera informazioni dettagliate sulle distribuzioni in un'app Web del servizio app di Azure. Restituisce metadati come il nome della distribuzione, se la distribuzione è attiva, l'ora di inizio e di fine, chi ha creato ed eseguito la distribuzione e il tipo di distribuzione.
Alcuni prompt di esempio includono:
- "Elencare le distribuzioni per l'app Web 'webapp-prod' nel gruppo di risorse 'rg-prod'".
- Ottieni la distribuzione 'd4f8c9a2-1b3e-4c5d-9f7a-123456abcdef' per l'applicazione web 'webapp-prod' nel gruppo di risorse 'rg-prod'.
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Nome dell'app | Obbligatorio | Nome del servizio app di Azure, ad esempio my-webapp. |
| Gruppo di risorse | Obbligatorio | Nome del gruppo di risorse di Azure. Questo gruppo di risorse è un contenitore logico per le risorse di Azure. |
| ID distribuzione | Opzionale | ID della distribuzione. |
Suggerimenti di annotazione degli strumenti:
| Distruttivo | Idempotente | Open World | Sola lettura | Secret | Locale richiesto |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Ottenere i dettagli dell'app Web
Recupera informazioni dettagliate sulle app Web del servizio app di Azure, tra cui nome dell'app, gruppo di risorse, posizione, stack di runtime, stato e nomi host.
Alcuni prompt di esempio includono:
- Elenca le app web nella mia sottoscrizione.
- "Mostra le app Web nel gruppo di risorse 'rg-prod'."
- Ottieni i dettagli dell'app Web 'api-staging' nel gruppo di risorse 'rg-staging'.
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Nome dell'app | Opzionale | Nome dell'app Web del servizio app di Azure , ad esempio contoso-webapp. Questo strumento restituisce i dettagli di un'app Web specifica quando si fornisce App name; se non si fornisce un App name, restituisce informazioni su tutte le app Web nella sottoscrizione o per i valori di resource group e subscription specificati. |
| Gruppo di risorse | Opzionale | Nome del gruppo di risorse di Azure. Questo gruppo di risorse è un contenitore logico per le risorse di Azure. |
Suggerimenti di annotazione degli strumenti:
| Distruttivo | Idempotente | Open World | Sola lettura | Secret | Locale obbligatorio |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Ottenere le impostazioni dell'app
Questo strumento recupera le impostazioni dell'applicazione per un'app Web del servizio app di Azure e restituisce coppie chiave-valore per ogni impostazione. Le impostazioni dell'app possono includere stringhe di connessione e altri valori sensibili, quindi considerare i valori restituiti come segreti e limitare l'esposizione.
Alcuni prompt di esempio includono:
- "Elencare le impostazioni dell'applicazione per l'app Web 'my-webapp' nel gruppo di risorse 'rg-prod'".
- Ottieni le impostazioni dell'applicazione nel gruppo di risorse 'rg-staging' per la web app 'orders-api'.
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Nome dell'app | Obbligatorio | Nome dell'app Web del servizio app di Azure , ad esempio my-webapp. |
| Gruppo di risorse | Obbligatorio | Nome del gruppo di risorse di Azure che contiene l'app Web, ad esempio prod-rg. |
Suggerimenti di annotazione degli strumenti:
| Distruttivo | Idempotente | Open World | Sola lettura | Secret | Impostazione locale obbligatoria |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ✅ | ❌ |
Elencare i rilevatori di diagnostica
Questo strumento recupera informazioni dettagliate sui rilevatori per un'app Web del servizio app di Azure specificata. Per ogni rilevatore, restituisce il nome del rilevatore, il tipo di rilevamento, la descrizione, la categoria e i tipi di analisi. I risultati consentono di analizzare i problemi e comprendere la diagnostica disponibile per l'app Web.
Alcuni prompt di esempio includono:
- "Elencare i rilevatori di diagnostica per l'app Web "my-webapp" nel gruppo di risorse "rg-prod".
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Nome dell'app | Obbligatorio | Nome del servizio app di Azure, ad esempio my-webapp. |
| Gruppo di risorse | Obbligatorio | Nome del gruppo di risorse di Azure. Questo gruppo di risorse è un contenitore logico per le risorse di Azure. |
Suggerimenti di annotazione degli strumenti:
| Distruttivo | Idempotente | Open World | Sola lettura | Secret | Locale richiesto |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Aggiornare le impostazioni dell'app
Questo strumento aggiorna un'impostazione di un'applicazione per un'app Web di App Service. È possibile scegliere uno dei tre tipi di aggiornamento: add, seto delete.
-
add: crea una nuova impostazione dell'applicazione con il nome e il valore specificati. Se l'impostazione dell'applicazione esiste già, l'operazione ha esito negativo e restituisce un errore. -
set: crea o aggiorna il valore di un'impostazione dell'applicazione. Se l'impostazione dell'applicazione non esiste,setsi comporta comeadd. Se esiste, il valore viene sovrascritto. -
delete: rimuove l'impostazione dell'applicazione specificata. Se l'impostazione dell'applicazione non esiste, non viene eseguita alcuna azione.
Per i add tipi di aggiornamento e set sono necessari sia il nome dell'impostazione dell'applicazione che il valore. Per il delete tipo di aggiornamento, è necessario solo il nome dell'impostazione dell'applicazione.
Alcuni prompt di esempio includono:
- "Aggiungere il nome dell'impostazione dell'applicazione 'feature-flag' con valore 'true' all'app 'my-webapp' nel gruppo di risorse 'rg-prod' con l'impostazione del tipo di aggiornamento 'add'".
- "Impostare il nome dell'impostazione dell'applicazione 'db-connection-string' con valore 'Server=tcp:contoso-sql.database.windows.net; Catalogo iniziale=ordini' nell'app 'orders-webapp' nel gruppo di risorse 'rg-orders' con l'impostazione del tipo di aggiornamento 'set'".
- "Eliminare il nome dell'impostazione dell'applicazione 'old-api-key' dall'app 'legacy-service' nel gruppo di risorse 'rg-archive' con l'impostazione del tipo di aggiornamento 'delete'".
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Nome dell'app | Obbligatorio | Nome del servizio app di Azure, ad esempio my-webapp. |
| Gruppo di risorse | Obbligatorio | Nome del gruppo di risorse di Azure che contiene l'app Web. |
| Nome dell'impostazione | Obbligatorio | Nome dell'impostazione dell'applicazione. |
| Impostazione del tipo di aggiornamento | Obbligatorio | Tipo di aggiornamento da eseguire sull'impostazione dell'applicazione. Valori validi: add, set, delete. |
| Impostazione del valore | Opzionale | Valore dell'impostazione dell'applicazione. Obbligatorio per i tipi di aggiornamento add e set. |
Suggerimenti di annotazione degli strumenti:
| Distruttivo | Idempotente | Open World | Sola lettura | Secret | Obbligatorio in locale |
|---|---|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |