الجمعة السوداء تبدأ مبكرًا: وفّر 50% على Pro.استكشف الخطط

ربط Skillry MCP في Codex

يحتفظ Codex بخوادم MCP في ~/.codex/config.toml، وتقرأ واجهة Codex لسطر الأوامر وتطبيق ChatGPT لسطح المكتب وامتداد بيئة التطوير الملف نفسه. أضف Skillry مرة واحدة باستخدام codex mcp add أو عبر إعدادات التطبيق أو بتحرير الملف.

لمن؟
مستخدمو Codex
الوقت
4 دقائق للإكمال
تم التحقق
التوثيق الرسمي، 28 أكتوبر 2026

الإجابة المختصرة

  1. 1شغّل codex mcp add skillry -- npx --yes skillry-cli@latest mcp مرة واحدة؛ وعلى Windows، استخدم cmd /c لتغليف أمر التشغيل.
  2. 2تحقّق باستخدام codex mcp list، أو اكتب /mcp في واجهة Codex النصية.
  3. 3يتشارك تطبيق ChatGPT لسطح المكتب وامتداد بيئة التطوير الإدخال: اضبطه مرة واحدة واستخدمه في الثلاثة.

قبل البدء

رُوجع بالرجوع إلى التوثيق الرسمي في 28 أكتوبر 2026. لم يُجرَّب بعد على تثبيت فعلي لهذا العميل؛ إذا اختلفت خطوة على جهازك، فاستخدم الإبلاغ عن مشكلة في الأسفل.

  • Codex مسجّل الدخول: واجهة سطر الأوامر، أو تطبيق ChatGPT لسطح المكتب مع Codex، أو امتداد بيئة التطوير. تتشارك جميعها إعدادًا واحدًا.
  • Node.js 22 أو أحدث (node --version). يشغّل Codex الخادم باستخدام npx.
  • يعمل أيضًا ملف .codex/config.toml على مستوى المشروع، لكن فقط في المشاريع التي علّمتها موثوقة. يستخدم هذا الدليل الملف العام.

إضافة Skillry إلى Codex

الأسرع عند استخدام Codex CLI
  1. 1

    شغّل هذا في أي طرفية:

    macOS وLinux
    codex mcp add skillry -- npx --yes skillry-cli@latest mcp

    يُفترض أن ترى: لا يظهر خطأ، وأصبح codex mcp list يتضمن skillry.

  2. 2

    على Windows، شغّل هذا بدلًا منه حتى يستطيع Windows بدء npx:

    Windows ‏(PowerShell أو Command Prompt)
    codex mcp add skillry -- cmd /c npx --yes skillry-cli@latest mcp
  3. 3

    ابدأ Codex مجددًا، أو أعِد تشغيل التطبيق أو الامتداد إذا كان مفتوحًا.

    يُفترض أن ترى: skillry في قائمة /mcp داخل Codex.

تحقّق من اتصال Codex

  1. 1

    في الطرفية، اعرض الخوادم المُعدّة:

    الطرفية
    codex mcp list

    يُفترض أن ترى: skillry مع أمر npx الذي أدخلته.

  2. 2

    في واجهة Codex النصية، اكتب /mcp.

    يُفترض أن ترى: skillry ضمن الخوادم النشطة، مع أدواتها.

التفويض عند التثبيت

يتحقق التثبيت من حسابك في Skillry. لا تكتب كلمة مرور أو تلصق مفتاحًا داخل الوكيل: في المرة الأولى، يفتح صفحة في متصفحك لتوافق هناك.

  1. 1

    اطلب من Codex تثبيت المهارة التي اخترتها، مثلًا: ثبّتها لهذا المشروع.

    يُفترض أن ترى: يخبرك الوكيل بأنه يحتاج إلى ربط حسابك ويفتح متصفحك. وقد يعرض العميل الطرفي الرابط بدلًا من فتحه؛ افتحه بنفسك.

  2. 2

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

    يُفترض أن ترى: تمت الموافقة على التفويض، مع تنبيه للعودة إلى وكيلك. يلاحظ الوكيل ذلك خلال بضع ثوانٍ ويكمل التثبيت.

تستمر الموافقة 7 أيام وتُحفَظ في مخزن مفاتيح نظام التشغيل: Keychain على macOS، وCredential Manager على Windows، وGNOME Keyring أو KWallet على Linux. وعلى حاسوب Linux دون مخزن مفاتيح، مثل الخادم، تُحفَظ في ملف لا يستطيع قراءته سواك تحت ~/.config/skillry. وعند انتهاء صلاحيتها، يطلب الوكيل منك الموافقة مجددًا. لتسجيل الخروج قبل ذلك، اطلب من الوكيل فصل حسابك في Skillry.

إذا لم يستطع Codex رؤية Skillry

ما الذي تراه؟السبب المرجحما الذي تفعله؟
skillry غير موجودة في codex mcp listوُضع الجدول في ملف مشروع غير موثوق، أو يوجد خطأ مطبعي في اسم الجدولضع الجدول في ~/.codex/config.toml وتأكد من أن اسمه [mcp_servers.skillry] تمامًا.
لا يصبح الخادم جاهزًا، أو يبلغ Codex عن انتهاء مهلة البدءاستغرق تنزيل npx الأول أكثر من startup_timeout_sec (10 ثوانٍ افتراضيًا)أضف startup_timeout_sec = 60 إلى الجدول، أو شغّل أمر التشغيل مرة واحدة يدويًا لتخزين الحزمة مؤقتًا.
يعمل في واجهة سطر الأوامر لكن ليس في تطبيق ChatGPTكان التطبيق مفتوحًا أثناء تغيير الملفأغلق تطبيق ChatGPT لسطح المكتب وافتحه مجددًا، أو اختر Restart extension في بيئة التطوير.
الخادم موجود في القائمة لكنه يظهر فاشلًا، أو لا يبدأ أبدًاnpx غير مثبّت، أو إصدار Node.js أقدم من 22، أو انتهت مهلة البدء الأول أثناء تنزيل الحزمةشغّل node --version وnpx --version في الطرفية. ثم شغّل npx --yes skillry-cli@latest mcp يدويًا مرة واحدة، وانتظر حتى يبدأ، واضغط Ctrl+C، وجرّب العميل مجددًا؛ أصبحت الحزمة الآن مخزّنة مؤقتًا.
على Windows، يُغلق الخادم فور بدئهيشغّل الإدخال npx مباشرةً، بينما يحتاج Windows إلى صدفة أوامر لتشغيلهاستخدم إدخال Windows في هذه الصفحة: الأمر هو cmd وتبدأ المعاملات بـ/c وnpx.
تقول صفحة المتصفح إن الطلب غير صالح أو منتهي الصلاحيةتأخرت الموافقة على رمز الجهاز، أو أنه يعود لمحاولة سابقةاطلب من الوكيل الاتصال مجددًا ووافق على الرمز الجديد خلال بضع دقائق.
يتوقف التثبيت برسالة تتعلق بـPremium أو الشراءالمهارة من فئة Premium، وليس لحسابك خطة أو شراء يتيحهااتبع الرابط الذي يعرضه الوكيل لشراء المهارة أو الاشتراك، ثم اطلب مجددًا. لن تُحصَّل أي رسوم حتى تفعل ذلك.

الإزالة أو الفصل

  1. 1

    احذف جدول [mcp_servers.skillry] من ~/.codex/config.toml، أو استخدم أمر الإزالة الذي يعرضه codex mcp --help لإصدارك. لتعطيله دون حذفه، أضف enabled = false إلى الجدول.

  2. 2

    أعِد تشغيل Codex أو التطبيق أو الامتداد.

    يُفترض أن ترى: اختفاء skillry من codex mcp list.

إزالة الإدخال لا تسجّل خروجك من Skillry. ولإلغاء الموافقة المحفوظة أيضًا، اطلب من الوكيل فصل حسابك في Skillry أولًا، أو أزل الإدخال واترك الموافقة تنتهي بعد 7 أيام.

المرجع

العنصرmacOS وLinuxWindows
ملف الإعداد العام~/.codex/config.toml%USERPROFILE%\.codex\config.toml
ملف إعداد المشروع.codex/config.toml (المشاريع الموثوقة فقط)same
أمر التشغيلnpx --yes skillry-cli@latest mcpcmd /c npx --yes skillry-cli@latest mcp
التحققcodex mcp list أو /mcpsame
الجدول الذي يحفظه Codex ‏(macOS وLinux)
[mcp_servers.skillry]
command = "npx"
args = ["--yes","skillry-cli@latest","mcp"]

ستجد المهل وقوائم الأدوات المسموح بها وأوضاع الموافقة في توثيق Codex MCP الرسمي.

أسئلة شائعة

هل أضبطه بصورة منفصلة لتطبيق ChatGPT لسطح المكتب؟

لا. يقرأ التطبيق وواجهة سطر الأوامر وامتداد بيئة التطوير ملف config.toml نفسه. أعِد تشغيل التطبيق بعد تغييره.

هل يمكنني استخدامه في مشروع واحد فقط؟

نعم. في مشروع موثوق، ضع الجدول في .codex/config.toml داخل ذلك المشروع بدلًا من الملف العام.

لماذا يكون البدء الأول بطيئًا؟

ينزّل التشغيل الأول لـnpx حزمة skillry-cli. ارفع قيمة startup_timeout_sec أو شغّل أمر التشغيل مرة واحدة يدويًا؛ بعد ذلك يبدأ فورًا.

المصادر

هل ساعدك هذا الدليل؟