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 を使用してください。

---

例外：他のツールを使用する場合

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

Aspire — Aspire MCP Server（推奨）または 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 を実行してください。

CLI 13.1 — MCP サーバーは統合の検索（list_integrations、get_integration_docs）を提供しますが、ドキュメント検索には対応していません。代わりに Context7 を使用してください。

ライブラリ ID	用途
/microsoft/aspire.dev	主な用途 — ガイド、統合、CLI リファレンス、デプロイ
/microsoft/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）のコマンドとフラグ

Agent Framework — Learn MCP と Context7 を使用

Agent Framework のチュートリアルは 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#）