Introdução ao Servidor MCP do Azure no Cursor

O Servidor MCP do Azure usa o Protocolo de Contexto de Modelo (MCP) para padronizar integrações entre aplicativos de IA e ferramentas externas e fontes de dados, permitindo que os sistemas de IA executem operações sensíveis ao contexto de seus recursos do Azure.

Neste artigo, você aprenderá a concluir as seguintes tarefas:

• Instale e autentique-se no Servidor MCP do Azure.
• Ligue-se ao Azure MCP Server a partir do ambiente de desenvolvimento alimentado por IA da Cursor.
• Execute prompts para testar as operações do Azure MCP Server e interagir com os seus recursos Azure.

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa.
• Cursor, o editor de código alimentado por IA.
• Node.js LTS instalado.

Instalar o Servidor MCP do Azure

Para instalar e configurar o Servidor MCP do Azure no Cursor:

1. Vá a Ficheiro>Preferências>Definições do cursor.

2. Selecione Ferramentas & Integrações na navegação à esquerda.

3. Na seção Ferramentas MCP da página, selecione Novo Servidor MCP para abrir o mcp.json arquivo para edição.

   

4. Adicione a seguinte configuração ao mcpServers objeto JSON:

   "Azure MCP Server": {
     "command": "npx",
     "args": [
       "-y",
       "@azure/mcp@latest",
       "server",
       "start"
     ]
   }
   

Autenticar no Azure

O Servidor MCP do Azure fornece uma experiência de autenticação perfeita usando contas do Azure e ID do Microsoft Entra. Para usar o Azure MCP Server, autentique primeiro no Azure utilizando ferramentas de desenvolvimento local como o CLI do Azure, Azure Developer CLI, Visual Studio ou Visual Studio Code. O Servidor MCP do Azure descobre automaticamente suas credenciais dessas ferramentas e as usa para autenticar nos serviços do Azure.

1. Por exemplo, para entrar usando a CLI do Azure:

   az login
   

2. Verifique o status da autenticação executando o seguinte comando para ver com qual conta e assinatura você está conectado no momento:

   az account show
   

3. Verifique se sua conta de usuário tem as atribuições de função apropriadas para os serviços do Azure com os quais você deseja interagir. Os recursos do Azure que pretende aceder usando o Azure MCP Server já devem existir dentro da sua subscrição do Azure. Por exemplo, as atribuições de função comuns incluem:

   • Armazenamento de Blobs Data Contributor - Leia e escreva dados de blob em contas de armazenamento.
   • Colaborador da conta de armazenamento - Gerencie as configurações da conta de armazenamento.
   • Colaborador - Gestão geral de recursos em toda a sua subscrição.
   • Reader - Acesso somente leitura aos recursos do Azure.

   Para obter mais informações sobre atribuições de função e autenticação de desenvolvimento local, consulte Autenticar aplicativos .NET para serviços do Azure durante o desenvolvimento local.

Usar prompts para testar o Servidor MCP do Azure

1. Abra a interface de chat de IA do Cursor pressionando Ctrl+L ou selecionando o ícone de chat na barra lateral.

2. Introduza um prompt que utilize as capacidades do Azure MCP Server, tais como:

   List my Azure storage accounts
   

3. Se for solicitado autenticar-se no Azure, execute a ferramenta de autenticação sugerida para iniciar sessão através do navegador.

   Observação

   O cursor não te pede para iniciar sessão no Azure se já estiveres autenticado através de outras ferramentas locais, como a CLI do Azure.

4. O cursor solicita que você execute uma ferramenta para recuperar as contas de armazenamento, como storage account list. Selecione Executar ferramenta para continuar.

   A saída deve ser semelhante ao seguinte texto:

   The following resource groups are available for your subscription:
   
   1. **DefaultResourceGroup-EUS** (Location: `eastus`)
   2. **rg-testing** (Location: `centralus`)
   3. **rg-azd** (Location: `eastus2`)
   4. **msdocs-sample** (Location: `southcentralus`)
   5. **ai-testing** (Location: `eastus2`)
   
   Let me know if you need further details or actions related to any of these resource groups!
   

5. Explore mais operações do Azure MCP Server utilizando outros prompts relevantes, tais como:

   List all of the storage accounts in my subscription
   Get the available tables in my storage accounts
   Show me the configuration of my App Service instances
   

Próximos passos