Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
O Azure Model Context Protocol (MCP) Server permite-lhe gerir recursos do Serviço de Aplicações do Azure com prompts em linguagem natural. Pode implementar e atualizar aplicações web e APIs, configurar definições de aplicações, diagnosticar problemas em tempo de execução e listar ou recuperar detalhes da aplicação.
O Serviço de Aplicações do Azure é uma plataforma totalmente gerida para construir, implementar e escalar aplicações web e APIs; para mais informações, consulte a documentação do Serviço de Aplicações do Azure.
Observação
Parâmetros da ferramenta: as ferramentas do Servidor MCP do Azure definem parâmetros para os dados de que precisam para concluir tarefas. Alguns destes parâmetros são específicos para cada ferramenta e estão documentados aqui. Outros parâmetros são globais e compartilhados por todas as ferramentas. Para obter mais informações, consulte Parâmetros da ferramenta.
Adicionar ligação à base de dados
Esta ferramenta adiciona uma ligação de base de dados a um serviço de aplicações Azure usando a string de conexão de uma base de dados existente. Configura as definições de ligação do App Service para que a aplicação possa aceder à base de dados e ao servidor de base de dados especificados. Se não fornecer uma string de conexão, a ferramenta gera uma string de conexão padrão.
Exemplos de prompts incluem:
- Adicionar a base de dados 'ordersdb' do tipo 'SqlServer' com o servidor de base de dados 'contoso-sql.database.windows.net' à aplicação 'webapp-prod' no grupo de recursos 'rg-prod'.
- Configurar a base de dados 'userdb' do tipo 'MySQL' no servidor de base de dados 'contoso-mysql.mysql.database.azure.com' para a aplicação 'api-staging' no grupo de recursos 'rg-staging'.
- Conecte a base de dados 'appdata', do tipo de base de dados 'PostgreSQL', ao servidor de base de dados 'pgserver.postgres.database.azure.com' à aplicação 'backend-app' no grupo de recursos 'rg-backend'.
- "Adicionar a base de dados CosmosDB 'catalogdb' do tipo 'CosmosDB' com o servidor de base de dados 'contoso-cosmos.documents.azure.com' à aplicação 'ecommerce-app' no grupo de recursos 'rg-ecommerce'."
- Adicionar a base de dados ‘inventory’ do tipo de base de dados ‘SqlServer’ no servidor de base de dados ‘adventure-works-sql.database.windows.net’ à aplicação ‘inventory-service’ no grupo de recursos ‘rg-inventory’.
- "Configurar o tipo de base de dados 'analytics' 'PostgreSQL' no servidor de base de dados 'contoso-pg.postgres.database.azure.com' para a aplicação 'analytics-api' no grupo de recursos 'rg-analytics' usando a cadeia de ligação 'Server=tcp:contoso-pg.postgres.database.azure.com; Base de dados=análises; ID de utilizador=<o seu-nome> de utilizador; Palavra-passe=<a sua-palavra-passe>'."
- Adicionar a base de dados 'clientes' do tipo 'MySQL' com o servidor de base de dados 'adventure-works-mysql.mysql.database.azure.com' à aplicação 'crm-web' no grupo de recursos 'rg-crm', utilizando a string de ligação 'Server=adventure-works-mysql.mysql.database.azure.com;Database=clientes;Uid=<o seu-nome-de-utilizador>;Pwd=<a sua-palavra-passe>'.
- "Ligue a base de dados 'sessiondb' tipo de base de dados 'CosmosDB' no servidor de base de dados 'fabrikam-cosmos.documents.azure.com' à aplicação 'session-service' no grupo de recursos 'rg-session'."
- Configurar a base de dados 'orders' do tipo 'SqlServer' no servidor de bases de dados 'fabrikam-sql.database.windows.net' para a aplicação 'order-processor' no grupo de recursos 'rg-orders'.
- "Configurar 'logs' da base de dados, tipo de base de dados 'PostgreSQL' no servidor de base de dados 'fabrikam-pg.postgres.database.azure.com' para a aplicação 'logger-app' no grupo de recursos 'rg-logging' com a cadeia de ligação 'Host=fabrikam-pg.postgres.database.azure.com; Database=logs; Nome de utilizador=<seu-nome>; Palavra-passe=<a sua-palavra-passe>'."
| Parâmetro | Obrigatório ou opcional | Description |
|---|---|---|
| Nome da aplicação | Obrigatório | O nome do Serviço de Aplicações do Azure (por exemplo, my-webapp). |
| Base de dados | Obrigatório | O nome do banco de dados ao qual se conectar (por exemplo, mydb). |
| Servidor de banco de dados | Obrigatório | O nome do servidor ou endpoint para a base de dados (por exemplo, contoso-server.database.windows.net). |
| Tipo de banco de dados | Obrigatório | O tipo de base de dados:SqlServer, MySQL, PostgreSQL, e Cosmos DB. |
| Grupo de recursos | Obrigatório | O nome do grupo de recursos do Azure. Este grupo de recursos é um contentor lógico para recursos Azure. |
| Cadeia de conexão | Opcional | A string de conexão para o banco de dados. Se não for fornecido, um valor padrão será gerado. |
Dicas de anotação da ferramenta:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Local obrigatório |
|---|---|---|---|---|---|
| ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
Alterar o estado da aplicação web
Esta ferramenta atualiza o estado de execução de uma aplicação web do Serviço de Aplicações do Azure utilizando um dos seguintes estados:
-
start: Inicia uma aplicação web parada. -
stop: Impede uma aplicação web a correr. -
restart: Reinicia uma aplicação Web em execução.
Quando usa restart, esta ferramenta pode realizar um reinício suave e esperar sincronizadamente que a operação seja concluída antes de regressar.
Esta ferramenta devolve uma mensagem que indica o resultado da operação.
Exemplos de prompts incluem:
- "Inicia a aplicação web com o nome da app 'api-staging' no grupo de recursos 'rg-staging' e altera o estado 'start'."
- Pare a aplicação App Service com o nome 'webapp-prod' no grupo de recursos 'rg-prod' com a alteração de estado para 'stop'.
- Reiniciar a aplicação com o nome 'shop-api' no grupo de recursos 'rg-ecommerce' com mudança de estado 'reiniciar' e reinício suave 'true'.
- "Reiniciar o nome da aplicação 'my-webapp' no grupo de recursos 'rg-dev' com alteração de estado 'reiniciar', reiniciar suavemente 'false' e aguardar pela conclusão 'true'."
| Parâmetro | Obrigatório ou opcional | Description |
|---|---|---|
| Nome da aplicação | Obrigatório | O nome do Serviço de Aplicações do Azure (por exemplo, my-webapp). |
| Grupo de recursos | Obrigatório | O nome do grupo de recursos do Azure. Este grupo de recursos é um contentor lógico para recursos Azure. |
| Mudança de Estado | Obrigatório | A ação de alteração de estado a executar. Os valores válidos são: start, stop, restart. |
| Reinício suave | Opcional | Quando a alteração de estado é restart, indica se deve realizar um reinício suave. |
| Aguardar pela conclusão | Opcional | Quando a alteração de estado é restart, indica se deve esperar síncronicamente que a operação de mudança de estado seja concluída antes de regressar. |
Dicas de anotação da ferramenta:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Local obrigatório |
|---|---|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
Diagnosticar aplicação web
Esta ferramenta executa um detector específico numa aplicação web do Serviço de Aplicações do Azure e devolve os resultados de diagnóstico do detector. O resultado inclui os resultados do detector e os dados diagnósticos relacionados para ajudar a investigar a saúde e o comportamento da aplicação.
Exemplos de prompts incluem:
- Diagnosticar a aplicação web 'webapp-prod' no grupo de recursos 'rg-prod' utilizando o detetor 'Disponibilidade'.
- "Diagnosticar a aplicação web 'my-webapp' no grupo de recursos 'webapp-dev' com o detector 'CpuAnalysis' entre '2025-03-01T00:00:00Z' e '2025-03-01T01:00:00Z' com intervalo 'PT5M'."
| Parâmetro | Obrigatório ou opcional | Description |
|---|---|---|
| Nome da aplicação | Obrigatório | O nome do Serviço de Aplicações do Azure (por exemplo, my-webapp). |
| Detector ID | Obrigatório | O ID do detector de diagnóstico a executar. Usa o id campo da appservice webapp diagnostic list ferramenta. |
| Grupo de recursos | Obrigatório | O nome do grupo de recursos do Azure. Este grupo de recursos é um contentor lógico para recursos Azure. |
| Hora de fim | Opcional | A hora de fim em formato ISO (por exemplo, 2023-01-01T00:00:00Z). |
| Interval | Opcional | O intervalo de tempo (por exemplo, PT1H durante 1 hora, PT5M durante 5 minutos). |
| Hora de início | Opcional | A hora de início em formato ISO (por exemplo, 2023-01-01T00:00:00Z). |
Dicas de anotação da ferramenta:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Local obrigatório |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Obtenha detalhes de implantação
Esta ferramenta recupera informações detalhadas sobre implementações numa aplicação web do Serviço de Aplicações do Azure. Devolve metadados como o nome da implementação, se a implementação está ativa, horários de início e fim, quem criou e executou a implementação, e o tipo de implementação.
Exemplos de prompts incluem:
- "Liste as implementações da aplicação web 'webapp-prod' no grupo de recursos 'rg-prod'."
- "Obtenha a implementação 'd4f8c9a2-1b3e-4c5d-9f7a-123456abccdef' para a aplicação web 'webapp-prod' no grupo de recursos 'rg-prod'."
| Parâmetro | Obrigatório ou opcional | Description |
|---|---|---|
| Nome da aplicação | Obrigatório | O nome do Serviço de Aplicações do Azure (por exemplo, my-webapp). |
| Grupo de recursos | Obrigatório | O nome do grupo de recursos do Azure. Este grupo de recursos é um contentor lógico para recursos Azure. |
| ID de Implementação | Opcional | A ID da implantação. |
Dicas de anotação da ferramenta:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Local obrigatório |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Obtenha detalhes da aplicação web
Recupera informações detalhadas sobre aplicações web do Serviço de Aplicações do Azure, incluindo nome da aplicação, grupo de recursos, localização, pilha de tempo de execução, estado e nomes de host.
Exemplos de prompts incluem:
- "Lista as aplicações web na minha subscrição."
- "Mostra-me as aplicações web no grupo de recursos 'rg-prod'."
- "Obtenha os detalhes da aplicação web 'api-staging' no grupo de recursos 'rg-staging'."
| Parâmetro | Obrigatório ou opcional | Description |
|---|---|---|
| Nome da aplicação | Opcional | O nome da aplicação web Serviço de Aplicações do Azure (por exemplo, contoso-webapp). Esta ferramenta devolve os detalhes de uma aplicação web específica quando fornece o App name; se não fornecer um App name, devolve informações sobre todas as aplicações web da subscrição ou sobre os resource group e subscription especificados. |
| Grupo de recursos | Opcional | O nome do grupo de recursos do Azure. Este grupo de recursos é um contentor lógico para recursos Azure. |
Dicas de anotação da ferramenta:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Local obrigatório |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Obter definições da app
Esta ferramenta recupera as definições da aplicação para uma aplicação web do Serviço de Aplicações do Azure e devolve pares chave-valor para cada definição. As definições da app podem incluir strings de ligação e outros valores sensíveis, por isso trate os valores devolvidos como segredos e limite a sua exposição.
Exemplos de prompts incluem:
- "Liste as definições da aplicação web 'my-webapp' no grupo de recursos 'rg-prod'."
- "Obtenha as definições da aplicação para a aplicação web 'orders-api' no grupo de recursos 'rg-staging'."
| Parâmetro | Obrigatório ou opcional | Description |
|---|---|---|
| Nome da aplicação | Obrigatório | O nome da aplicação web Serviço de Aplicações do Azure (por exemplo, my-webapp). |
| Grupo de recursos | Obrigatório | O nome do grupo de recursos Azure que contém a aplicação web (por exemplo, prod-rg). |
Dicas de anotação da ferramenta:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Local obrigatório |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ✅ | ❌ |
Lista de detetores de diagnóstico
Esta ferramenta recolhe informações detalhadas sobre detetores para uma aplicação web Serviço de Aplicações do Azure especificada. Para cada detetor, devolve o nome do detector, tipo, descrição, categoria e tipos de análise. Os resultados ajudam-no a investigar problemas e a compreender os diagnósticos disponíveis para a aplicação web.
Exemplos de prompts incluem:
- "Liste os detectores de diagnóstico da aplicação web 'my-webapp' no grupo de recursos 'rg-prod'."
| Parâmetro | Obrigatório ou opcional | Description |
|---|---|---|
| Nome da aplicação | Obrigatório | O nome do Serviço de Aplicações do Azure (por exemplo, my-webapp). |
| Grupo de recursos | Obrigatório | O nome do grupo de recursos do Azure. Este grupo de recursos é um contentor lógico para recursos Azure. |
Dicas de anotação da ferramenta:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Local obrigatório |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Atualizar definições da aplicação
Esta ferramenta atualiza uma configuração de aplicação para uma aplicação web de Serviços de Aplicação. Pode escolher um de três tipos de atualização: add, set, ou delete.
-
add: Cria uma nova configuração de aplicação com o nome e valor especificados. Se a configuração da aplicação já existir, a operação falha e devolve um erro. -
set: Cria ou atualiza o valor de uma configuração de aplicação. Se a definição da aplicação não existir,setcomporta-se comoadd. Se existir, o valor é sobrescrito. -
delete: Remove a configuração de aplicação especificada. Se a configuração da aplicação não existir, não será tomada qualquer ação.
Para os tipos de atualização add e set, são necessários tanto o nome da configuração da aplicação como o valor. Para o delete tipo de atualização, é necessário apenas o nome da configuração da aplicação.
Exemplos de prompts incluem:
- "Adicionar o nome da definição da aplicação 'feature-flag' com o valor 'true' à aplicação 'my-webapp' no grupo de recursos 'rg-prod' com o tipo de atualização 'add'."
- Definir o nome da configuração da aplicação 'db-connection-string' para o valor 'Server=tcp:contoso-sql.database.windows.net;Initial Catalog=orders' na aplicação 'orders-webapp' no grupo de recursos 'rg-orders' do tipo de atualização 'set'.
- Eliminar a configuração da aplicação chamada 'old-api-key' da aplicação 'legacy-service' no grupo de recursos 'rg-archive' com o tipo de atualização 'eliminar'.
| Parâmetro | Obrigatório ou opcional | Description |
|---|---|---|
| Nome da aplicação | Obrigatório | O nome do Serviço de Aplicações do Azure (por exemplo, my-webapp). |
| Grupo de recursos | Obrigatório | O nome do grupo de recursos Azure que contém a aplicação web. |
| Nome da configuração | Obrigatório | O nome da configuração da aplicação. |
| Tipo de atualização de configuração | Obrigatório | O tipo de atualização a realizar na configuração da aplicação. Valores válidos: add, set, delete. |
| Definir valor | Opcional | O valor da definição da aplicação. Obrigatório para add e set tipos de atualização. |
Dicas de anotação da ferramenta:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Local obrigatório |
|---|---|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |