Microsoft Learn MCP

لماذا تستخدمه

الميزات الأساسية

MCP بعيد — لا تثبيت، فقط أشِر mcp-remote إلى URL
يغطي Azure و.NET وM365 وPower Platform وWindows وVisual Studio
نماذج الكود مُضمَّنة في النتائج عند توفرها
روابط استشهاد تعود إلى learn.microsoft.com
محدَّث دائماً — لا انجراف من لقطة مُضمَّنة
مجاني، لا يحتاج API key

عرض مباشر

كيف يبدو في الممارسة

microsoft-learn-mcp.replay ▶ جاهز

0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "microsoft-learn-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://learn.microsoft.com/api/mcp"
      ]
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "microsoft-learn-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://learn.microsoft.com/api/mcp"
      ]
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "microsoft-learn-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://learn.microsoft.com/api/mcp"
      ]
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "microsoft-learn-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://learn.microsoft.com/api/mcp"
      ]
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "microsoft-learn-mcp",
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://learn.microsoft.com/api/mcp"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json

{
  "context_servers": {
    "microsoft-learn-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "https://learn.microsoft.com/api/mcp"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add microsoft-learn-mcp -- npx -y mcp-remote https://learn.microsoft.com/api/mcp

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: Microsoft Learn MCP

تنفيذ نمط Azure resource من الوثائق الحالية

👤 مهندسو السحابة على Azure ⏱ ~20 min intermediate

متى تستخدمه: Claude يستمر في كتابة Bicep/Terraform بأسماء خصائص مُهمَلة؛ تريده يستخدم API الحالي.

الخطوات

البحث في الوثيقة

Microsoft Learn MCP: search 'Azure Container Apps managed identity'. Pull the current docs.✓ تم النسخ

→ البحث يُعيد صفحات Learn مع روابط URL
الجلب والاقتباس

Get the section on assigning a user-assigned identity. Quote the current Bicep schema, don't paraphrase.✓ تم النسخ

→ مقتطف Bicep دقيق مع أسماء الخصائص
التطبيق

Now write the Bicep for my container app to use an existing identity id-prod-app. Match the schema you quoted.✓ تم النسخ

→ Bicep يتجمَّع مع Microsoft.App API الحالي

النتيجة: Bicep يُنشر بنجاح أول مرة لأن المخطط يطابق API Azure الحالي.

المزالق

الوثيقة التي ظهرت في البحث خاصة بإصدار API أقدم — تحقق دائماً من أن URL يحتوي 'latest' أو api-version الصحيح

اجمعها مع: filesystem · github

البحث عن .NET API بدون مغادرة Claude

👤 مطورو C# / .NET ⏱ ~10 min beginner

متى تستخدمه: تحتاج التوقيع الدقيق لـ System.Threading.Channels.Channel.CreateBounded.

الخطوات

البحث

Microsoft Learn: signature for Channel.CreateBounded in .NET 9.✓ تم النسخ

→ صفحة مرجع API مع overloads
الاستخدام

Write a producer/consumer using BoundedChannelOptions with capacity 100, FullMode=Wait. Match the docs exactly.✓ تم النسخ

→ الكود يطابق سطح API الحالي

النتيجة: كود C# صحيح دون التبديل إلى الوثائق.

المزالق

الخلط بين وثائق .NET Framework و.NET (Core) — حدِّد الإصدار دائماً؛ Learn يُعيد كليهما

كتابة PowerShell script لـ Microsoft Graph مع استشهادات

👤 مديرو M365 ⏱ ~25 min intermediate

متى تستخدمه: تريد تحديث تراخيص مجمَّعة وتحتاج صياغة cmdlet Graph الحالية.

الخطوات

إيجاد الـ cmdlet

Learn: current syntax for Set-MgUserLicense in Microsoft.Graph PowerShell SDK.✓ تم النسخ

→ وثائق cmdlet مع مجموعة المعاملات
تأليف الـ script

Write a script that reads users.csv (UPN, SkuPartNumber) and assigns the license. Cite the Learn URLs you used.✓ تم النسخ

→ PowerShell يعمل مع استشهادات في comment-block

النتيجة: script قابل للتدقيق مع استشهادات للمراجعة.

المزالق

صياغة وحدة AzureAD القديمة — AzureAD مُهمَلة؛ أصِرَّ على Microsoft.Graph في prompt

اجمعها مع: filesystem

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

microsoft-learn-mcp + github

إيجاد نمط Azure حالي في Learn ثم PR لتغيير IaC

Learn: pull Container Apps + identity. GitHub: open a PR updating my Bicep.✓ تم النسخ

microsoft-learn-mcp + filesystem

حفظ المقتطفات المستشهد بها كـ runbook

Pull the M365 license cmdlet docs and save a runbook to /runbooks/m365-license.md with citations.✓ تم النسخ

microsoft-learn-mcp + context7

مقارنة وثائق Microsoft مع وثائق المكتبات الأوسع

Compare Microsoft Learn's recommended pattern with what context7 says for the same SDK.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداة	المدخلات	متى تستدعيها	التكلفة
microsoft_docs_search	query: str	الخطوة الأولى	free
microsoft_docs_fetch	url: str	جلب صفحة محددة	free

التكلفة والحدود

تكلفة التشغيل

حصة API: تستضيفه Microsoft؛ استخدام معقول لكل IP
الرموز لكل استدعاء: 300–5000
التكلفة المالية: مجاني
نصيحة: ابحث أولاً، جلب أعلى 1–2 روابط أكثر صلة فقط

الأمان

الصلاحيات والأسرار ونطاق الأثر

تخزين بيانات الاعتماد: لا شيء — وثائق عامة

نقل البيانات الخارجي: learn.microsoft.com

استعلام البحث يُرسَل إلى Microsoft — لا تضمِّن تفاصيل حساسة إذا كانت سياسة مؤسستك تمنع ذلك

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

Result page is for old API version

أضف 'api-version=YYYY-MM' أو إصدار .NET إلى الاستعلام

Search returns marketing pages

أضف 'docs' أو 'reference' إلى الاستعلام؛ فلتر بـ URL يحتوي '/dotnet/api/' أو '/azure/'

mcp-remote connection refused

تحقق من الشبكة؛ نقطة النهاية هي https://learn.microsoft.com/api/mcp

تحقق: curl -I https://learn.microsoft.com/api/mcp

البدائل