MCP

🚀 Microsoft Learn MCP Server

Microsoft Learn MCP Serverは、GitHub Copilotやその他のAIエージェントなどのクライアントが、Microsoftの公式ドキュメントから信頼性の高い最新情報を直接取得できるリモートMCPサーバーです。軽量なストリーミング可能なHTTPトランスポートをサポートしています。

このプロジェクトはパブリックプレビュー段階であり、正式リリースまでに実装内容が大きく変更される可能性があります。

🚀 クイックスタート

📑 目次

1. 🎯 概要
2. 🌐 Microsoft Learn MCPサーバーエンドポイント
3. 🛠️ 現在サポートされているツール
4. 🔌 インストールと始め方
5. ❓ トラブルシューティング
6. 🔮 将来的な機能強化
7. 📚 追加リソース

🎯 概要

✨ サンプルプロンプト：信頼できる情報源

AIアシスタントは、Microsoft関連のトピックについて自動的にこれらのツールを使用する必要があります。検索と取得の両方の機能を備えているため、迅速な回答や包括的な詳細情報を取得できます。常に公式ドキュメントを参照するようにするには、search Microsoft docs、deep dive、fetch full docなどのフレーズを追加できます。

クイック検索と参照

"Azure CLIコマンドを使って、マネージドID付きのAzure Container Appを作成する方法を教えて。search Microsoft docs" "gpt - 4.1 - miniはEU地域で利用可能ですか？fetch full doc"

コード検証とベストプラクティス

".NET 8のミニマルAPIでIHttpClientFactoryを実装する正しい方法はこれですか？search Microsoft docs and fetch full doc" "ASP.NET Coreで認証を実装する完全なガイドを見せて。fetch full doc"

包括的な学習と詳細調査

"Azure Functionsを完全に理解する必要があります。search Microsoft docs and deep dive" ".NETアプリケーションをAzure App Serviceにデプロイする完全なステップバイステップのチュートリアルを取得してください。search Microsoft docs and deep dive"

📊 主要機能

• 高品質なコンテンツ取得：Microsoftの公式ドキュメントからMarkdown形式で関連するコンテンツを検索して取得します。
• 意味理解：高度なベクトル検索を使用して、任意のクエリに対して最も文脈的に関連するドキュメントを見つけます。
• リアルタイム更新：最新のMicrosoftドキュメントが公開されるとすぐにアクセスできます。

🌐 Microsoft Learn MCPサーバーエンドポイント

Microsoft Learn MCPサーバーは、Model Context Protocol (MCP)をサポートする任意のIDE、エージェント、またはツールからアクセスできます。互換性のあるクライアントは、以下のリモートMCPエンドポイントに接続できます。

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

注意：このURLは、Streamable HTTPを介した準拠MCPクライアント内での使用を想定しています。たとえば、始め方セクションに記載されている推奨クライアントを使用します。ウェブブラウザから直接アクセスすることはサポートされておらず、手動でアクセスすると405 Method Not Allowedエラーが返される場合があります。独自のソリューションを構築する必要がある開発者は、カスタムクライアントの構築セクションの必須ガイドラインに従って、実装が堅牢でサポートされるようにしてください。

JSON設定の例：

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

🛠️ 現在サポートされているツール

🔌 インストールと始め方

Microsoft Learn MCPサーバーは、複数の開発環境での迅速なインストールをサポートしています。以下から好みのクライアントを選択して、簡単にセットアップしましょう。

クライアント	ワンクリックインストール	MCPガイド
VS Code		[VS Code MCP公式ガイド](https://code.visualstudio.com/docs/copilot/chat/mcp - servers)
Claude Desktop	手順を表示 1. Claude Desktopを開きます 2. Settings → Integrationsに移動します 3. Add Integrationをクリックします 4. URLを入力します：https://learn.microsoft.com/api/mcp 5. Connectをクリックします	[Claude DesktopリモートMCPガイド](https://support.anthropic.com/en/articles/11503834 - building - custom - integrations - via - remote - mcp - servers)
Claude Code	手順を表示 1. CLIを開きます 2. claude mcp add --transport http microsoft_docs_mcp https://learn.microsoft.com/api/mcpと入力してEnterキーを押します 3. (オプション) claude mcp addの直後に--scope userと入力すると、このMCPサーバーをすべてのプロジェクトでClaude Codeで使用できるようになります	[Claude CodeリモートMCPガイド](https://docs.anthropic.com/en/docs/claude - code/mcp)
Visual Studio	手動での設定が必要です "type": "http"を使用します	[Visual Studio MCP公式ガイド](https://learn.microsoft.com/en - us/visualstudio/ide/mcp - servers?view=vs - 2022)
Cursor IDE	[](https://cursor.com/install - mcp?name=microsoft.docs.mcp&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbGVhcm4ubWljcm9zb2Z0LmNvbS9hcGkvbWNwIn0%3D)	[Cursor MCP公式ガイド](https://docs.cursor.com/context/model - context - protocol)
Roo Code	手動での設定が必要です "type": "streamable - http"を使用します	[Roo Code MCP公式ガイド](https://docs.roocode.com/features/mcp/using - mcp - in - roo)
Cline	手動での設定が必要です "type": "streamableHttp"を使用します	[Cline MCP公式ガイド](https://docs.cline.bot/mcp/connecting - to - a - remote - server)
Gemini CLI	手動での設定が必要です 設定を表示 注意：.gemini/settings.jsonファイルにmcpServerオブジェクトを追加します { "Microsoft Learn MCP Server": { "httpUrl": "https://learn.microsoft.com/api/mcp" } }	[MCPサーバーの設定方法](https://github.com/google - gemini/gemini - cli/blob/main/docs/tools/mcp - server.md#how - to - set - up - your - mcp - server)
Qwen Code	手動での設定が必要です 設定を表示 注意：.qwen/settings.jsonファイルにmcpServerオブジェクトを追加します { "Microsoft Learn MCP Server": { "httpUrl": "https://learn.microsoft.com/api/mcp" } }	[settings.jsonでMCPサーバーを構成する](https://qwenlm.github.io/qwen - code - docs/en/cli/tutorials/#configure - the - mcp - server - in - settingsjson)
GitHub	手動での設定が必要です 設定を表示 注意：Settings → Coding agentに移動します { "mslearn": { "command": "npx", "args": [ "-y", "mcp - remote", "https://learn.microsoft.com/api/mcp" ], "tools":["*"] } }
ChatGPT	手動での設定が必要です 手順を表示 1. ブラウザでChatGPTを開きます 2. Settings → Connectors → Advanced settings → Turn Developer mode onに移動します 3. コネクタに戻り、createをクリックします 4. コネクタに名前を付け、URL https://learn.microsoft.com/api/mcpを入力し、authenticationをNo authenticationに設定し、アプリケーションを信頼します 5. createをクリックします	[ChatGPT公式ガイド](https://platform.openai.com/docs/guides/developer - mode)

代替インストール方法（レガシークライアントまたはローカル設定用）

ネイティブのリモートMCPサーバーをサポートしていないクライアント、またはローカル設定を好む場合は、mcp - remoteをプロキシとして使用できます。

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

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

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

▶️ 始め方

1. VS Codeの場合：VS CodeでGitHub Copilotを開き、[エージェントモードに切り替えます](https://code.visualstudio.com/docs/copilot/chat/chat - agent - mode)
2. Claude Desktopの場合：統合を追加した後、チャットインターフェイスにMCPツールのアイコンが表示されます
3. 利用可能なツールのリストにLearn MCPサーバーが表示されるはずです
4. エージェントにMCPサーバーを使用するように指示するプロンプトを試してみましょう。たとえば、"公式のMicrosoft Learnドキュメントによると、Azureコンテナアプリを作成するためのaz cliコマンドは何ですか？"
5. エージェントはMCPサーバーのツールを使用してクエリを完了できるはずです。

⚠️ カスタムクライアントの構築

直接的なプログラムによる統合が必要な場合は、MCPが動的なプロトコルであり、静的なAPIではないことを理解することが重要です。利用可能なツールとそのスキーマは進化します。

サービスが更新されても破損しない堅牢なクライアントを構築するには、以下の原則に従ってください。

1. ツールを動的に検出する：クライアントは、実行時にサーバーから現在のツール定義を取得する必要があります（たとえば、tools/listを使用）。ツール名やパラメータをハードコードしないでください。
2. 失敗時にリフレッシュする：クライアントはtool/invoke呼び出し中のエラーを処理する必要があります。ツール呼び出しがエラーで失敗し、ツールが欠落しているか、そのスキーマが変更されたことを示す場合（たとえば、HTTP 404または400エラー）、クライアントはキャッシュが古くなったと見なし、tools/listを呼び出して自動的にリフレッシュをトリガーする必要があります。
3. ライブ更新を処理する：クライアントはサーバー通知（たとえば、listChanged）をリッスンし、それに応じてツールキャッシュを更新する必要があります。

❓ トラブルシューティング

💻 システムプロンプト

Claude Sonnet 4のようなツールに友好的なモデルでも、デフォルトでMCPツールを呼び出せない場合があります。システムプロンプトを使用して使用を促しましょう。 以下は、大規模言語モデルがmicrosoft.docs.mcpをより頻繁に利用するようにするCursorルール（システムプロンプト）の例です。

## Microsoftドキュメントのクエリ
`microsoft_docs_search`と`microsoft_docs_fetch`というMCPツールにアクセスできます。これらのツールを使用すると、Microsoftの最新の公式ドキュメントを検索して取得でき、その情報はトレーニングデータセットに含まれているものよりも詳細または新しい場合があります。
C#、F#、ASP.NET Core、Microsoft.Extensions、NuGet、Entity Framework、`dotnet`ランタイムなどのネイティブMicrosoftテクノロジーを使用する方法に関する質問を処理する際に、発生する可能性のある特定の/狭義の質問に対処するために、このツールを調査目的で使用してください。

⚠️ 一般的な問題

🆘 サポートを受ける

• 質問をする、アイデアを共有する
• 問題を作成する

🔮 将来的な機能強化

Microsoft Learn MCPサーバーチームは、いくつかの機能強化に取り組んでいます。

• microsoft_code_searchツール：エージェントが正確な公式のMicrosoftサンプルコードスニペットを見つけるのに役立ちます。
• サーバーの機能強化に役立つテレメトリの改善
• 追加のMicrosoftドキュメントソースへのカバレッジ拡大
• より正確な結果を得るためのクエリ理解の改善

📚 追加リソース

• Microsoft Learn MCPサーバー製品ドキュメント
• Microsoft MCPサーバー
• Microsoft Learn
• Model Context Protocol仕様