ربط Microsoft Copilot Studio بـ Performance Hub
في هذه الصفحة
التعليمات محدّثة حتى 17 يونيو 2026 (بتوقيت AEST). يتغير دعم MCP لدى المورّدين باستمرار - تحقّق من المصادر المرتبطة إذا بدا لك شيء مختلفًا.
يدعم Microsoft Copilot Studio إضافة خوادم MCP موجودة إلى الوكلاء من خلال معالج إعداد MCP أو من خلال موصّل مخصص في Power Platform.
خادم MCP الخاص بـ Performance Hub:
https://app.performancehub.co/mcp
المتطلبات
- وكيل في Copilot Studio مع تفعيل التنسيق التوليدي.
- صلاحية إضافة أدوات/إجراءات إلى الوكيل.
- مفتاح MCP من Performance Hub، أو إعداد OAuth يعمل.
يدعم Copilot Studio بروتوكول MCP عبر النقل Streamable. وتذكر Microsoft أن النقل SSE مُهمل ولم يعد مدعومًا في MCP ضمن Copilot Studio بعد أغسطس 2025.
طريقة المصادقة الموصى بها: ترويسة مفتاح API
استخدم معالج إعداد MCP واختر المصادقة بمفتاح API:
| الحقل | القيمة |
|---|---|
| عنوان URL للخادم | https://app.performancehub.co/mcp |
| نوع المصادقة | مفتاح API |
| موقع مفتاح API | الترويسة (Header) |
| اسم الترويسة | x-mcp-api-key |
| قيمة الترويسة | مفتاح MCP الخاص بك phk_... |
يتوافق ذلك مع دعم Performance Hub الموثّق للترويسة x-mcp-api-key، ويتجنب أي التباس حول ما إذا كان Copilot Studio يضيف البادئة Bearer في المصادقة بمفتاح API.
خيار OAuth
يوثّق Copilot Studio أيضًا خيارات OAuth 2.0، بما في ذلك الاكتشاف الديناميكي والتهيئة اليدوية لـ OAuth.
لا تستخدم OAuth إلا بعد اختبار تدفق OAuth الخاص بـ Performance Hub في مستأجر Copilot Studio لديك. تتوفر بيانات OAuth الوصفية الخاصة بـ MCP على العنوان التالي:
https://app.performancehub.co/mcp/.well-known/oauth-protected-resource
https://app.performancehub.co/mcp/.well-known/oauth-authorization-server
إضافة الأدوات إلى الوكيل
بعد ربط الخادم، يُفترض أن يكتشف Copilot Studio الأدوات المتاحة لحساب Performance Hub الذي تمت مصادقته. أضف الأدوات/الإجراءات المطلوبة إلى الوكيل واختبرها في Copilot Studio.
الحوكمة
يخضع الوصول إلى MCP في Copilot Studio للحوكمة من خلال موصّلات Power Platform وسياسات البيانات. تأكّد من أن سياسات المستأجر لديك تسمح بخادم MCP الخاص بـ Performance Hub قبل نشر الوكيل.
توصية بتعليمات الأمان
أضف التعليمات التالية إلى وكيل Copilot Studio:
Use Performance Hub MCP tools only for Performance Hub questions. Confirm with the user before changing device state, door/access settings, user access, display programs, orders, or running actions across multiple facilities. Use read/list tools before action tools.
المصادر
- توسيع وكيل باستخدام MCP: https://learn.microsoft.com/en-us/microsoft-copilot-studio/agent-extend-action-mcp
- إضافة خادم MCP موجود إلى وكيل: https://learn.microsoft.com/en-us/microsoft-copilot-studio/mcp-add-existing-server-to-agent
- Performance Hub MCP: https://app.performancehub.co/mcp