microsoft-docs

Microsoft Docs

ツール

ツール	用途
microsoft_docs_search	ドキュメントを検索します。概念、ガイド、チュートリアル、構成などが対象です
microsoft_docs_fetch	ページ全体のコンテンツを取得します（検索結果の抜粋だけでは不十分な場合）

使用する場面

• 概念の理解 — 「Cosmos DB のパーティション分割はどのように機能しますか？」
• サービスの学習 — 「Azure Functions の概要」、「Container Apps のアーキテクチャ」
• チュートリアルの検索 — 「クイックスタート」、「はじめに」、「ステップごとの手順」
• 構成オプション — 「App Service の構成設定」
• 制限とクォータ — 「Azure OpenAI のレート制限」、「Service Bus のクォータ」
• ベストプラクティス — 「Azure のセキュリティに関するベストプラクティス」

クエリの効果を高める

具体的なクエリが効果的です。

# ❌ Too broad
"Azure Functions"

# ✅ Specific
"Azure Functions Python v2 programming model"
"Cosmos DB partition key design best practices"
"Container Apps scaling rules KEDA"

コンテキストを含めます。

• バージョン（該当する場合は .NET 8、EF Core 8）
• タスクの目的（quickstart、tutorial、overview、limits）
• プラットフォーム（複数のプラットフォームに対応するドキュメントの場合は Linux、Windows）

ページ全体を取得する場面

検索後に取得するのは、次のような場合です。

• チュートリアル — ステップごとの手順をすべて確認する必要がある場合
• 構成ガイド — すべてのオプションを確認する必要がある場合
• 詳細な解説 — ユーザーが包括的な情報を求めている場合
• 検索結果の抜粋が途中で切れている — 全体のコンテキストが必要な場合

このツールを使う理由

• 正確性 — 古くなっている可能性のあるトレーニングデータではなく、最新のドキュメントを参照できます
• 網羅性 — 断片的な内容ではなく、チュートリアルの手順をすべて確認できます
• 信頼性 — Microsoft の公式ドキュメントを参照できます

CLI の代替手段

Learn MCP サーバーを利用できない場合は、代わりにコマンドラインから mslearn CLI を使用します。

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

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

MCP ツール	CLI コマンド
microsoft_docs_search(query: "...")	mslearn search "..."
microsoft_docs_fetch(url: "...")	mslearn fetch "..."

fetch コマンドでは、--section <heading> を指定して単一のセクションを抽出したり、--max-chars <number> を指定して出力を切り詰めたりすることもできます。