إنشاء مفتاح MCP

مفتاح MCP هو مفتاح API شخصي يتيح لعميل ذكاء اصطناعي خارجي - مثل OpenAI Agent Builder أو Cursor أو Claude Desktop - الاتصال بـ Performance Hub عبر خادم MCP الخاص به. تنشئ هذه المفاتيح وتديرها بنفسك من خيارات المستخدم؛ وكل مفتاح ينتمي إلى حسابك ويرث صلاحيات الوصول الخاصة بك.

قبل أن تبدأ

مفاتيح MCP مرتبطة بحساب المستخدم الخاص بك، وليس بمنشأة واحدة - إذ يحمل المفتاح أي صلاحيات وصول يملكها حسابك بالفعل.
تُعرض القيمة السرية للمفتاح الجديد مرة واحدة فقط، عند الإنشاء. جهّز مكاناً آمناً لتخزينه (مدير كلمات مرور أو إعدادات عميل MCP لديك).
ستحتاج إلى أمرين لتهيئة عميل MCP: عنوان URL للخادم و مفتاح نشط. كلاهما متاح في مربع الحوار نفسه.

افتح مدير مفاتيح MCP

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

انقر على أيقونة الملف الشخصي في أعلى يمين شريط الأدوات لفتح قائمة الحساب، ثم اختر خيارات المستخدم.

قائمة الحساب مع خيارات المستخدم — الشكل 1: قائمة الحساب - افتح خيارات المستخدم

افتح API & MCP Keys

في خيارات المستخدم ، انقر على مفاتيح API وMCP.

مربع الحوار خيارات المستخدم — الشكل 2: خيارات المستخدم - يفتح الزر API & MCP Keys مدير المفاتيح

راجع مربع الحوار Manage MCP Keys

يُفتح مربع الحوار إدارة مفاتيح MCP ، ويوفر رأسه ثلاثة إجراءات - إنشاء مفتاح, عرض وثائق MCP، و تنزيل CSV (متاح بعد إنشاء مفتاحك الأول). عندما يكون لديك مفتاح واحد على الأقل، يظهر تهيئة خادم MCP في الأعلى مع عنوان URL للخادم وتذكيراً باستخدام أي مفتاح نشط كمفتاح API.

إنشاء مفتاح

بدء مفتاح جديد

انقر على إنشاء مفتاح. يظهر نموذج مضمّن صغير يحتوي على حقل واحد التسمية .

امنحه تسمية

أدخل التسمية يصف مكان استخدام المفتاح - على سبيل المثال OpenAI AgentKit. التسمية لمرجعك الخاص فقط؛ ويمكنك إعادة تسميتها لاحقاً. انقر على إنشاء (أو إلغاء لإغلاق النموذج).

نموذج مضمّن لإنشاء مفتاح — الشكل 4: نموذج الإنشاء المضمّن - امنح المفتاح تسمية وصفية

انسخ المفتاح الآن

يُنشأ المفتاح فوراً ويُعرض في مفتاح MCP جديد (يُعرض مرة واحدة) في أعلى القائمة. من هنا يمكنك نسخ قيمة المفتاح إلى الحافظة، أو استخدم CSV لتنزيله وحفظه بأمان. بمجرد إغلاق مربع الحوار أو تحديثه، لا يمكن استرداد القيمة الكاملة - بل تُعرض فقط معاينة محجوبة (مثل phk_7Qm2…Xa9LkP) بعد ذلك.

يُعرض المفتاح الجديد مرة واحدة — الشكل 5: المفتاح الذي تم إنشاؤه حديثاً - انسخ السر أو نزّله الآن، فلن يُعرض مرة أخرى

الأمان: تعامل مع مفتاح MCP ككلمة مرور. لا تلصقه في مستندات مشتركة أو لقطات شاشة أو محادثات. إذا تعرض المفتاح للكشف في أي وقت، ألغِ تنشيطه فوراً (واحذفه) وأنشئ بديلاً.

ربط عميل MCP

استخدم التفاصيل من تهيئة خادم MCP لإعداد عميل الذكاء الاصطناعي:

الحقل	مكان العثور عليه	ملاحظات
عنوان URL للخادم	أعلى مربع الحوار Manage MCP Keys	انقر على Copy لنسخه. هذا هو العنوان الذي يتصل به عميل MCP لديك.
مفتاح API	أي مفتاح نشط في القائمة	استخدم القيمة السرية التي نسختها أو نزّلتها عند إنشاء المفتاح.

للاطلاع على مقتطفات التثبيت الخاصة بكل عميل (Cursor وClaude Desktop وغيرها)، راجع الإعداد والتكامل.

إدارة المفاتيح الموجودة

يعرض كل مفتاح في القائمة معرّفه المحجوب وشارة الحالة و التسمية، و تاريخ الإنشاء (و، في حال استخدامه، آخر استخدام)، إلى جانب عناصر التحكم في دورة الحياة.

عناصر التحكم في إدارة المفاتيح — الشكل 6: عناصر التحكم في دورة حياة المفتاح - إعادة التسمية أو إلغاء التنشيط أو إعادة التنشيط أو الحذف

حالات المفاتيح

الحالة	المعنى
نشط	المفتاح يعمل ويمكنه مصادقة طلبات MCP.
غير نشط	المفتاح معطّل وسيُرفض. يمكن إعادة تنشيطه أو حذفه نهائياً.

الإجراءات المتاحة

الإجراء	وقت عرضه	الوظيفة
التسمية (حقل التعديل)	دائماً	أعد تسمية المفتاح مباشرةً. تؤكد علامة اختيار خضراء Changes Saved.
إلغاء التنشيط	المفاتيح النشطة	يعطّل المفتاح فوراً، وسيتوقف عن العمل أي عميل MCP يستخدمه.
إعادة التنشيط	المفاتيح غير النشطة	يعيد تمكين مفتاح تم تعطيله سابقاً.
حذف	المفاتيح غير النشطة فقط	يزيل المفتاح نهائياً. يجب إلغاء تنشيط المفتاح قبل حذفه، ولا يمكن التراجع عن ذلك.
تنزيل CSV	العنوان، مرة واحدة بعد إنشاء المفتاح الأول	يصدّر قائمة مفاتيحك (المعرّفات والتسميات والحالة والطوابع الزمنية) كملف CSV.

لإيقاف مفتاح عن الاستخدام بأمان: إلغاء التنشيط أولاً (يؤدي ذلك إلى حظر أي عميل لا يزال يستخدمه فوراً)، وتأكد من عدم تعطل أي شيء، ثم حذف إذا لم تعد بحاجة إليه.

التالي: إعداد العميل ودمجه