Microsoft Code Reference

ツール

必要な機能	ツール	例
APIメソッド/クラスの検索	microsoft_docs_search	"BlobClient UploadAsync Azure.Storage.Blobs"
動作するコードサンプル	microsoft_code_sample_search	query: "upload blob managed identity", language: "python"
完全な API リファレンス	microsoft_docs_fetch	microsoft_docs_search から URL を取得 (オーバーロード、完全なシグネチャ用)

コードサンプルの検索

microsoft_code_sample_search を使用して、公式の動作するサンプルを取得します：

microsoft_code_sample_search(query: "upload file to blob storage", language: "csharp")
microsoft_code_sample_search(query: "authenticate with managed identity", language: "python")
microsoft_code_sample_search(query: "send message service bus", language: "javascript")

使用するタイミング：

• コード作成前—従うべき動作パターンを探す
• エラー後—コードを既知の良い例と比較する
• 初期化/セットアップが不明—サンプルに完全なコンテキストが示されている

API ルックアップ

# メソッドが存在することを確認 (精度を高めるため名前空間を含める)
"BlobClient UploadAsync Azure.Storage.Blobs"
"GraphServiceClient Users Microsoft.Graph"

# クラス/インターフェイスを検索
"DefaultAzureCredential class Azure.Identity"

# 正しいパッケージを検索
"Azure Blob Storage NuGet package"
"azure-storage-blob pip package"

メソッドに複数のオーバーロードがある場合、または完全なパラメータの詳細が必要な場合は、完全なページを取得します。

エラーのトラブルシューティング

microsoft_code_sample_search を使用して動作するコードサンプルを探し、実装と比較します。特定のエラーについては、microsoft_docs_search と microsoft_docs_fetch を使用します：

エラーの種類	クエリ
メソッドが見つからない	"[ClassName] methods [Namespace]"
タイプが見つからない	"[TypeName] NuGet package namespace"
不正なシグネチャ	"[ClassName] [MethodName] overloads" → 完全なページを取得
非推奨の警告	"[OldType] migration v12"
認証失敗	"DefaultAzureCredential troubleshooting"
403 Forbidden	"[ServiceName] RBAC permissions"

検証が必要な場合

以下の場合は常に検証してください：

• メソッド名が「都合よく」見える (UploadFile vs 実際の Upload)
• SDK バージョンを混在させている (v11 CloudBlobClient vs v12 BlobServiceClient)
• パッケージ名が命名規則に従わない (.NET 向け Azure.*、Python 向け azure-*)
• API を初めて使用する

検証ワークフロー

Microsoft SDK を使用してコードを生成する前に、正しいことを確認します：

1. メソッドまたはパッケージが存在することを確認 — microsoft_docs_search(query: "[ClassName] [MethodName] [Namespace]")
2. 完全な詳細を取得 (オーバーロード/複雑なパラメータ用) — microsoft_docs_fetch(url: "...")
3. 動作するサンプルを検索 — microsoft_code_sample_search(query: "[task]", language: "[lang]")

単純な検索の場合、ステップ 1 だけで十分な場合もあります。複雑な API 使用法では、3 つのステップすべてを完了します。

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 出力が得られます。