Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Mit dem Azure Model Context Protocol (MCP)-Server können Sie Azure App Service-Ressourcen mit Anweisungen in natürlicher Sprache verwalten. Sie können Web-Apps und APIs bereitstellen und aktualisieren, App-Einstellungen konfigurieren, Laufzeitprobleme diagnostizieren und auflisten oder App-Details abrufen.
Azure App Service ist eine vollständig verwaltete Plattform zum Erstellen, Bereitstellen und Skalieren von Web-Apps und APIs; weitere Informationen finden Sie in der Dokumentation zu Azure App Service.
Hinweis
Toolparameter: Die Azure MCP Server-Tools definieren Parameter für Daten, die sie zum Ausführen von Aufgaben benötigen. Einige dieser Parameter sind für jedes Tool spezifisch und werden hier dokumentiert. Andere Parameter sind global und werden von allen Tools gemeinsam genutzt. Weitere Informationen finden Sie unter Toolparameter.
Datenbankverbindung hinzufügen
Dieses Tool fügt eine Datenbankverbindung zu einem Azure App Service mithilfe der Verbindungszeichenfolge für eine vorhandene Datenbank hinzu. Sie konfiguriert die Verbindungseinstellungen des App-Diensts, sodass die App auf die angegebene Datenbank und den Datenbankserver zugreifen kann. Wenn Sie keine Verbindungszeichenfolge bereitstellen, generiert das Tool eine Standardverbindungszeichenfolge.
Beispiele für Prompts:
- "Fügen Sie die Datenbank 'ordersdb' des Datenbanktyps 'SqlServer' mit dem Datenbankserver 'contoso-sql.database.windows.net' der App 'webapp-prod' in der Ressourcengruppe 'rg-prod' hinzu."
- "Konfiguriere den Datenbanktyp 'MySQL' der Datenbank 'userdb' auf dem Datenbankserver 'contoso-mysql.mysql.database.azure.com' für die App 'api-staging' in der Ressourcengruppe 'rg-staging'."
- "Verbinde die Datenbank 'appdata', Datenbanktyp 'PostgreSQL', mit dem Datenbankserver 'pgserver.postgres.database.azure.com' zur App 'backend-app' in der Ressourcengruppe 'rg-backend'."
- Fügen Sie die CosmosDB-Datenbank 'catalogdb' des Datenbanktyps 'CosmosDB' mit dem Datenbankserver 'contoso-cosmos.documents.azure.com' zur App 'ecommerce-app' in der Ressourcengruppe 'rg-ecommerce' hinzu.
- "Füge den Datenbanktyp 'SqlServer' der Datenbank 'inventory' auf dem Datenbankserver 'adventure-works-sql.database.windows.net' zur App 'inventory-service' in der Ressourcengruppe 'rg-inventory' hinzu."
- "Konfigurieren des Datenbank-Datenbanktyps 'Analytics' 'PostgreSQL' auf dem Datenbankserver 'contoso-pg.postgres.database.azure.com' für die App 'analytics-api' in der Ressourcengruppe 'rg-analytics' mithilfe der Verbindungszeichenfolge 'Server=tcp:contoso-pg.postgres.database.azure.com; Datenbank=Analyse; Benutzer-ID=<Ihr Benutzername>; Password=<your-password>'."
- "Füge den Datenbanktyp 'MySQL' der Datenbank 'customers' mit dem Datenbankserver 'adventure-works-mysql.mysql.database.azure.com' zur App 'crm-web' in der Ressourcengruppe 'rg-crm' mithilfe der Verbindungszeichenfolge 'Server=adventure-works-mysql.mysql.database.azure.com; Datenbank=customers; Uid=<your-username>; Pwd=<your-password>' hinzu."
- "Datenbank 'sessiondb' vom Typ 'CosmosDB' auf dem Datenbankserver 'fabrikam-cosmos.documents.azure.com' mit der App 'session-service' in der Ressourcengruppe 'rg-session' verbinden."
- "Richte den Datenbanktyp 'SqlServer' der Datenbank 'orders' auf dem Datenbankserver 'fabrikam-sql.database.windows.net' für die App 'order-processor' in der Ressourcengruppe 'rg-orders' ein."
- Konfigurieren Sie die Datenbank 'logs' des Typs 'PostgreSQL' auf dem Datenbankserver 'fabrikam-pg.postgres.database.azure.com' für die App 'logger-app' in der Ressourcengruppe 'rg-logging' mit der Verbindungszeichenfolge 'Host=fabrikam-pg.postgres.database.azure.com;Database=logs;Username=<your-username>;Password=<your-password>'.
| Parameter | Erforderlich oder optional | Description |
|---|---|---|
| App-Name | Erforderlich | Der Name des Azure App Service (z. B my-webapp. ). |
| Datenbank | Erforderlich | Der Name der Datenbank, mit der eine Verbindung hergestellt werden soll (z. B. mydb). |
| Datenbankserver | Erforderlich | Der Servername oder der Endpunkt für die Datenbank (z. B. contoso-server.database.windows.net). |
| Datenbanktyp | Erforderlich | Der Typ der Datenbank:SqlServer, MySQL, , PostgreSQLund Cosmos DB. |
| Ressourcengruppe | Erforderlich | Der Name der Azure-Ressourcengruppe. Diese Ressourcengruppe ist ein logischer Container für Azure-Ressourcen. |
| Verbindungszeichenfolge | Wahlfrei | Die Verbindungszeichenfolge für die Datenbank. Wenn nicht angegeben, wird ein Standardwert generiert. |
Hinweise zur Werkzeugkommentierung:
| Zerstörend | Idempotent | Offene Welt | Nur Leseberechtigung | Secret | Lokal erforderlich |
|---|---|---|---|---|---|
| ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
Ändern des Web-App-Zustands
Dieses Tool aktualisiert den Ausführungsstatus einer Azure App Service Web-App mithilfe eines der folgenden Zustände:
-
start: Startet eine angehaltene Web-App. -
stop: Stoppt eine ausgeführte Web-App. -
restart: Startet eine ausgeführte Web-App neu.
Wenn Sie restart verwenden, kann dieses Tool einen Warmstart ausführen und synchron mit der Rückgabe warten, bis der Vorgang abgeschlossen ist.
Dieses Tool gibt eine Meldung zurück, die das Vorgangsergebnis angibt.
Beispiele für Prompts:
- Starten Sie die Web-App mit dem App-Namen „api-staging“ in der Ressourcengruppe „rg-staging“ und der Statusänderung „start“.
- "Beende den App Service-App-Namen 'webapp-prod' in der Ressourcengruppe 'rg-prod' mit der Statusänderung 'stop'."
- "Starte die App mit dem Namen 'shop-api' in der Ressourcengruppe 'rg-ecommerce' mit der Statusänderung 'restart' und Warmstart 'true' neu."
- "Starte die App 'my-webapp' in der Ressourcengruppe 'rg-dev' mit der Statusänderung 'restart', Warmstart 'false' neu und warte auf Abschluss 'true'."
| Parameter | Erforderlich oder optional | Description |
|---|---|---|
| App-Name | Erforderlich | Der Name des Azure App Service (z. B my-webapp. ). |
| Ressourcengruppe | Erforderlich | Der Name der Azure-Ressourcengruppe. Diese Ressourcengruppe ist ein logischer Container für Azure-Ressourcen. |
| Zustandsänderung | Erforderlich | Die auszuführende Zustandsänderungsaktion. Gültige Werte sind: start, stop, restart. |
| Vorläufiger Neustart | Wahlfrei | Wenn statusänderung ist restart, gibt an, ob ein softer Neustart ausgeführt werden soll. |
| Auf Abschluss warten | Wahlfrei | Wenn „Zustandsänderung“ restart ist, wird angegeben, ob synchron auf den Abschluss des Zustandsänderungsvorgangs gewartet werden soll, bevor zurückgekehrt wird. |
Hinweise zur Werkzeugkommentierung:
| Zerstörend | Idempotent | Offene Welt | Nur Leseberechtigung | Secret | Lokal erforderlich |
|---|---|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
Web-App diagnostizieren
Dieses Tool führt einen angegebenen Detektor in einer Azure App Service-Web-App aus und gibt die Diagnoseergebnisse des Detektors zurück. Die Ausgabe enthält die Detektorergebnisse und zugehörige Diagnosedaten, die Sie bei der Untersuchung des Zustands und Verhaltens der App unterstützen.
Beispiele für Prompts:
- Diagnostizieren Sie die Web-App 'webapp-prod' in der Ressourcengruppe 'rg-prod' unter Verwendung des Analysewerkzeugs 'Verfügbarkeit'.
- "Diagnostiziere die Web-App 'my-webapp' in der Ressourcengruppe 'webapp-dev' mit dem Detektor 'CpuAnalysis' zwischen '2025-03-01T00:00:00Z' und '2025-03-01T01:00:00Z' mit dem Intervall 'PT5M'."
| Parameter | Erforderlich oder optional | Description |
|---|---|---|
| App-Name | Erforderlich | Der Name des Azure App Service (z. B my-webapp. ). |
| Detektor-ID | Erforderlich | Die ID des zu ausführenden Diagnosedetektors. Verwenden Sie das id Feld aus dem appservice webapp diagnostic list Tool. |
| Ressourcengruppe | Erforderlich | Der Name der Azure-Ressourcengruppe. Diese Ressourcengruppe ist ein logischer Container für Azure-Ressourcen. |
| Endzeit | Wahlfrei | Die Endzeit im ISO-Format (z. B 2023-01-01T00:00:00Z. ). |
| Intervall | Wahlfrei | Das Zeitintervall (zum Beispiel 1 Stunde PT1H , 5 Minuten PT5M). |
| Startzeit | Wahlfrei | Die Startzeit im ISO-Format (z. B 2023-01-01T00:00:00Z. ). |
Hinweise zur Werkzeugkommentierung:
| Zerstörend | Idempotent | Offene Welt | Nur Leseberechtigung | Secret | Lokal erforderlich |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Bereitstellungsdetails abrufen
Dieses Tool ruft detaillierte Informationen zu Bereitstellungen in einer Azure App Service-Web-App ab. Er gibt Metadaten wie den Bereitstellungsnamen zurück, ob die Bereitstellung aktiv ist, Start- und Endzeiten, wer die Bereitstellung erstellt und ausgeführt hat, und den Bereitstellungstyp.
Beispiele für Prompts:
- "Liste die Bereitstellungen für die Web-App 'webapp-prod' in der Ressourcengruppe 'rg-prod' auf."
- "Rufe die Bereitstellung 'd4f8c9a2-1b3e-4c5d-9f7a-123456abcdef' für die Webanwendung 'webapp-prod' in der Ressourcengruppe 'rg-prod' ab."
| Parameter | Erforderlich oder optional | Description |
|---|---|---|
| App-Name | Erforderlich | Der Name des Azure App Service (z. B my-webapp. ). |
| Ressourcengruppe | Erforderlich | Der Name der Azure-Ressourcengruppe. Diese Ressourcengruppe ist ein logischer Container für Azure-Ressourcen. |
| Bereitstellungs-ID | Wahlfrei | Die ID der Bereitstellung. |
Hinweise zur Werkzeugkommentierung:
| Zerstörend | Idempotent | Offene Welt | Nur Leseberechtigung | Secret | Lokale Anforderung |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Web-App-Details abrufen
Ruft detaillierte Informationen zu Azure App Service-Web-Apps ab, einschließlich App-Name, Ressourcengruppe, Standort, Laufzeitstapel, Status und Hostnamen.
Beispiele für Prompts:
- "Listen Sie die Web-Apps in meinem Abonnement auf."
- Zeige mir die Webanwendungen in der Ressourcengruppe 'rg-prod'.
- "Rufe die Informationen zur Web-App 'api-staging' in der Ressourcengruppe 'rg-staging' ab."
| Parameter | Erforderlich oder optional | Description |
|---|---|---|
| App-Name | Wahlfrei | Der Name der Azure App Service-Web-App (z. B contoso-webapp. ). Dieses Tool gibt Details zu einer bestimmten Web-App zurück, wenn Sie App name angeben; wenn Sie kein App name angeben, werden Informationen für alle Web-Apps im Abonnement oder für die angegebene resource group und subscription zurückgegeben. |
| Ressourcengruppe | Wahlfrei | Der Name der Azure-Ressourcengruppe. Diese Ressourcengruppe ist ein logischer Container für Azure-Ressourcen. |
Hinweise zur Werkzeugkommentierung:
| Zerstörend | Idempotent | Offene Welt | Nur Leseberechtigung | Secret | Lokal erforderlich |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Abrufen von App-Einstellungen
Dieses Tool ruft die Anwendungseinstellungen für eine Azure App Service-Web-App ab und gibt Schlüsselwertpaare für jede Einstellung zurück. App-Einstellungen können Verbindungszeichenfolgen und andere vertrauliche Werte enthalten. Behandeln Sie daher zurückgegebene Werte als Geheimnisse und begrenzen Sie ihre Offenlegung.
Beispiele für Prompts:
- Liste die Anwendungseinstellungen der Web-App 'my-webapp' in der Ressourcengruppe 'rg-prod' auf.
- Die Einstellungen der Webanwendung 'orders-api' in der Ressourcengruppe 'rg-staging' abrufen.
| Parameter | Erforderlich oder optional | Description |
|---|---|---|
| App-Name | Erforderlich | Der Name der Azure App Service-Web-App (z. B my-webapp. ). |
| Ressourcengruppe | Erforderlich | Der Name der Azure-Ressourcengruppe, die die Web-App enthält (z. B. prod-rg). |
Hinweise zur Werkzeugkommentierung:
| Zerstörend | Idempotent | Offene Welt | Nur Leseberechtigung | Secret | Lokal erforderlich |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ✅ | ❌ |
Diagnosedetektoren auflisten
Dieses Tool ruft detaillierte Informationen zu Detektoren für eine angegebene Azure App Service-Web-App ab. Für jeden Detektor gibt er den Detektornamen, den Detektortyp, die Beschreibung, die Kategorie und die Analysetypen zurück. Die Ergebnisse helfen Ihnen, Probleme zu untersuchen und die Diagnose zu verstehen, die für die Web-App verfügbar ist.
Beispiele für Prompts:
- "Liste die Diagnosedetektoren für die Web-App 'my-webapp' in der Ressourcengruppe 'rg-prod' auf."
| Parameter | Erforderlich oder optional | Description |
|---|---|---|
| App-Name | Erforderlich | Der Name des Azure App Service (z. B my-webapp. ). |
| Ressourcengruppe | Erforderlich | Der Name der Azure-Ressourcengruppe. Diese Ressourcengruppe ist ein logischer Container für Azure-Ressourcen. |
Hinweise zur Werkzeugkommentierung:
| Zerstörend | Idempotent | Offene Welt | Nur Leseberechtigung | Secret | Lokal erforderlich |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Aktualisieren von App-Einstellungen
Dieses Tool aktualisiert eine Anwendungseinstellung für eine App Service-Web-App. Sie können einen von drei Updatetypen auswählen: add, , set, oder delete.
-
add: Erstellt eine neue Anwendungseinstellung mit dem angegebenen Namen und Wert. Wenn die Anwendungseinstellung bereits vorhanden ist, schlägt der Vorgang fehl und gibt einen Fehler zurück. -
set: Erstellt oder aktualisiert den Wert einer Anwendungseinstellung. Wenn die Anwendungseinstellung nicht vorhanden ist, verhält sichsetwieadd. Wenn er vorhanden ist, wird der Wert überschrieben. -
delete: Entfernt die angegebene Anwendungseinstellung. Wenn die Anwendungseinstellung nicht vorhanden ist, wird keine Aktion ausgeführt.
Für die add Typen und set Aktualisierungstypen sind sowohl der Name der Anwendungseinstellung als auch der Wert erforderlich. Für den delete Updatetyp ist nur der Name der Anwendungseinstellung erforderlich.
Beispiele für Prompts:
- "Füge den Anwendungseinstellungsnamen 'feature-flag' mit dem Wert 'true' der App 'my-webapp' in der Ressourcengruppe 'rg-prod' mit dem Einstellungsupdatetyp 'add' hinzu."
- "Lege die Anwendungseinstellung 'db-connection-string' mit dem Wert 'Server=tcp:contoso-sql.database.windows.net;initial Catalog=orders' in der App 'orders-webapp' in der Ressourcengruppe 'rg-orders' mit dem Einstellungstyp 'set' fest."
- "Lösche den Anwendungseinstellungsnamen 'old-api-key' aus der App 'Legacy-Service' in der Ressourcengruppe 'rg-archive' mit Einstellung des Updatetyps 'delete'."
| Parameter | Erforderlich oder optional | Description |
|---|---|---|
| App-Name | Erforderlich | Der Name des Azure App Service (z. B my-webapp. ). |
| Ressourcengruppe | Erforderlich | Der Name der Azure-Ressourcengruppe, die die Web-App enthält. |
| Name der Einstellung | Erforderlich | Der Name der Anwendungseinstellung. |
| Einstellung des Aktualisierungstyps | Erforderlich | Der Typ der Aktualisierung, die für die Anwendungseinstellung ausgeführt werden soll. Gültige Werte: add, set, delete. |
| Einstellungswert | Wahlfrei | Der Wert der Anwendungseinstellung. Erforderlich für add und set Aktualisierungstypen. |
Hinweise zur Werkzeugkommentierung:
| Zerstörend | Idempotent | Offene Welt | Nur Leseberechtigung | Secret | Vor Ort erforderlich |
|---|---|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |