Microsoft Learn

Servidor MCP oficial do Microsoft Learn e ferramenta CLI – capacitando LLMs e agentes de IA com documentação e exemplos de código confiáveis e em tempo real da Microsoft.

GitHub

1.9k

Experimente este MCPPatrocinado

Servidor MCP hospedado

npx add-mcp 'https://learn.microsoft.com/api/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

🌟 Servidor MCP Microsoft Learn

Pare as Alucinações de IA. Dê ao seu assistente de IA (Claude, Cursor, Copilot, Codex, ...) acesso direto à documentação oficial mais recente da Microsoft.

✨ Gratuito. Instalação com um clique. Sem necessidade de chave.

🎯 Por que instalar isso?

Pare de depender de dados de treinamento desatualizados ou de pesquisas arriscadas na web. O servidor MCP Learn fornece acesso seguro e direto aos documentos oficiais da Microsoft.

🧠 Elimine Alucinações. Impedir que sua IA invente métodos inexistentes do SDK do Azure ou alucine pacotes de bibliotecas. Obtenha código que realmente compila.
🔌 Plug & Play (Sem Autenticação). Sem chaves de API, sem logins, sem cadastros necessários. Basta instalar com um clique e começar a codificar imediatamente.
🛡️ 100% Confiável e Seguro. Proteja sua cadeia de suprimentos. Ao contrário de pesquisas genéricas na web que podem acessar blogs inseguros ou sites maliciosos, esta ferramenta somente acessa documentação oficial de primeira parte da Microsoft.
💸 Completamente Gratuito. Alta capacidade de pesquisa adaptada para sessões de codificação intensas e contínuas.

✨ Exemplos de Prompts

"Dê-me os comandos da CLI do Azure para criar um Azure Container App com identidade gerenciada."

"O gpt-5.4 está disponível nas regiões do Azure na UE?"

"Você tem certeza de que esta é a maneira correta de implementar IHttpClientFactory em uma API mínima .NET 8?"

"Mostre-me código Python executável para fazer avaliação de danos usando o SDK de avaliação do Azure AI Foundry."

🌐 O Endpoint do Servidor MCP Microsoft Learn

O Servidor MCP Microsoft Learn é acessível a qualquer IDE, agente ou ferramenta que suporte o Model Context Protocol (MCP). Qualquer cliente compatível pode se conectar ao seguinte endpoint MCP remoto:

https://learn.microsoft.com/api/mcp

Observação: Este URL é destinado ao uso dentro de um cliente MCP compatível via Streamable HTTP, como os clientes recomendados listados na seção Introdução. Ele não suporta acesso direto de um navegador da web e pode retornar um erro 405 Method Not Allowed se acessado manualmente. Para desenvolvedores que precisam criar sua própria solução, siga as diretrizes obrigatórias na seção Criando um Cliente Personalizado para garantir que sua implementação seja resiliente e suportada.

Configuração padrão funciona na maioria dos clientes:

{
  "servers": {
    "microsoft-learn": {
      "type": "http",
      "url": "https://learn.microsoft.com/api/mcp"
    }
  }
}

Para recursos experimentais, consulte a seção Recursos Experimentais abaixo.

🧪 Recursos Experimentais

O Servidor MCP Microsoft Learn oferece recursos experimentais que estão em desenvolvimento ativo. Esses recursos podem mudar ou ser refinados com base no feedback dos usuários e nos padrões de uso.

Endpoint Compatível com OpenAI

Para aplicações que exigem compatibilidade com modelos OpenAI Deep Research, você pode usar o endpoint compatível com OpenAI:

https://learn.microsoft.com/api/mcp/openai-compatible

Este endpoint suporta modelos OpenAI Deep Research e segue a especificação MCP da OpenAI.

Controle de Orçamento de Tokens

Para gerenciar o uso de tokens e controlar custos, você pode anexar o parâmetro de consulta maxTokenBudget ao URL do endpoint MCP. Este parâmetro limita a contagem de tokens nas respostas da ferramenta de pesquisa, truncando o conteúdo para atender ao seu orçamento especificado.

https://learn.microsoft.com/api/mcp?maxTokenBudget=2000

Observação: Esses recursos experimentais estão sujeitos a alterações. Agradecemos feedback por meio de nossas Discussões no GitHub.

🛠️ Ferramentas Atualmente Suportadas

Nome da Ferramenta	Descrição	Parâmetros de Entrada
`microsoft_docs_search`	Executa pesquisa semântica na documentação técnica oficial da Microsoft	`query` (string): A consulta de pesquisa para recuperação
`microsoft_docs_fetch`	Busca e converte uma página de documentação da Microsoft em formato markdown	`url` (string): URL da página de documentação a ser lida
`microsoft_code_sample_search`	Pesquisa trechos de código e exemplos oficiais da Microsoft/Azure	`query` (string): Consulta de pesquisa para trechos de código da Microsoft/Azure `language` (string, opcional): Filtro de linguagem de programação.

💻 CLI Microsoft Learn

O pacote @microsoft/learn-cli dá a você acesso no terminal às mesmas ferramentas — pesquisar documentos, buscar páginas e encontrar exemplos de código — sem um cliente MCP.

# Run instantly (no install)
npx @microsoft/learn-cli search "azure functions timeout"

# Or install globally
npm install -g @microsoft/learn-cli
# then use `mslearn`
mslearn search "azure functions timeout"

Instalar o pacote npm sozinho não instala a descoberta de agentes. A CLI pode instalar uma habilidade CLI-first para os mesmos ecossistemas suportados pelos plugins deste repositório: GitHub Copilot, Claude Code, e Codex.

# User profile (default)
mslearn setup --cli

# Current repository
mslearn setup --cli --project

# Override auto-detection with explicit targets
mslearn setup --cli --copilot
mslearn setup --cli --claude
mslearn setup --cli --codex
mslearn setup --cli --copilot --project
mslearn setup --cli --claude --project
mslearn setup --cli --codex --project

# Multiple agents
mslearn setup --cli --copilot --claude --codex

Remova apenas o conteúdo de descoberta gerenciado com:

mslearn remove --cli
mslearn remove --cli --copilot
mslearn remove --cli --claude --codex --project

Agente	Escopo do usuário	Escopo do projeto
GitHub Copilot	`~/.copilot/skills/`	`.github/skills/`
Claude Code	`~/.claude/skills/`	`.claude/skills/`
Codex	`~/.agents/skills/`	`.agents/skills/`

Quando nenhum alvo é especificado, a configuração detecta agentes instalados a partir de seus diretórios de usuário ou projeto bem conhecidos. A remoção detecta apenas agentes com artefatos de descoberta gerenciados pela CLI Microsoft Learn. Alvos explícitos (--copilot, --claude ou --codex) substituem a detecção e podem ser combinados. Este fluxo de trabalho não configura MCP nem instala agentes fora dos ecossistemas de plugins, como o Cursor. Quando ambas as integrações estão instaladas, os agentes devem preferir as ferramentas MCP do Microsoft Learn e usar a habilidade CLI independente apenas como fallback.

Passe --json para obter saída JSON estruturada, útil para processamento programático:

mslearn search "azure openai" --json | jq '.results[].title'

Consulte cli/README.md para a referência completa de comandos.

🤖 Habilidades de Agente

Habilidades de Agente são pacotes de instruções portáteis que ajudam agentes de IA a usar ferramentas de forma mais eficaz. Fornecemos três habilidades que orientam os agentes sobre quando e como usar as ferramentas MCP do Microsoft Learn:

Habilidade	Propósito	Melhor Para
`microsoft-docs`	Compreender conceitos, tutoriais, arquitetura, limites	"Como funciona X?", aprendizado, guias de configuração
`microsoft-code-reference`	Consultas de API, exemplos de código, verificação, correção de erros	Implementar código, encontrar métodos corretos, solucionar problemas
`microsoft-skill-creator`	Meta-habilidade que gera habilidades de agente personalizadas para qualquer tecnologia da Microsoft	Criar uma habilidade para ensinar agentes sobre uma nova biblioteca do Azure, recurso .NET ou outra tecnologia da Microsoft

Configuração Rápida

Escolha a integração que corresponde à forma como você deseja que o agente recupere o conteúdo do Microsoft Learn:

Modo	Instalação	Comportamento do agente
CLI-first independente	Instalar/executar `@microsoft/learn-cli`, depois executar `mslearn setup --cli [agent-target]`	Agentes detectados ou selecionados invocam `npx @microsoft/learn-cli@latest`; MCP não é configurado
Plugin de repositório, MCP-first	Instalar o plugin do repositório para GitHub Copilot, Claude Code ou Codex	O plugin fornece o endpoint MCP Learn e habilidades orientadas a MCP

O plugin do repositório também suporta Claude Code. Execute o seguinte comando e reinicie o Claude Code:

/plugin install microsoft-docs@claude-plugins-official

Para o plugin CLI do GitHub Copilot MCP-first, execute:

/plugin install microsoftdocs/mcp

Caso contrário:

Instale o Servidor MCP primeiro — Consulte Instalação abaixo
Copie as pastas de habilidades para o diretório .github/skills/ ou .claude/skills/ do seu projeto:
- microsoft-docs — para conceitos, tutoriais e consultas factuais
- microsoft-code-reference — para consultas de API, exemplos de código e solução de problemas
- microsoft-skill-creator — meta-habilidade para gerar habilidades personalizadas sobre tecnologias da Microsoft

Agentes Suportados

As Habilidades de Agente funcionam em vários agentes de IA:

VS Code (Insiders) — habilite a configuração chat.useAgentSkills
CLI do GitHub Copilot & agente de codificação Copilot
Claude Code, Cursor, OpenAI Codex e mais

Qual Habilidade Eu Preciso?

Se você quiser...	Instale
Cobrir todos os cenários de documentos da Microsoft	Todas as três habilidades
Focar em codificação (APIs, exemplos, erros)	Somente `microsoft-code-reference`
Focar em fatos e conceitos (limites, configuração, tutoriais)	Somente `microsoft-docs`
Gerar uma habilidade personalizada para uma tecnologia específica da Microsoft	Somente `microsoft-skill-creator`

🔌 Instalação e Introdução

O Servidor MCP Microsoft Learn suporta instalação rápida em vários ambientes de desenvolvimento. Escolha seu cliente preferido abaixo para uma configuração simplificada:

Cliente	Instalação com um clique	Guia MCP
VS Code	ou pesquise "@mcp learn" em Extensões para mostrar o MCP "Microsoft Learn"	Guia Oficial MCP do VS Code
GitHub Copilot CLI	`/plugin install microsoftdocs/mcp`
Claude Desktop	Siga as instruções "Adicionar conector personalizado" no guia oficial.	Guia MCP Remoto do Claude Desktop
Claude Code	`/plugin install microsoft-docs@claude-plugins-official` (inclui servidor MCP + habilidades)	Guia MCP Remoto do Claude Code
Visual Studio	Atualize para o VS 2022 ou 2026 mais recente, o MCP "Microsoft Learn" já está integrado	Guia Oficial MCP do Visual Studio
Cursor IDE		Guia Oficial MCP do Cursor
Codex	`codex mcp add "microsoft-learn" --url "https://learn.microsoft.com/api/mcp"`	Documentação MCP do Codex
Roo Code	Abra o Marketplace do Roo Code, pesquise por `Microsoft Learn` e clique em `Install`	Guia Oficial MCP do Roo Code
Cline	Configuração manual necessária Use `"type": "streamableHttp"`	Guia Oficial MCP do Cline
Gemini CLI	Configuração manual necessária Ver Configuração Observação: Adicione um objeto `mcpServer` ao arquivo `.gemini/settings.json` { "Microsoft Learn MCP Server": { "httpUrl": "https://learn.microsoft.com/api/mcp" } }	Como configurar seu servidor MCP
Qwen Code	Configuração manual necessária Ver Configuração Observação: Adicione um objeto `mcpServer` ao arquivo `.qwen/settings.json` { "Microsoft Learn MCP Server": { "httpUrl": "https://learn.microsoft.com/api/mcp" } }	Configurar o servidor MCP em settings.json
GitHub	Configuração manual necessária Ver Configuração Observação: Navegue até Configurações → Agente de codificação { "mslearn": { "type": "http", "url": "https://learn.microsoft.com/api/mcp", "tools": [ "*" ] } }
ChatGPT	Configuração manual necessária Ver Instruções 1. Abra o ChatGPT no navegador 2. Vá para Configurações → Conectores → Configurações avançadas → Ative o Modo desenvolvedor 3. Volte para conectores e clique em criar 4. Dê ao conector um nome, insira a URL `https://learn.microsoft.com/api/mcp`, defina autenticação como `No authentication` e confie no aplicativo 5. Clique em criar	Guia Oficial do ChatGPT
Windsurf	Configuração manual necessária Ver Configuração { "mcpServers": { "microsoft-learn": { "serverUrl": "https://learn.microsoft.com/api/mcp" } } }	Guia MCP do Windsurf
Kiro	Ver Configuração { "microsoft-learn": { "url": "https://learn.microsoft.com/api/mcp" } }	Guia MCP do Kiro

⚠️ Criando um Cliente Personalizado

Se o seu caso de uso exigir uma integração direta e programática, é essencial entender que o MCP é um protocolo dinâmico, não uma API estática. As ferramentas disponíveis e seus esquemas evoluirão.

Para criar um cliente resiliente que não quebre quando o serviço for atualizado, você deve seguir os seguintes princípios:

Descubra Ferramentas Dinamicamente: Seu cliente deve buscar definições de ferramentas atuais do servidor em tempo de execução (por exemplo, usando tools/list). Não codifique nomes de ferramentas ou parâmetros.

Atualize em Caso de Falha: Seu cliente deve lidar com erros durante chamadas tool/invoke. Se uma chamada de ferramenta falhar com um erro indicando que ela está ausente ou que seu esquema mudou (por exemplo, um erro HTTP 404 ou 400), seu cliente deve assumir que seu cache está desatualizado e acionar automaticamente uma atualização chamando tools/list.

Lide com Atualizações em Tempo Real: Seu cliente deve ouvir notificações do servidor (por exemplo, listChanged) e atualizar seu cache de ferramentas de acordo.

❓ Solução de Problemas

💻 Prompt do Sistema

Mesmo modelos amigáveis a ferramentas, como o Claude Sonnet 4, às vezes falham ao chamar ferramentas MCP por padrão; use prompts de sistema para incentivar o uso.

Aqui está um exemplo de uma regra do Cursor (um prompt de sistema) que fará o LLM utilizar microsoft-learn com mais frequência:

## Querying Microsoft Documentation

You have access to MCP tools called `microsoft_docs_search`, `microsoft_docs_fetch`, and `microsoft_code_sample_search` - these tools allow you to search through and fetch Microsoft's latest official documentation and code samples, and that information might be more detailed or newer than what's in your training data set.

When handling questions around how to work with native Microsoft technologies, such as C#, F#, ASP.NET Core, Microsoft.Extensions, NuGet, Entity Framework, the `dotnet` runtime - please use these tools for research purposes when dealing with specific / narrowly defined questions that may occur.

⚠️ Problemas Comuns

Problema	Solução Possível
Erros de conexão	Verifique sua conexão de rede e se a URL do servidor foi inserida corretamente
Nenhum resultado retornado	Tente reformular sua consulta com termos técnicos mais específicos
Ferramenta não aparecendo no VS Code	Reinicie o VS Code ou verifique se a extensão MCP está instalada corretamente
Status HTTP 405	Método não permitido ocorre quando um navegador tenta se conectar ao endpoint. Tente usar o Servidor MCP por meio do VS Code GitHub Copilot ou do MCP Inspector em vez disso.
Servidor MCP 'Microsoft Learn' marcado como indisponível no Visual Studio (Motivo: Eclipsed)	O Visual Studio 2022 (17.13+) inclui "Microsoft Learn" como um servidor MCP integrado em um escopo de prioridade mais alta. "Eclipsed" significa que uma definição de prioridade mais alta já existe e a entrada duplicada de prioridade mais baixa é suprimida. O eclipse é correspondido pelo nome do servidor, então remova qualquer entrada adicionada manualmente com o mesmo nome do servidor integrado (comumente `microsoft-learn` ou `Microsoft Learn`) do seu `~/.mcp.json` ou do `.mcp.json` do workspace. O servidor integrado será ativado automaticamente. Nenhuma configuração adicional é necessária para usuários do Visual Studio.