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

# インストール不要で直接実行
npx @microsoft/learn-cli search "BlobClient UploadAsync Azure.Storage.Blobs"

# または、グローバルにインストール後に実行
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 "..."

search または code-search に --json を指定すると、さらに処理するための生の 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 — webviews、TreeViews、コマンド、コントリビューション ポイント

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 を呼び出す

---

効果的なクエリの作成

具体的に — バージョン、目的、言語を含めてください:

# ❌ 広すぎる
"Azure Functions"
"agent framework"

# ✅ 具体的
"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#)