microsoft-docs

Microsoft Docs

Microsoft テクノロジーエコシステム向けのリサーチスキルです。learn.microsoft.com と、その外側にあるドキュメント（VS Code、GitHub、Aspire、Agent Framework のリポジトリ）をカバーします。

---

デフォルト: Microsoft Learn MCP

learn.microsoft.com 上のすべてにこれらのツールを使用してください — Azure、.NET、M365、Power Platform、Agent Framework、Semantic Kernel、Windows など。これは、大多数の Microsoft ドキュメントクエリにおける主要なツールです。

ツール	目的
microsoft_docs_search	learn.microsoft.com を検索 — 概念、ガイド、チュートリアル、構成
microsoft_code_sample_search	Learn ドキュメントから動作するコードスニペットを検索します。最良の結果を得るには language（python、csharp など）を渡してください
microsoft_docs_fetch	特定の URL からページ全体の内容を取得します（検索の抜粋では不十分な場合）

完全なチュートリアル、すべての構成オプションが必要な場合、または検索の抜粋が切り詰められている場合は、検索後に microsoft_docs_fetch を使用してください。

CLI の代替手段

Learn MCP サーバーが利用できない場合は、ターミナルまたはシェル（たとえば Bash、PowerShell、cmd）から mslearn CLI を使用してください:

# Run directly (no install needed)
npx @microsoft/learn-cli search "BlobClient UploadAsync Azure.Storage.Blobs"

# Or install globally, then run
npm install -g @microsoft/learn-cli
mslearn search "BlobClient UploadAsync Azure.Storage.Blobs"

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

さらに処理するために生の JSON 出力を取得するには、search または code-search に --json を渡してください。

---

例外: 他のツールを使用すべき場合

以下のカテゴリは learn.microsoft.com の外側にあります。代わりに指定されたツールを使用してください。

.NET Aspire — Aspire MCP サーバー（推奨）または Context7 を使用

Aspire のドキュメントは Learn ではなく aspire.dev にあります。最適なツールは、お使いの Aspire CLI のバージョンによって異なります:

CLI 13.2 以降（推奨） — Aspire MCP サーバーには、ドキュメント検索ツールが組み込まれています:

MCP ツール	説明
list_docs	aspire.dev から利用可能なすべてのドキュメントを一覧表示します
search_docs	aspire.dev のコンテンツ全体に対する重み付き字句検索
get_doc	スラッグで特定のドキュメントを取得します

これらは Aspire CLI 13.2 で提供されています（PR #14028）。更新するには: aspire update --self --channel daily。参考: https://davidpine.dev/posts/aspire-docs-mcp-tools/

CLI 13.1 — MCP サーバーは統合の検索（list_integrations、get_integration_docs）を提供しますが、ドキュメント検索は提供しません。Context7 にフォールバックしてください:

ライブラリ ID	用途
/microsoft/aspire.dev	主要 — ガイド、統合、CLI リファレンス、デプロイ
/dotnet/aspire	ランタイムソース — API 内部、実装の詳細
/communitytoolkit/aspire	コミュニティ統合 — Go、Java、Node.js、Ollama

VS Code — Context7 を使用

VS Code のドキュメントは Learn ではなく code.visualstudio.com にあります。

ライブラリ ID	用途
/websites/code_visualstudio	ユーザードキュメント — 設定、機能、デバッグ、リモート開発
/websites/code_visualstudio_api	拡張機能 API — webview、TreeView、コマンド、コントリビューションポイント

GitHub — Context7 を使用

GitHub のドキュメントは docs.github.com と cli.github.com にあります。

ライブラリ ID	用途
/websites/github_en	Actions、API、リポジトリ、セキュリティ、管理、Copilot
/websites/cli_github	GitHub CLI（gh）のコマンドとフラグ

エージェントフレームワーク — Learn MCP + Context7 の活用

エージェントフレームワークのチュートリアルは learn.microsoft.com にあります（microsoft_docs_search を使用）が、GitHub リポジトリには公開ドキュメントよりも先行していることが多い API レベルの詳細、特に DevUI REST API リファレンス、CLI オプション、.NET 統合に関する情報があります。

ライブラリ ID	用途
/websites/learn_microsoft_en-us_agent-framework	チュートリアル — DevUI ガイド、トレース、ワークフローオーケストレーション
/microsoft/agent-framework	API の詳細 — DevUI REST エンドポイント、CLI フラグ、認証、.NET の AddDevUI/MapDevUI

DevUI のヒント: ハウツーガイドについては Learn ウェブサイトのソースに問い合わせ、API レベルの詳細（エンドポイントスキーマ、プロキシ設定、認証トークン）についてはリポジトリのソースに問い合わせてください。

---

Context7 のセットアップ

Context7 のクエリでは、まずライブラリ ID を解決します（セッションごとに 1 回）:

1. テクノロジー名を指定して mcp_context7_resolve-library-id を呼び出します
2. 返されたライブラリ ID と具体的なクエリを指定して mcp_context7_query-docs を呼び出します

---

効果的なクエリの書き方

具体的に記述してください — バージョン、意図、言語を含めます:

# ❌ Too broad
"Azure Functions"
"agent framework"

# ✅ Specific
"Azure Functions Python v2 programming model"
"Cosmos DB partition key design best practices"
"GitHub Actions workflow_dispatch inputs matrix strategy"
"Aspire AddUvicornApp Python FastAPI integration"
"DevUI serve agents tracing OpenTelemetry directory discovery"
"Agent Framework workflow conditional edges branching handoff"

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

• 関連する場合はバージョン（.NET 8、Aspire 13、VS Code 1.96）
• タスクの意図（quickstart、tutorial、overview、limits、API reference）
• 多言語ドキュメントの場合は言語（Python、TypeScript、C#）