كشف خادم MCP موجود وإدارته

توضح هذه المقالة كيفية استخدام إدارة واجهة برمجة التطبيقات لعرض خادم بروتوكول سياق النموذج البعيد (MCP) الحالي وإدارته - خادم أدوات مستضاف خارج إدارة واجهة برمجة التطبيقات. عرض وإدارة أدوات الخادم من خلال إدارة واجهات برمجة التطبيقات بحيث يتمكن عملاء MCP من استدعاؤها باستخدام بروتوكول MCP.

تتضمن أمثلة السيناريوهات ما يلي:

خادم أدوات الوكيل LangChain أو LangServe من خلال إدارة واجهة برمجة التطبيقات مع مصادقة كل خادم وحدود المعدل.
عرض أدوات Azure Logic Apps بشكل آمن للمساعدين باستخدام تصفية IP وOAuth.
مركزية أدوات خادم MCP من Azure Functions وأوقات التشغيل مفتوحة المصدر في Azure API Center.
قم بتمكين GitHub Copilot أو Claude by Anthropec أو ChatGPT للتفاعل بأمان مع الأدوات عبر مؤسستك.

تدعم إدارة واجهة برمجة التطبيقات أيضا خوادم MCP المكشوفة أصلا في إدارة واجهة برمجة التطبيقات من واجهات برمجة تطبيقات REST المدارة. لمزيد من المعلومات، راجع عرض واجهة برمجة تطبيقات REST كخادم MCP.

تعرف على المزيد حول:

القيود

يجب أن يتوافق خادم MCP الخارجي مع إصدار 2025-06-18 MCP أو إصدار أحدث. يمكن للخادم دعم ما يلي:
- إما عدم وجود تفويض، أو بروتوكولات تفويض تلتزم بالمعايير التالية: https://modelcontextprotocol.io/specification/2025-06-18/basic/authorization#standards-compliance.
- أنواع نقل HTTP أو SSE القابلة للبث.
تدعم إدارة API حاليا أدوات خوادم MCP، لكنها لا تدعم موارد أو أوامر MCP.
إدارة واجهة برمجة التطبيقات حاليا لا تدعم قدرات خوادم MCP في مساحات العمل.

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

إذا لم يكن لديك بالفعل مثيل إدارة واجهة برمجة التطبيقات، فأكمل التشغيل السريع التالي: إنشاء مثيل Azure API Management. يجب أن يكون المثيل في أحد مستويات الخدمة التي تدعم خوادم MCP.
الوصول إلى خادم خارجي متوافق مع MCP (على سبيل المثال، مستضاف في Azure Logic Apps أو Azure Functions أو LangServe أو الأنظمة الأساسية الأخرى).
بيانات الاعتماد المناسبة لخادم MCP (مثل بيانات اعتماد عميل OAuth 2.0 أو مفاتيح واجهة برمجة التطبيقات، اعتمادا على الخادم) للوصول الآمن.
إذا قمت بتمكين تسجيل التشخيص عبر Application Insights أو Azure Monitor في النطاق العالمي (جميع واجهات برمجة التطبيقات) لمثيل إدارة واجهة برمجة التطبيقات الخاص بك، قم بتعيين إعداد عدد بايتات الحمولة إلى السجل لاستجابة الواجهة الأمامية إلى 0. يمنع هذا الإعداد تسجيل أجسام الاستجابة غير المقصود عبر جميع واجهات برمجة التطبيقات ويساعد في ضمان عمل خادم MCP بشكل صحيح. لتسجيل الحمولات بشكل انتقائي لواجهات برمجة تطبيقات معينة، قم بتكوين الإعداد بشكل فردي في نطاق واجهة برمجة التطبيقات، مما يسمح بالتحكم المستهدف في تسجيل الاستجابة.
لاختبار خادم MCP، استخدم Visual Studio Code مع إمكانية الوصول إلى GitHub Copilot أو أداة مثل MCP Inspector.

كشف خادم MCP موجود

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

في مدخل Microsoft Azure، انتقل إلى مثيل APIM.
في القائمة اليمنى، ضمن واجهات برمجة التطبيقات، حدد خوادم>MCP+ إنشاء خادم MCP.
حدد عرض خادم MCP موجود.
في خادم MCP الخلفي:
1. أدخل عنوان URL الأساسي الحالي لخادم MCP. على سبيل المثال، https://learn.microsoft.com/api/mcp لخادم Microsoft Learn MCP.
2. في نوع النقل، يتم اختيار HTTP القابل للبث بشكل افتراضي.
في خادم MCP الجديد:
1. أدخل اسما لخادم MCP في إدارة واجهات برمجة التطبيقات.
2. في المسار الأساسي، أدخل بادئة مسار للأدوات. على سبيل المثال، mytools
3. اختياريا، أدخل وصفا لخادم MCP.
حدد Create.

لقطة شاشة لإنشاء خادم MCP في المدخل.

يتم إنشاء خادم MCP ويتم عرض عمليات الخادم البعيد كأدوات.
يتم سرد خادم MCP في جزء خوادم MCP . يعرض عمود عنوان URL للخادم عنوان URL لخادم MCP للاستدعاء للاختبار أو داخل تطبيق عميل.

هام

حاليا، لا تعرض إدارة واجهة برمجة التطبيقات أدوات من خادم MCP الحالي. يجب عليك تسجيل وتكوين جميع الأدوات على خادم MCP البعيد الحالي.

تكوين النهج لخادم MCP

تكوين نهج APIM واحد أو أكثر للمساعدة في إدارة خادم MCP. تنطبق السياسات على جميع عمليات واجهة برمجة التطبيقات التي تعرض كأدوات في خادم MCP. استخدم هذه السياسات للتحكم في الوصول والمصادقة وغيرها من جوانب الأدوات.

تعرف على مزيد من المعلومات عن تكوين النهج:

أنذر

لا تصل إلى جسم الاستجابة باستخدام المتغير context.Response.Body داخل سياسات خادم MCP. يؤدي ذلك إلى تحفيز تخزين الاستجابة، مما يتداخل مع سلوك البث المطلوب من خوادم MCP وقد يسبب تعطلها.

لتكوين السياسات لخادم MCP، اتبع الخطوات التالية:

في مدخل Microsoft Azure، انتقل إلى مثيل APIM.
في القائمة اليمنى، ضمن واجهات برمجة التطبيقات، حدد خوادم MCP.
حدد خادم MCP من القائمة.
في القائمة اليسرى، ضمن MCP، حدد Policies.

في محرر النهج، أضف النهج التي تريد تطبيقها على أدوات خادم MCP أو قم بتحريرها. حدد السياسات بصيغة XML.

على سبيل المثال، يمكنك إضافة سياسة لتقييد المكالمات إلى أدوات خادم MCP (في هذا المثال، مكالمة واحدة لكل 60 ثانية في كل جلسة MCP).

<!-- Rate limit tool calls by Mcp-Session-Id header -->
<set-variable name="body" value="@(context.Request.Body.As<string>(preserveContent: true))" />
<choose>
    <when condition="@(
        Newtonsoft.Json.Linq.JObject.Parse((string)context.Variables["body"])["method"] != null 
        && Newtonsoft.Json.Linq.JObject.Parse((string)context.Variables["body"])["method"].ToString() == "tools/call"
    )">
    <rate-limit-by-key 
        calls="1" 
        renewal-period="60" 
        counter-key="@(
            context.Request.Headers.GetValueOrDefault("Mcp-Session-Id", "unknown")
        )" />
    </when>
</choose>

ملاحظة

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

التحقق من صحة خادم MCP واستخدامه

استخدم عامل LLM متوافق (مثل GitHub Copilot أو Semantic Kernel أو Copilot Studio) أو عميل اختبار (مثل curl) لاستدعاء نقطة نهاية MCP المستضافة من إدارة واجهة برمجة التطبيقات. تأكد من أن الطلب يتضمن رؤوس أو رموز مميزة مناسبة، وتأكد من التوجيه الناجح والاستجابة من خادم MCP.

بقشيش

إذا استخدمت مفتش MCP لاختبار خادم MCP يديره إدارة API، استخدم الإصدار 0.9.0.

إضافة خادم MCP في Visual Studio Code

في Visual Studio Code، استخدم دردشة GitHub Copilot في وضع العامل لإضافة خادم MCP واستخدام الأدوات. للحصول على خلفية حول خوادم MCP في Visual Studio Code، راجع استخدام خوادم MCP في VS Code.

لإضافة خادم MCP في Visual Studio Code:

استخدم الأمر MCP: إضافة خادم من لوحة الأوامر.
عند المطالبة، حدد نوع الخادم: HTTP (HTTP أو Server Sent Events).
أدخل عنوان URL للخادم لخادم MCP في إدارة واجهة برمجة التطبيقات. على سبيل المثال، https://<apim-service-name>.azure-api.net/<api-name>-mcp/mcp لنقطة نهاية MCP.
أدخل معرف الخادم الذي تختاره.
حدد ما إذا كنت تريد حفظ التكوين في إعدادات مساحة العمل أو إعدادات المستخدم.
- إعدادات مساحة العمل - يتم حفظ تكوين الخادم في .vscode/mcp.json ملف متوفر فقط في مساحة العمل الحالية.
- إعدادات المستخدم - تتم إضافة تكوين الخادم إلى الملف العمومي settings.json الخاص بك وهو متوفر في جميع مساحات العمل. يبدو التكوين مشابها لما يلي:

إضافة حقول إلى تكوين JSON لإعدادات مثل عنوان المصادقة. يوضح المثال التالي تكوين مفتاح اشتراك APIM الذي تم تمريره في رأس كما هو الحال في قيمة الإدخال. تعرف على المزيد حول تنسيق التكوين

لقطة شاشة لتكوين عنوان المصادقة لخادم MCP

استخدام الأدوات في وضع العامل

بعد إضافة خادم MCP في Visual Studio Code، يمكنك استخدام الأدوات في وضع الوكيل.

في GitHub Copilot chat، حدد Agent mode وحدد الزر Tools لمشاهدة الأدوات المتوفرة.
حدد واحدة أو أكثر من الأدوات من خادم MCP لتكون متوفرة في الدردشة.
أدخل مطالبة في الدردشة لاستدعاء الأداة. على سبيل المثال، إذا حددت أداة للحصول على معلومات حول طلب، يمكنك سؤال العامل عن طلب.
```
Get information for order 2
```
حدد متابعة لمشاهدة النتائج. يستخدم العامل الأداة لاستدعاء خادم MCP وإرجاع النتائج في الدردشة.

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

مشكلة	السبب	Solution
`401 Unauthorized` خطأ من الواجهة الخلفية	لم تتم إعادة توجيه رأس التفويض	إذا لزم الأمر، استخدم `set-header` السياسة لإرفاق الرمز يدويا
يعمل استدعاء واجهة برمجة التطبيقات في إدارة واجهة برمجة التطبيقات ولكنه يفشل في العامل	عنوان URL الأساسي غير صحيح أو رمز مميز مفقود	التحقق مرة أخرى من سياسات الأمان ونقطة النهاية
يفشل دفق خادم MCP عند تمكين سجلات التشخيص	يتداخل تسجيل نص الاستجابة أو الوصول إلى نص الاستجابة من خلال السياسة مع نقل MCP	تعطيل تسجيل نص الاستجابة في نطاق جميع واجهات برمجة التطبيقات - راجع المتطلبات الأساسية

الملاحظات

هل كانت هذه الصفحة مفيدة؟

Last updated on 2025-11-13