Get started مع Foundry MCP Server (معاينة) باستخدام Visual Studio Code

خادم Foundry MCP (المعاينة) هو تنفيذ مستضاف سحابيا لبروتوكول سياق النموذج (MCP). يعرض أدوات مختارة تسمح لوكلائك بأداء عمليات القراءة والكتابة ضد خدمات Foundry دون استدعاء واجهات برمجة التطبيقات الخلفية مباشرة. لا تحتاج إلى نشر البنية التحتية — فالخادم يوفر نقطة نهاية آمنة وقابلة للتوسع مع مصادقة مدمجة عبر Microsoft Entra ID.

استخدم عميلا متوافقا مع MCP مثل Visual Studio Code للاتصال بنقطة النهاية العامة، والتحقق باستخدام معرف إنترا، والسماح للنماذج الكبيرة الكبيرة access الأدوات. بعد الاتصال، يمكنك إنشاء وكلاء يستدعيون هذه الأدوات باستخدام مطالبات اللغة الطبيعية.

في هذه المقالة، ستتعرف على كيفية:

• اتصل بخادم Foundry MCP باستخدام GitHub Copilot في Visual Studio Code
• تشغيل الأوامر لاختبار أدوات Foundry MCP Server والتفاعل مع موارد Azure

يستغرق هذا الدليل حوالي 5 دقائق لإكماله.

‏‫ملاحظة‬

تُعد هذه الميزة قيد الإصدار الأولي العام في الوقت الحالي. يتم توفير هذه المعاينة دون اتفاقية على مستوى الخدمة، ولا نوصي بها لأحمال عمل الإنتاج. بعض الميزات ربما لا تكون مدعمة أو بها بعض القدرات المقيدة. لمزيد من المعلومات، راجع شروط الاستخدام الإضافية لمعاينات مايكروسوفت Azure.

المتطلبات المسبقه

• حساب Azure مع اشتراك نشط. إذا لم يكن لديك واحد، أنشئ حسابا Azure مجانيا.
• مشروع مسبك. إذا لم يكن لديك project، أنشئ واحدا باستخدام Microsoft Foundry SDK Quickstart.
• Visual Studio Code (الإصدار 1.99 أو أحدث).
• اشتراك GitHub Copilot (فردي، عمل، أو مؤسسة).
• GitHub Copilot Visual Studio امتداد الكود.
• مساهم أو دور أعلى في project Foundry الذي تريد الوصول إليه access.

تثبيت وتشغيل خادم Foundry MCP

اختر خيارا لتثبيت Foundry MCP Server في Visual Studio Code.

ملف تعريف المستخدم

قم بتثبيت Foundry MCP Server في ملف المستخدم الخاص بك بحيث يكون متاحا لجميع مساحات العمل في Visual Studio Code.

1. افتح لوحة الأوامر (Ctrl+Shift+P).

2. ابحث عن MCP: إضافة الخادم.

3. اختر خيار HTTP (HTTP أو Server-Sent Events).

4. أدخل https://mcp.ai.azure.com كرابط.

5. أدخل اسما ودودا مثل foundry-mcp-remote، ثم اضغط Enter. يضيف Visual Studio Code الإدخال التالي للخادم تحت ملف المستخدم الخاص بك:

   { 
     "servers": { 
       "foundry-mcp-remote": { 
         "type": "http", 
         "url": "https://mcp.ai.azure.com" 
       } 
     } 
   }
   

6. افتح لوحة الأوامر (Ctrl+Shift+P).

7. ابحث عن خوادم قوائم MCP واخترها.

8. اختر خادم Foundry MCP الذي أضفته واختر Start Server.

9. يظهر مؤشر أخضر بجانب اسم الخادم في MCP: List Servers، مما يؤكد أن الاتصال نشط.

10. عند الطلب، سجل الدخول إلى Azure حتى يتمكن خادم MCP من التفاعل مع الخدمات في اشتراكك.

11. افتح GitHub Copilot واختر <وضع الوكيل >.

12. حدد أيقونة الأدوات ، وابحث عن Foundry لتصفية القائمة ، وتأكد من ظهور الخادم.

    

    تعرف أكثر على وضع الوكيل في وثائق Visual Studio Code.

تثبيت مساحة العمل

تثبيت خادم Foundry MCP لمساحة عمل محددة لتوحيده بذلك المجلد:

1. افتح مجلد فارغ أو مجلد project موجود في Visual Studio Code.

2. في جذر المجلد، قم بإنشاء .vscode مجلد إذا لم يكن موجودا.

3. داخل المجلد .vscode ، قم بإنشاء ملف باسم mcp.json، وأضف JSON التالي.

   { 
     "servers": { 
       "foundry-mcp-remote": { 
         "type": "http", 
         "url": "https://mcp.ai.azure.com" 
       } 
     } 
   }
   

4. احفظ التغييرات في mcp.json.

5. حدد الزر ابدأ أعلى إدخال الخادم الجديد.

6. يظهر مؤشر أخضر بجانب اسم الخادم، يؤكد أن الاتصال نشط.

7. عند المطالبة، سجل الدخول حتى يتمكن خادم MCP من التفاعل مع الخدمات في اشتراكك.

8. افتح GitHub Copilot واختر وضع الوكيل.

9. حدد أيقونة الأدوات ، وابحث عن Foundry لتصفية النتائج ، وتأكد من ظهور الخادم.

   

   لمعرفة المزيد عن وضع الوكيل، قم بزيارة Visual Studio codedocumentation.

استخدم المحفزات لاختبار خادم Foundry MCP

1. افتح لوحة الدردشة GitHub Copilot وتأكد من >اختيار <وضع الوكيل.

2. أدخل رسالة تستخدم أدوات Foundry MCP Server — على سبيل المثال : حدثني عن أحدث النماذج على Foundry.

3. يطلب Copilot الإذن لتشغيل تشغيل خادم MCP الخاص ب Foundry المطلوبة. حدد متابعة أو استخدم السهم لاختيار سلوك أكثر تحديدا:

   • Current session يشغل العملية دائما في جلسة وضع وكيل Copilot الحالية GitHub.
   • Current workspace يشغل دائما الأمر الخاص بمساحة عمل كود Visual Studio الحالية.
   • Always alow يضبط العملية لتعمل دائما لأي جلسة GitHub وضع وكيل Copilot أو أي مساحة عمل Visual Studio Code.

   

   الرد يشبه المخرجات المختصرة التالية. تختلف نتائجك الفعلية حسب توفر النموذج الحالي.

   Latest / Notable Foundry Models (Preview Snapshot)
   
   1. Frontier & Reasoning Models
   gpt-4o (2024-11-20) – Flagship multimodal model; strong multi-turn coherence.
   o3 (2025-04-16) – Balanced reasoning with good accuracy/quality trade-off.
   o4-mini (2025-04-16) – Strong quality with better latency than o3.
   Phi-4 – Microsoft small frontier open model; competitive quality at lower cost.
   
   // Further output omitted
   

4. استكشف واختبر عمليات خادم Foundry MCP باستخدام محفزات أخرى، مثل:

   What tools can I use from Foundry MCP Server (preview)?
   Tell me about the latest models on Foundry
   Show me details about the GPT-4o model on Foundry
   

استكشاف الأخطاء وإصلاحها

مشكلة	الحل
الخادم لا يبدأ	تحقق من إدخال الرابط https://mcp.ai.azure.com بشكل صحيح. افتح لوحة الأوامر وشغل MCP: List Servers للتحقق من حالة الخادم.
لا يظهر طلب المصادقة	تأكد من تثبيت إضافة GitHub Copilot وأنك مسجلة الدخول إلى Visual Studio Code بحساب مايكروسوفت لديه access إلى اشتراكك في Azure.
أدوات Foundry لا تظهر في وضع الوكيل	تأكد من أن الخادم يعمل (مؤشر أخضر في MCP: List Servers). تحقق من أنك اخترت وضع الوكيل في لوحة دردشة Copilot، ثم اختر أيقونة الأدوات وابحث عن Foundry.
"Access مرفوض" أو أخطاء في الأذونات	تحقق من أن لديك دور مساهم أو أعلى في project Foundry. يستخدم الخادم تدفق On-Behalf-Of مع بيانات اعتماد Entra ID الخاصة بك.

تنظيف الموارد

لإزالة تكوين الخادم:

• ملف المستخدم: افتح لوحة الأوامر، شغل MCP: خوادم القوائم، اختر خادم Foundry، واختر إزالة الخادم.
• Workspace: احذف إدخال الخادم من ملف .vscode/mcp.json في مجلد project الخاص بك.

المحتوى ذو الصلة

أدوات خادم Foundry MCP وأمثلة على التوجيه

• أمن خادم Foundry MCP وأفضل الممارسات
• أدوات خادم Foundry MCP وأمثلة على التوجيه