Microsoft Learn MCP — Instalar & Demo ao vivo

Por que usar

Principais recursos

MCP remoto — sem instalação, apenas aponte o mcp-remote para a URL
Cobre Azure, .NET, M365, Power Platform, Windows, Visual Studio
Exemplos de código incluídos nos resultados quando disponíveis
URLs de citação de volta para learn.microsoft.com
Sempre atualizado — sem drift de snapshot embutido
Gratuito, sem API key

Demo ao vivo

Como fica na prática

microsoft-learn-mcp.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "microsoft-learn-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://learn.microsoft.com/api/mcp"
      ]
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "microsoft-learn-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://learn.microsoft.com/api/mcp"
      ]
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "microsoft-learn-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://learn.microsoft.com/api/mcp"
      ]
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "microsoft-learn-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://learn.microsoft.com/api/mcp"
      ]
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "microsoft-learn-mcp",
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://learn.microsoft.com/api/mcp"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "microsoft-learn-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "https://learn.microsoft.com/api/mcp"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add microsoft-learn-mcp -- npx -y mcp-remote https://learn.microsoft.com/api/mcp

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: Microsoft Learn MCP

Implemente um padrão de recurso Azure a partir da documentação atual

👤 Engenheiros de cloud no Azure ⏱ ~20 min intermediate

Quando usar: O Claude continua escrevendo Bicep/Terraform com nomes de propriedades obsoletos; você quer que use a API atual.

Fluxo

Busque a documentação

Microsoft Learn MCP: busque 'Azure Container Apps managed identity'. Acesse a documentação atual.✓ Copiado

→ Busca retorna páginas do Learn com URLs
Acesse e cite

Obtenha a seção sobre atribuição de uma user-assigned identity. Cite o schema Bicep atual, sem parafrasear.✓ Copiado

→ Trecho Bicep exato com nomes de propriedades
Aplique

Agora escreva o Bicep para o meu container app usar uma identity existente id-prod-app. Corresponda ao schema que você citou.✓ Copiado

→ Bicep compila contra a API atual do Microsoft.App

Resultado: Bicep que implanta corretamente na primeira tentativa porque o schema corresponde à API Azure atual.

Armadilhas

Doc retornada via busca é de uma versão mais antiga da API — Sempre verifique se a URL contém 'latest' ou a api-version correta

Combine com: filesystem · github

Consulte uma API .NET sem sair do Claude

👤 Desenvolvedores C# / .NET ⏱ ~10 min beginner

Quando usar: Você precisa da assinatura exata de System.Threading.Channels.Channel.CreateBounded.

Fluxo

Busque

Microsoft Learn: assinatura de Channel.CreateBounded no .NET 9.✓ Copiado

→ Página de referência de API com sobrecargas
Use

Escreva um producer/consumer usando BoundedChannelOptions com capacity 100, FullMode=Wait. Corresponda exatamente à documentação.✓ Copiado

→ Código corresponde à superfície da API atual

Resultado: C# correto sem precisar trocar para a documentação.

Armadilhas

Misturando documentação do .NET Framework e do .NET (Core) — Sempre especifique a versão; o Learn retorna ambos

Escreva um script PowerShell Microsoft Graph com citações

👤 Administradores M365 ⏱ ~25 min intermediate

Quando usar: Você quer atualizar atribuições de licença em massa e precisa da sintaxe atual dos cmdlets Graph.

Fluxo

Encontre o cmdlet

Learn: sintaxe atual para Set-MgUserLicense no Microsoft.Graph PowerShell SDK.✓ Copiado

→ Documentação do cmdlet com conjunto de parâmetros
Monte o script

Escreva um script que leia users.csv (UPN, SkuPartNumber) e atribua a licença. Cite as URLs do Learn que você usou.✓ Copiado

→ PowerShell funcional com citações no bloco de comentários

Resultado: Script auditável com citações para revisão.

Armadilhas

Sintaxe do módulo AzureAD antigo — AzureAD está deprecado; insista em Microsoft.Graph no prompt

Combine com: filesystem

Combinações

Combine com outros MCPs para 10× de alavancagem

microsoft-learn-mcp + github

Encontre um padrão Azure atual no Learn, depois abra PR com a mudança IaC

Learn: acesse Container Apps + identity. GitHub: abra um PR atualizando meu Bicep.✓ Copiado

microsoft-learn-mcp + filesystem

Salve trechos citados como um runbook

Acesse a documentação do cmdlet de licença M365 e salve um runbook em /runbooks/m365-license.md com citações.✓ Copiado

microsoft-learn-mcp + context7

Faça referência cruzada entre a documentação Microsoft e a documentação mais ampla da biblioteca

Compare o padrão recomendado do Microsoft Learn com o que o context7 diz para o mesmo SDK.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
microsoft_docs_search	query: str	Primeiro passo	free
microsoft_docs_fetch	url: str	Acessar uma página específica	free

Custo e limites

O que custa rodar

Cota de API: Hospedado pela Microsoft; uso razoável por fair use por IP
Tokens por chamada: 300–5000
Monetário: Gratuito
Dica: Busque primeiro, acesse apenas as 1–2 URLs mais relevantes

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: Nenhum — documentação pública

Saída de dados: learn.microsoft.com

Sua query de busca é enviada para a Microsoft — não inclua detalhes sensíveis se a política da sua empresa restringir isso

Solução de problemas

Erros comuns e correções

Result page is for old API version

Adicione 'api-version=YYYY-MM' ou a versão .NET à query

Search returns marketing pages

Adicione 'docs' ou 'reference' à query; filtre por URL contendo '/dotnet/api/' ou '/azure/'

mcp-remote connection refused

Verifique a rede; o endpoint é https://learn.microsoft.com/api/mcp

Verificar: curl -I https://learn.microsoft.com/api/mcp

Alternativas

Microsoft Learn MCP vs. outros

Alternativa	Quando usar	Troca
Context7	Você quer cobertura mais ampla de bibliotecas, não apenas Microsoft	Menos autoritativo para documentação específica da Microsoft
GitMCP	Você quer código-fonte bruto do repositório em vez de documentação curada	Sem curação; você obtém o que está no repositório

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills