مشاركة عبر


تسجيل خوادم MCP المستضافة في Azure Functions في Azure API Center

بعد استضافة خادم MCP الخاص بك عن بعد على Azure Functions، قم بتسجيله في Azure API Center. يحافظ Azure API Center على مخزون (أو سجل) لخوادم MCP البعيدة بحيث يمكن اكتشافها بسهولة عبر مؤسستك. تظهر جميع خوادم MCP المسجلة في بوابة مركز API للفرق في مؤسستك.

بوابة مركز API تعرض خوادم MCP

تلميح

يصبح اسم مركز واجهة برمجة التطبيقات اسم كتالوج الأدوات الخاصة بك في عامل تصفية التسجيل. اختر اسما إعلاميا يساعد المستخدمين على تحديد كتالوج أدوات مؤسستك.

إنشاء الموارد

  1. سجل الدخول إلى بوابة Azure، ثم أنشئ مورد Azure API Center إذا لم يكن لديك واحد بالفعل.

  2. أنشئ بيئة في مورد مركز واجهة برمجة التطبيقات الخاص بك. لنوع الخادم>، اختر Azure Functions.

خادم MCP الخاص بالتسجيل

قم بتسجيل خادم MCP البعيد عن طريق إضافته كواجهة برمجة تطبيقات:

  1. في لوحة التنقل اليسرى لمورد مركز API، اختر واجهات برمجة التطبيقات (APIs).

  2. اختر + تسجيل واجهة برمجة تطبيقات (API). يوفر الجدول التالي أمثلة على القيم للإعدادات المطلوبة. يمكنك أيضا ملء الإعدادات الاختيارية مثل وصف خادم MCP، المستودع، الوثائق الخارجية، ومعلومات أخرى معروضة في بوابة مركز API.

    الإعداد Value
    عنوان واجهة برمجة التطبيقات أدخل اسما وصيا لخادم MCP، مثل Weather MCP Server.
    تعريف يتم توليد هذه القيمة تلقائيا بناء على عنوان واجهة برمجة التطبيقات، لكن يمكنك تعديلها.
    نوع واجهة برمجة التطبيقات MCP
    عنوان URL لوقت التشغيل هنا يأتي دور نقطة نهاية خادم MCP، مثل https://contoso.azurewebsites.net/mcp
    Environment اختر البيئة التي أنشأتها سابقا.
    عنوان الإصدار أدخل عنوان النسخة التي تختارها، مثل v1.
    تعريف الإصدار بعد إدخال العنوان السابق، يقوم Azure API Center بإنشاء هذا المعرف، والذي يمكنك تجاوزه.
    دورة حياة الإصدار اختر القيمة الأنسب من القائمة المنسدلة، مثل الاختبار أو الإنتاج.
  3. حدد إنشَاء.

    يجب أن ترى الآن خادم MCP مسجلا كواجهة برمجة تطبيقات في القائمة.

تحديث تعريف الخادم

  1. إنشاء تعريف API لخادم MCP بعيد بصيغة OpenAPI 3.0. تحتاج إلى هذا التعريف حتى تظهر بوابة API Center نقطة نهاية رابط خادم MCP. احفظ التعريف حيث يمكنك الوصول إليه. عليك رفعه في الخطوة التالية.

    مثال على تعريف واجهة برمجة التطبيقات OpenAPI 3.0 لخادم MCP:

    {
        "openapi": "3.0.0",
        "info": {
            "title": "Weather MCP server",
            "description": "MCP server with tools returning weather forecast and alerts.",
            "version": "1.0"
        },
        "servers": [
            {
                "url": "https://my-mcp-server.azurewebsites.net/mcp"
            }
        ]
    }
    
  2. تحديث تعريف الخادم:

    أ. في القائمة اليسرى، ابحث عن الأصول -> واجهات برمجة التطبيقات (APIs).

    ب. اختر اسم خادم MCP لفتح التسجيل.

    ج. في القائمة اليسرى، ابحث عن التفاصيل -> الإصدارات.

    د. تحت "الإصدار"، ابحث عن "v1" ووسع. ثم اختر التعريف القابل للبث ل... لفتح التعريف.

    د. حدد استبدال.

    هـ- في اللوحة الجانبية التي تفتح، غير "نسخة المواصفة" إلى 3.0، ثم قم برفع التعريف من الخطوة الأخيرة.

    و- حدد استبدال.

إعداد بوابة API Center

  1. قم بإعداد البوابة إذا لم يكن لديك واحدة بالفعل.

  2. بمجرد إعداد البوابة، يمكنك الوصول إليها عند https://<service-name>.portal.<location>.azure-apicenter.ms. استبدل <service-name> وباسم <location> مركز واجهة برمجة التطبيقات الخاصة بك والموقع الذي نشرته فيه. تحتاج إلى تسجيل الدخول لرؤية خوادم MCP المسجلة.

  3. عند اختيار اسم خادم، يفتح لوح يعرض معلومات بناء على البيانات التي تقدمها أثناء تسجيل الخادم وتعريف واجهة برمجة التطبيقات التي تم رفعها. يمكن للمستخدمين الذين لديهم وصول إلى البوابة الاتصال بالخوادم التي يختارونها عن طريق نسخ رابط نقطة النهاية أو التثبيت في تكامل كود Visual Studio.

    معلومات الخادم في بوابة مركز API

حول خوادم MCP في Azure API Management