Introdução ao Servidor MCP do Azure no Cursor

O Servidor MCP do Azure usa o PROTOCOLO MCP (Model Context Protocol) para padronizar as integrações entre aplicativos de IA e ferramentas externas e fontes de dados, permitindo que os sistemas de IA executem operações com reconhecimento de contexto dos recursos do Azure.

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

• Instalar e autenticar no Servidor MCP do Azure
• Conectar-se ao Servidor MCP do Azure usando o ambiente de desenvolvimento alimentado por IA do Cursor
• Executar prompts para testar as operações do Servidor MCP do Azure e interagir com os recursos do 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. Navegar até as configurações do cursor de preferências > de arquivo >

2. Selecione Ferramentas &integrações da 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 a ID do Microsoft Entra. Para usar o Servidor MCP do Azure, primeiro você deve se autenticar no Azure usando ferramentas de desenvolvimento locais, como a CLI do Azure, a CLI do Desenvolvedor do Azure, o Visual Studio ou o Visual Studio Code. O Servidor MCP do Azure descobre automaticamente suas credenciais dessas ferramentas e as usa para se autenticar nos serviços do Azure.

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

   az login
   

2. Verifique seu status de 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 você pretende acessar com o Servidor MCP do Azure já devem existir em sua assinatura do Azure. Por exemplo, as atribuições de função comuns incluem:

   • Colaborador de Dados do Blob Storage – Ler e gravar dados de blob em contas de armazenamento.
   • Colaborador da Conta de Armazenamento – Gerenciar configurações de conta de armazenamento.
   • Colaborador – Gerenciamento geral de recursos em sua assinatura.
   • Leitor – 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 nos 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 clicando no ícone de chat na barra lateral.

2. Insira um prompt que utilize os recursos do Servidor MCP do Azure, como:

   List my Azure storage accounts
   

3. Se for solicitado que você se autentique no Azure, execute a ferramenta de autenticação sugerida para entrar por meio do navegador.

   Observação

   O cursor não solicitará que você entre no Azure se você já estiver autenticado por meio 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 MCP do Azure usando outros prompts relevantes, 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óximas etapas