Microsoft Learn リモートMCPサーバー – 公式URL・MCP接続設定・ツール一覧
Microsoft Learn は Microsoft が提供するリモートMCPサーバー(公式運営、カテゴリ:検索・ドキュメント)です。エンドポイント https://learn.microsoft.com/api/mcp を通じて、AIエージェントが直接呼び出せる 3 個の構造化ツールを提供します。
このページでは、公式リモートエンドポイント、トランスポート、認証方式、全ツールスキーマ、リアルタイムの死活監視・セキュリティ監査結果を掲載し、Cursor・Claude Code・VS Code・ChatGPT など 10 のクライアントへのMCP接続手順を解説します。
- 提供元
- Microsoft ↗
- カテゴリ
- 🔍 検索・ドキュメント
Or add to ~/.cursor/mcp.json:
{
"mcpServers": {
"microsoft-learn": {
"url": "https://learn.microsoft.com/api/mcp"
}
}
}claude mcp add --transport http microsoft-learn https://learn.microsoft.com/api/mcp
Or add to .vscode/mcp.json:
{
"servers": {
"microsoft-learn": {
"type": "http",
"url": "https://learn.microsoft.com/api/mcp"
}
}
}- Open Settings → Connectors (Integrations) → Add Custom Connector.
- Paste the endpoint URL:
https://learn.microsoft.com/api/mcp - No authentication needed — tools are available immediately.
Bridge the remote endpoint into stdio with mcp-remote in claude_desktop_config.json:
{
"mcpServers": {
"microsoft-learn": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://learn.microsoft.com/api/mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"microsoft-learn": {
"serverUrl": "https://learn.microsoft.com/api/mcp"
}
}
}Add to ~/.kiro/settings/mcp.json (or .kiro/settings/mcp.json in your workspace), then reopen Kiro's Agent panel to pick up the server:
{
"mcpServers": {
"microsoft-learn": {
"url": "https://learn.microsoft.com/api/mcp"
}
}
}Add to ~/.codex/config.toml — Codex reads remote HTTP servers from [mcp_servers.*] tables:
[mcp_servers.microsoft-learn] url = "https://learn.microsoft.com/api/mcp"
Add to cline_mcp_settings.json (Cline → MCP Servers → Configure), or paste it via Cline's MCP marketplace file:
{
"mcpServers": {
"microsoft-learn": {
"type": "streamableHttp",
"url": "https://learn.microsoft.com/api/mcp"
}
}
}Add to ~/.gemini/settings.json under mcpServers — httpUrl for Streamable HTTP, url for legacy SSE:
{
"mcpServers": {
"microsoft-learn": {
"httpUrl": "https://learn.microsoft.com/api/mcp"
}
}
}🧰 Microsoft Learn のMCPツールとスキーマ(3)
| Tool | Safety | Description | Parameters |
|---|---|---|---|
| microsoft_docs_search ~245 tok | 🟢 Readidempotent | Search official Microsoft/Azure documentation to find the most relevant and trustworthy content for a user's query. This tool returns up to 10 high-quality content chunks (each max 500 tokens), extracted from Microsoft Learn and other official sources. Each result includes the article title, URL, and a self-contained content excerpt optimized for fast retrieval and reasoning. Always use this tool to quickly ground your answers in accurate, first-party Microsoft/Azure knowledge. ## Follow-up Pattern To ensure completeness, use microsoft_docs_fetch when high-value pages are identified by search. The fetch tool complements search by providing the full detail. This is a required step for comprehensive results. | query: string |
| microsoft_code_sample_search ~385 tok | 🟢 Readidempotent | Search for code snippets and examples in official Microsoft Learn documentation. This tool retrieves relevant code samples from Microsoft documentation pages providing developers with practical implementation examples and best practices for Microsoft/Azure products and services related coding tasks. This tool will help you use the **LATEST OFFICIAL** code snippets to empower coding capabilities. ## When to Use This Tool - When you are going to provide sample Microsoft/Azure related code snippets in your answers. - When you are **generating any Microsoft/Azure related code**. ## Usage Pattern Input a descriptive query, or SDK/class/method name to retrieve related code samples. The optional parameter `language` can help to filter results. Eligible values for `language` parameter include: csharp javascript typescript python powershell azurecli al sql java kusto cpp go rust ruby php | query*: stringlanguage: string |
| microsoft_docs_fetch ~321 tok | 🟢 Readidempotent | Fetch and convert a Microsoft Learn documentation webpage to markdown format. This tool retrieves the latest complete content of Microsoft documentation webpages including Azure, .NET, Microsoft 365, and other Microsoft technologies. ## When to Use This Tool - When search results provide incomplete information or truncated content - When you need complete step-by-step procedures or tutorials - When you need troubleshooting sections, prerequisites, or detailed explanations - When search results reference a specific page that seems highly relevant - For comprehensive guides that require full context ## Usage Pattern Use this tool AFTER microsoft_docs_search when you identify specific high-value pages that need complete content. The search tool gives you an overview; this tool gives you the complete picture. ## URL Requirements - The URL must be a valid HTML documentation webpage from the microsoft.com domain - Binary files (PDF, DOCX, images, etc.) are not supported ## Output Format markdown with headings, code blocks, tables, and links preserved. | url*: string |
🛡️ セキュリティ評価・品質・コンテキスト監査
- No prompt-injection or hidden-character anomalies detected in tool descriptions
- Streamable HTTP primary endpoint (current 2025-03-26 transport)
- Public read-only-friendly endpoint — no credentials stored client-side
- Official first-party endpoint operated by the vendor
- Manually verified by RemoteMCP.net
🔐 OAuth 2.1 とセキュリティ
- 認証方式
- 認証不要
- 動的クライアント登録(DCR)
- —
- PKCE S256
- —
- 保護リソースメタデータ
- https://learn.microsoft.com/.well-known/oauth-protected-resource
📡 公式リモートエンドポイントとトランスポート
リモートエンドポイント https://learn.microsoft.com/api/mcp は Streamable HTTP(2025-03-26 仕様) を採用。Streamable HTTP は単一の POST エンドポイントで JSON-RPC の双方向通信を完結する現行推奨トランスポートで、npx mcp-remote ブリッジなしに Claude・Cursor・VS Code などへ URL だけでMCP接続できます。
接続前にエンドポイントを オンライン MCP Inspector に貼り付けて initialize / tools/list のハンドシェイクを確認することを推奨します。
🔐 認証・権限フロー
認証方式は 認証不要(公開) です。認証は一切不要。URL を貼るだけですぐに使えます。ドキュメント検索や公開データの参照に最適です。
🛡️ コンテキスト消費とセキュリティ監査
このサーバーには現在 3 個のツールが登録されており、定義の合計は約 971 トークン。リクエストごとにモデルのシステムプロンプトへ注入されます。セキュリティ評価は A+(公式運営ソース)。ツール名とスキーマが簡潔なほどコンテキストウィンドウへの「税」は低くなります。feecalculator.app で呼び出しあたりのコストも試算できます。
🧩 主要クライアントへのMCP接続
Microsoft Learn について、Cursor / Claude Code / VS Code / ChatGPT / Windsurf / Kiro / Codex / Cline / Gemini など 10 クライアント向けの設定を自動生成しています。ワンクリック deeplink、claude mcp add コマンド、JSON / TOML スニペットから選べます。代表的なツール:microsoft_docs_search、microsoft_code_sample_search、microsoft_docs_fetch など。
📖 Microsoft Learn の詳細
Microsoft Learn — Remote MCP Server
Microsoft's official Learn MCP server streams trusted, up-to-date documentation for Azure, .NET, Microsoft 365 and the full Microsoft technical catalog directly into agent context. The remote endpoint means there is nothing to install — point your MCP client at the URL and start calling tools right away. Microsoft operates and versions the server themselves, so tool coverage tracks their API surface as it ships.
Official Microsoft Learn Endpoint & Transport Architecture
- Endpoint URL:
https://learn.microsoft.com/api/mcp - Transport: Streamable HTTP
Streamable HTTP is the current MCP transport (2025-03-26 spec): a single URL accepts JSON-RPC POSTs and may stream responses over SSE, so one endpoint serves both simple and streaming workloads. Microsoft Learn does not publish a separate legacy SSE endpoint, so your client must speak Streamable HTTP.
Authentication, Scopes & Permission Boundaries
Microsoft Learn is public and unauthenticated — no OAuth, no API key, no headers. Any MCP client can connect and call its tools directly, which also makes it a great endpoint for smoke-testing your own MCP client or proxy.
All 3 cataloged tools are read-only — Microsoft Learn cannot mutate your account data, which makes it safe to connect broadly.
Common Troubleshooting & Connection Tips
- "Session expired" / stale
Mcp-Session-Id— just re-sendinitialize; stateless clients can ignore session headers entirely.
🚀 Microsoft Learn リモートMCPへの接続方法
- リモートエンドポイントを取得 — 公式エンドポイント https://learn.microsoft.com/api/mcp をコピーします。
- クライアント設定に追加 — Cursor の mcp.json / Claude Code CLI / 各クライアントに URLを追加します(下記クライアント別ガイド参照)。
- 認可して検証 — 設定を保存後、当サイトの Inspector で initialize と tools/list を実行して接続を確認します。
🔌 Microsoft Learn × クライアント別MCP接続ガイド
❓ よくある質問
Microsoft Learn のリモートMCPサーバーは公式ですか?
このエントリは「公式運営」と表示されています。エンドポイントは Microsoft 公式が運営しています。掲載エンドポイントはすべて実際の MCP initialize ハンドシェイクで検証済みです。
Claude / Cursor で Microsoft Learn にMCP接続するには?
リモートエンドポイント https://learn.microsoft.com/api/mcp をコピーします。Claude Code では claude mcp add --transport http microsoft-learn https://learn.microsoft.com/api/mcp を実行。Cursor ではワンクリック deeplink か ~/.cursor/mcp.json に { "mcpServers": { "microsoft-learn": { "url": "https://learn.microsoft.com/api/mcp" } } } を追加します。
接続時に 401 が返る/キーを要求される場合は?
このエンドポイントは認証不要です。401 が返る場合は URL の綴りを確認し、Inspector で再試行してください。
ローカル stdio MCP とリモート MCP の違いは?
ローカル MCP は npx / uvx で起動する stdio 子プロセスで、ローカルランタイムが必要で API キーを平文で設定ファイルに書きます。リモート MCP は Microsoft がホストする HTTPS エンドポイントで、インストール不要・OAuth 2.1 対応・同一 URL をデスクトップとモバイルで共用できます。詳しくは ローカル vs リモート MCP 比較 をご覧ください。