Microsoft Learn

🌟 Microsoft Learn MCP Server

AI のハルシネーションを防ぎましょう。 AI アシスタント（Claude、Cursor、Copilot、Codex など）に、最新の Microsoft 公式ドキュメントへの直接アクセスを提供します。

✨ 無料。ワンクリックでインストール。キーは不要です。

🎯 インストールする理由

古いトレーニングデータやリスクのあるウェブ検索に頼るのはやめましょう。Learn MCP サーバーは、Microsoft の公式ドキュメントに安全かつ直接アクセスできます。

• 🧠 ハルシネーションを排除。 AI が実在しない Azure SDK のメソッドを作り出したり、ライブラリパッケージについて幻覚を見たりするのを防ぎます。実際にコンパイルできるコードを取得できます。

• 🔌 プラグアンドプレイ（認証不要）。 API キー、ログイン、サインアップは不要です。ワンクリックでインストールして、すぐにコーディングを始められます。

• 🛡️ 100% 信頼できて安全。 サプライチェーンを保護します。安全でないブログや悪意のあるサイトを取得する可能性がある一般的なウェブ検索とは異なり、このツールはMicrosoft の公式一次ドキュメントのみにアクセスします。

• 💸 完全無料。 シームレスで負荷の高いコーディングセッションに適した、高い検索容量を備えています。

✨ プロンプトの例

「マネージド ID を使用して Azure Container App を作成する Azure CLI コマンドを教えてください。」

「gpt-5.4 は Azure の EU リージョンで利用できますか？」

「.NET 8 の最小 API で IHttpClientFactory を実装する方法は、これで正しいですか？」

「Azure AI Foundry 評価 SDK を使用して harms eval を実行する、実行可能な Python コードを見せてください。」

🌐 Microsoft Learn MCP Server エンドポイント

Microsoft Learn MCP Server は、Model Context Protocol（MCP）をサポートするすべての IDE、エージェント、ツールから利用できます。互換性のあるクライアントであれば、次のリモート MCP エンドポイントに接続できます。

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

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

標準構成は、ほとんどのクライアントで動作します。

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

試験的な機能については、以下の試験的な機能セクションをご覧ください。

🧪 試験的な機能

Microsoft Learn MCP Server では、現在開発中の試験的な機能を利用できます。これらの機能は、ユーザーからのフィードバックや利用状況に応じて変更または調整される場合があります。

OpenAI 互換エンドポイント

OpenAI Deep Research モデルとの互換性が必要なアプリケーションでは、OpenAI 互換エンドポイントを使用できます。

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

このエンドポイントはOpenAI Deep Research モデルをサポートし、OpenAI MCP 仕様に準拠しています。

トークン予算の制御

トークン使用量を管理してコストを制御するには、MCP エンドポイント URL に maxTokenBudget クエリパラメーターを追加します。このパラメーターは、指定した予算に収まるようコンテンツを切り詰めることで、検索ツールの応答に含まれるトークン数を制限します。

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

注： これらの試験的な機能は変更される場合があります。GitHub Discussionsでのフィードバックをお待ちしています。

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

ツール名	説明	入力パラメーター
microsoft_docs_search	Microsoft の公式技術ドキュメントを対象にセマンティック検索を実行します	query (string)：検索対象のクエリ
microsoft_docs_fetch	Microsoft のドキュメントページを取得し、Markdown 形式に変換します	url (string)：読み込むドキュメントページの URL
microsoft_code_sample_search	Microsoft/Azure の公式コードスニペットやサンプルを検索します	query (string)：Microsoft/Azure のコードスニペットを検索するクエリ language (string, optional)：プログラミング言語のフィルター。

💻 Microsoft Learn CLI

@microsoft/learn-cli パッケージを使うと、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"

npm パッケージをインストールしただけでは、エージェントの検出機能はインストールされません。CLI では、このリポジトリのプラグインがサポートする同じエコシステム、つまり GitHub Copilot、Claude Code、Codex 向けに、CLI を優先するスキルをインストールできます。

# 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

管理対象の検出コンテンツのみを削除するには、次を実行します。

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

エージェント	ユーザースコープ	プロジェクトスコープ
GitHub Copilot	~/.copilot/skills/	.github/skills/
Claude Code	~/.claude/skills/	.claude/skills/
Codex	~/.agents/skills/	.agents/skills/

対象を指定しない場合、セットアップでは、既知のユーザーディレクトリまたはプロジェクトディレクトリからインストール済みエージェントを検出します。削除時には、Microsoft Learn CLI が管理する検出用アーティファクトがあるエージェントのみが検出されます。明示的な対象（--copilot、--claude、--codex）を指定すると、自動検出より優先され、複数を組み合わせることもできます。このワークフローでは MCP を構成せず、Cursor などのプラグインエコシステム以外のエージェントもインストールしません。両方の連携機能がインストールされている場合、エージェントは Microsoft Learn MCP ツールを優先し、スタンドアロン CLI スキルはフォールバックとして使用してください。

プログラムでの処理に便利な、構造化された JSON 出力を取得するには、--json を渡します。

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

コマンドの全リファレンスについては、cli/README.md を参照してください。

🤖 エージェントスキル

エージェントスキルは、AI エージェントがツールをより効果的に使用できるようにする、移植可能な指示パッケージです。Microsoft Learn MCP ツールをいつ、どのように使用するかをエージェントに案内する、3 つのスキルを提供しています。

スキル	目的	最適な用途
microsoft-docs	概念、チュートリアル、アーキテクチャ、制限事項の理解	「X はどのように動作しますか？」、学習、構成ガイド
microsoft-code-reference	API の検索、コードサンプル、検証、エラーの修正	コードの実装、正しいメソッドの検索、トラブルシューティング
microsoft-skill-creator	あらゆる Microsoft テクノロジー向けのカスタムエージェントスキルを生成するメタスキル	新しい Azure ライブラリ、.NET の機能、その他の Microsoft テクノロジーについてエージェントに教えるスキルの作成

クイックセットアップ

エージェントによる Microsoft Learn コンテンツの取得方法に合わせて、インテグレーションを選択してください。

モード	インストール	エージェントの動作
スタンドアロンの CLI 優先	@microsoft/learn-cli をインストールして実行し、mslearn setup --cli [agent-target] を実行します	検出または選択されたエージェントは npx @microsoft/learn-cli@latest を呼び出します。MCP は設定されません
リポジトリプラグイン、MCP 優先	GitHub Copilot、Claude Code、または Codex 用のリポジトリプラグインをインストールします	プラグインに Learn MCP エンドポイントと MCP 向けスキルが含まれています

リポジトリプラグインは Claude Code にも対応しています。次のコマンドを実行して、Claude Code を再起動してください。

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

MCP 優先の GitHub Copilot CLI プラグインの場合は、次を実行してください。

/plugin install microsoftdocs/mcp

それ以外の場合：

1. まず MCP サーバーをインストールします — 以下のインストールを参照してください
2. スキルフォルダーをコピーします — プロジェクトの .github/skills/ または .claude/skills/ ディレクトリにコピーしてください。
   • microsoft-docs — 概念、チュートリアル、事実の確認に使用します
   • microsoft-code-reference — API の検索、コードサンプル、トラブルシューティングに使用します
   • microsoft-skill-creator — Microsoft テクノロジに関するカスタムスキルを生成するためのメタスキルです

対応エージェント

エージェントスキルは、複数の AI エージェントで利用できます。

• VS Code（Insiders）— chat.useAgentSkills 設定を有効にします
• GitHub Copilot CLI と Copilot coding agent
• Claude Code、Cursor、OpenAI Codex、その他のエージェント

どのスキルが必要ですか？

目的	インストール
Microsoft ドキュメントのあらゆるシナリオに対応する	3 つすべてのスキル
コーディング（API、サンプル、エラー）に特化する	microsoft-code-reference のみ
事実や概念（制限、構成、チュートリアル）に特化する	microsoft-docs のみ
特定の Microsoft テクノロジ向けのカスタムスキルを生成する	microsoft-skill-creator のみ

🔌 インストールと利用開始

Microsoft Learn MCP サーバーは、複数の開発環境で簡単にインストールできます。スムーズにセットアップできるよう、以下からお好みのクライアントを選択してください。

クライアント	ワンクリックインストール	MCP ガイド
VS Code	または、拡張機能で「@mcp learn」を検索すると、「Microsoft Learn」MCP が表示されます	VS Code 公式 MCP ガイド
GitHub Copilot CLI	/plugin install microsoftdocs/mcp
Claude Desktop	公式ガイドの「カスタムコネクタを追加」の手順に従ってください。	Claude Desktop リモート MCP ガイド
Claude Code	/plugin install microsoft-docs@claude-plugins-official（MCP サーバーとスキルを含みます）	Claude Code リモート MCP ガイド
Visual Studio	最新の VS 2022 または 2026 にアップグレードしてください。「Microsoft Learn」MCP はすでに組み込まれています	Visual Studio 公式 MCP ガイド
Cursor IDE		Cursor 公式 MCP ガイド
Codex	codex mcp add "microsoft-learn" --url "https://learn.microsoft.com/api/mcp"	Codex MCP ドキュメント
Roo Code	Roo Code Marketplace を開き、Microsoft Learn を検索して、Install をクリックしてください	Roo Code 公式 MCP ガイド
Cline	手動での設定が必要です "type": "streamableHttp" を使用してください	Cline 公式 MCP ガイド
Gemini CLI	手動での設定が必要です 設定を表示 注：.gemini/settings.json ファイルに mcpServer オブジェクトを追加します { "Microsoft Learn MCP Server": { "httpUrl": "https://learn.microsoft.com/api/mcp" } }	MCP サーバーの設定方法
Qwen Code	手動での設定が必要です 設定を表示 注：.qwen/settings.json ファイルに mcpServer オブジェクトを追加します { "Microsoft Learn MCP Server": { "httpUrl": "https://learn.microsoft.com/api/mcp" } }	settings.json で MCP サーバーを設定する
GitHub	手動での設定が必要です 設定を表示 注：［設定］→［コーディングエージェント］に移動します { "mslearn": { "type": "http", "url": "https://learn.microsoft.com/api/mcp", "tools": [ "*" ] } }
ChatGPT	手動での設定が必要です 手順を表示 1. ブラウザーで ChatGPT を開きます 2. 設定 → コネクタ → 詳細設定 → 開発者モードをオンにするに移動します 3. コネクタに戻り、作成をクリックします 4. コネクタの名前を入力し、URL https://learn.microsoft.com/api/mcp を入力して、認証を No authentication に設定し、アプリケーションを信頼します 5. 作成をクリックします	ChatGPT 公式ガイド
Windsurf	手動での設定が必要です 設定を表示 { "mcpServers": { "microsoft-learn": { "serverUrl": "https://learn.microsoft.com/api/mcp" } } }	Windsurf MCP ガイド
Kiro	設定を表示 { "microsoft-learn": { "url": "https://learn.microsoft.com/api/mcp" } }	Kiro MCP ガイド

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

ユースケースで直接的なプログラム連携が必要な場合、MCP は静的な API ではなく、動的なプロトコルであることを理解することが不可欠です。利用可能なツールとそのスキーマは変化します。

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

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

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

💻 システムプロンプト

Claude Sonnet 4 のようなツールに対応したモデルでも、デフォルトでは MCP ツールを呼び出さないことがあります。使用を促すには、システムプロンプトを利用してください。

以下は、LLM が microsoft-learn をより頻繁に利用するようにする Cursor ルール（システムプロンプト）の例です。

## 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.

⚠️ よくある問題

問題	解決策
接続エラー	ネットワーク接続と、サーバー URL が正しく入力されていることを確認してください
結果が返されない	より具体的な技術用語を使って、クエリの表現を変えてみてください
VS Code にツールが表示されない	VS Code を再起動するか、MCP 拡張機能が正しくインストールされていることを確認してください
HTTP status 405	ブラウザーがエンドポイントに接続しようとすると、「Method not allowed」が発生します。代わりに、VS Code GitHub Copilot または MCP Inspector を通じて MCP Server を使用してください。
Visual Studio で MCP サーバー「Microsoft Learn」が使用不可と表示される（理由：Eclipsed）	Visual Studio 2022 (17.13+) には、「Microsoft Learn」がより優先度の高いスコープで組み込み MCP サーバーとして含まれています。「Eclipsed」は、より優先度の高い定義がすでに存在するため、重複する優先度の低いエントリが抑制されていることを意味します。サーバー名を基準に判定されるため、組み込みサーバーと同じ名前（通常は microsoft-learn または Microsoft Learn）の手動追加エントリを ~/.mcp.json またはワークスペースの .mcp.json から削除してください。組み込みサーバーは自動的に有効になります。Visual Studio ユーザーに追加の設定は必要ありません。

🆘 サポートを受ける

• 質問やアイデアを共有する
• 問題を報告する

📚 追加のリソース

• Microsoft Learn MCP Server の製品ドキュメント
• Microsoft MCP サーバー
• Microsoft Learn
• Model Context Protocol の仕様
• Microsoft Learn の利用規約