Microsoft Learn MCP

왜 쓰나요

핵심 기능

원격 MCP — 설치 불필요, mcp-remote를 URL에 지정하기만 하면 됨
Azure, .NET, M365, Power Platform, Windows, Visual Studio 커버
사용 가능한 경우 결과에 코드 샘플 포함
learn.microsoft.com으로의 인용 URL
항상 최신 — 임베디드 스냅샷 드리프트 없음
무료, API 키 불필요

라이브 데모

실제 사용 모습

microsoft-learn-mcp.replay ▶ 준비됨

0/0

설치

클라이언트 선택

~/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"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

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

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

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

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

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

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

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

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

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

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

context_servers에 추가. 저장 시 Zed가 핫 리로드.

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

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: Microsoft Learn MCP

현재 문서에서 Azure 리소스 패턴 구현

👤 Azure 클라우드 엔지니어 ⏱ ~20 min intermediate

언제 쓸까: Claude가 더 이상 사용되지 않는 속성 이름으로 Bicep/Terraform을 계속 작성할 때; 현재 API를 사용하게 하고 싶을 때.

흐름

문서 검색

Microsoft Learn MCP: 'Azure Container Apps managed identity' 검색. 현재 문서를 가져오세요.✓ 복사됨

→ URL이 있는 Learn 페이지들이 검색에서 반환됨
가져와서 인용

사용자 할당 ID를 지정하는 섹션을 가져오세요. 현재 Bicep 스키마를 정확히 인용하고, 요약하지 마세요.✓ 복사됨

→ 속성 이름이 있는 정확한 Bicep 스니펫
적용

이제 기존 ID id-prod-app을 사용하는 컨테이너 앱을 위한 Bicep을 작성하세요. 인용한 스키마와 일치시키세요.✓ 복사됨

→ 현재 Microsoft.App API에 대해 Bicep이 컴파일됨

결과: 스키마가 현재 Azure API와 일치하여 처음 시도에 깨끗하게 배포되는 Bicep

함정

검색을 통해 나온 문서가 이전 API 버전용임 — URL에 'latest' 또는 올바른 api-version이 있는지 항상 확인

함께 쓰기: filesystem · github

Claude에서 벗어나지 않고 .NET API 조회

👤 C# / .NET 개발자 ⏱ ~10 min beginner

언제 쓸까: System.Threading.Channels.Channel.CreateBounded의 정확한 시그니처가 필요할 때.

흐름

검색

Microsoft Learn: .NET 9에서 Channel.CreateBounded 시그니처.✓ 복사됨

→ 오버로드가 있는 API 참조 페이지
사용

용량 100, FullMode=Wait인 BoundedChannelOptions를 사용하는 producer/consumer를 작성하세요. 문서와 정확히 일치시키세요.✓ 복사됨

→ 현재 API 표면과 일치하는 코드

결과: 문서 전환 없이 코드가 정확한 C#

함정

.NET Framework와 .NET (Core) 문서 혼동 — 항상 버전 지정; Learn이 둘 다 반환

인용이 있는 Microsoft Graph PowerShell 스크립트 작성

👤 M365 관리자 ⏱ ~25 min intermediate

언제 쓸까: 라이선스 할당을 일괄 업데이트하고 현재 Graph cmdlet 구문이 필요할 때.

흐름

cmdlet 찾기

Learn: Microsoft.Graph PowerShell SDK에서 Set-MgUserLicense의 현재 구문.✓ 복사됨

→ 파라미터 집합이 있는 cmdlet 문서
스크립트 작성

users.csv (UPN, SkuPartNumber)를 읽고 라이선스를 할당하는 스크립트를 작성하세요. 사용한 Learn URL을 인용하세요.✓ 복사됨

→ 댓글 블록 인용이 있는 작동하는 PowerShell

결과: 검토를 위한 인용이 있는 감사 가능한 스크립트

함정

이전 AzureAD 모듈 구문 — AzureAD는 더 이상 사용되지 않음; 프롬프트에서 Microsoft.Graph를 명시적으로 요청

함께 쓰기: filesystem

조합

다른 MCP와 조합해 10배 효율

microsoft-learn-mcp + github

Learn에서 현재 Azure 패턴을 찾은 후 IaC 변경 PR

Learn: Container Apps + identity 가져오기. GitHub: Bicep 업데이트 PR 열기.✓ 복사됨

microsoft-learn-mcp + filesystem

인용된 스니펫을 런북으로 저장

M365 라이선스 cmdlet 문서를 가져와 인용이 있는 런북을 /runbooks/m365-license.md에 저장하세요.✓ 복사됨

microsoft-learn-mcp + context7

Microsoft 문서를 더 광범위한 라이브러리 문서와 교차 참조

동일한 SDK에 대해 Microsoft Learn의 권장 패턴과 context7의 내용을 비교하세요.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
microsoft_docs_search	query: str	첫 번째 단계	free
microsoft_docs_fetch	url: str	특정 페이지 가져오기	free

비용 및 제한

운영 비용

API 쿼터: Microsoft가 호스팅; 합리적인 IP당 공정 사용
호출당 토큰: 300–5000
금액: 무료
팁: 먼저 검색하고, 가장 관련성 높은 상위 1-2개 URL만 가져오기

보안

권한, 시크릿, 파급범위

자격 증명 저장: 없음 — 공개 문서

데이터 외부 송신: learn.microsoft.com

검색 쿼리가 Microsoft에 전송됨 — 조직 정책이 이를 제한한다면 민감한 세부 정보를 포함하지 말 것

문제 해결

자주 발생하는 오류와 해결

결과 페이지가 이전 API 버전용임

쿼리에 'api-version=YYYY-MM' 또는 .NET 버전 추가

검색에서 마케팅 페이지가 반환됨

쿼리에 'docs' 또는 'reference' 추가; URL에 '/dotnet/api/' 또는 '/azure/'가 포함된 것으로 필터링

mcp-remote 연결 거부

네트워크 확인; 엔드포인트는 https://learn.microsoft.com/api/mcp

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

대안