الإجابة المختصرة
- 1شغّل
codex mcp add skillry -- npx --yes skillry-cli@latest mcpمرة واحدة؛ وعلى Windows، استخدمcmd /cلتغليف أمر التشغيل. - 2تحقّق باستخدام
codex mcp list، أو اكتب/mcpفي واجهة Codex النصية. - 3يتشارك تطبيق ChatGPT لسطح المكتب وامتداد بيئة التطوير الإدخال: اضبطه مرة واحدة واستخدمه في الثلاثة.
قبل البدء
رُوجع بالرجوع إلى التوثيق الرسمي في 28 أكتوبر 2026. لم يُجرَّب بعد على تثبيت فعلي لهذا العميل؛ إذا اختلفت خطوة على جهازك، فاستخدم الإبلاغ عن مشكلة في الأسفل.
- Codex مسجّل الدخول: واجهة سطر الأوامر، أو تطبيق ChatGPT لسطح المكتب مع Codex، أو امتداد بيئة التطوير. تتشارك جميعها إعدادًا واحدًا.
- Node.js 22 أو أحدث (
node --version). يشغّل Codex الخادم باستخدامnpx. - يعمل أيضًا ملف
.codex/config.tomlعلى مستوى المشروع، لكن فقط في المشاريع التي علّمتها موثوقة. يستخدم هذا الدليل الملف العام.
إضافة Skillry إلى Codex
- 1
شغّل هذا في أي طرفية:
macOS وLinux codex mcp add skillry -- npx --yes skillry-cli@latest mcpيُفترض أن ترى: لا يظهر خطأ، وأصبح
codex mcp listيتضمنskillry. - 2
على Windows، شغّل هذا بدلًا منه حتى يستطيع Windows بدء
npx:Windows (PowerShell أو Command Prompt) codex mcp add skillry -- cmd /c npx --yes skillry-cli@latest mcp - 3
ابدأ Codex مجددًا، أو أعِد تشغيل التطبيق أو الامتداد إذا كان مفتوحًا.
يُفترض أن ترى:
skillryفي قائمة/mcpداخل Codex.
- 1
في تطبيق ChatGPT لسطح المكتب، افتح Settings ثم MCP servers. وفي امتداد بيئة التطوير، افتح قائمة الترس ثم MCP servers.
- 2
اختر Add server. أدخل الاسم
skillry، واختر STDIO، وأدخل الأمرnpx --yes skillry-cli@latest mcp(على Windowscmd /c npx --yes skillry-cli@latest mcp). - 3
احفظ، ثم اختر Restart في التطبيق أو Restart extension في بيئة التطوير.
يُفترض أن ترى: تظهر
skillryمفعّلة في قائمة خوادم MCP.
- 1
افتح
~/.codex/config.tomlفي محرر؛ وأنشئه إذا لم يكن موجودًا. - 2
ألحِق هذا الجدول. إذا كان جدول
[mcp_servers.skillry]موجودًا، فاستبدله.macOS وLinux [mcp_servers.skillry] command = "npx" args = ["--yes","skillry-cli@latest","mcp"] - 3
على Windows، استخدم هذا الجدول بدلًا منه.
Windows [mcp_servers.skillry] command = "cmd" args = ["/c","npx","--yes","skillry-cli@latest","mcp"] - 4
إذا انتهت مهلة البدء الأول، فأضف
startup_timeout_sec = 60تحت الجدول. القيمة الافتراضية 10 ثوانٍ، وأول تشغيل لـnpxينزّل الحزمة. - 5
احفظ ثم ابدأ Codex مجددًا.
يُفترض أن ترى:
skillryفيcodex mcp listوفي/mcp.
تحقّق من اتصال Codex
- 1
في الطرفية، اعرض الخوادم المُعدّة:
الطرفية codex mcp listيُفترض أن ترى:
skillryمع أمرnpxالذي أدخلته. - 2
في واجهة Codex النصية، اكتب
/mcp.يُفترض أن ترى:
skillryضمن الخوادم النشطة، مع أدواتها.
جرّب بحثك الأول
لا يتطلب البحث حسابًا، لذا فهو أسرع طريقة للتأكد من أن الاتصال يعمل.
- 1
ابدأ محادثة جديدة في Codex والصق هذا الطلب.
مطالبة لوكيلك Use the Skillry MCP connected to https://skillry.dev to find three product presentation Skills. Show their preview links, required inputs, dependencies and external costs. Do not install or run anything.يُفترض أن ترى: ثلاث مهارات مرشحة، لكل منها رابط معاينة والمدخلات المطلوبة والاعتماديات وأي تكاليف خارجية. لن يُثبَّت شيء.
- 2
إذا قال الوكيل إنه لا يملك أداة 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
احذف جدول
[mcp_servers.skillry]من~/.codex/config.toml، أو استخدم أمر الإزالة الذي يعرضهcodex mcp --helpلإصدارك. لتعطيله دون حذفه، أضفenabled = falseإلى الجدول. - 2
أعِد تشغيل Codex أو التطبيق أو الامتداد.
يُفترض أن ترى: اختفاء
skillryمنcodex mcp list.
إزالة الإدخال لا تسجّل خروجك من Skillry. ولإلغاء الموافقة المحفوظة أيضًا، اطلب من الوكيل فصل حسابك في Skillry أولًا، أو أزل الإدخال واترك الموافقة تنتهي بعد 7 أيام.
المرجع
| العنصر | macOS وLinux | Windows |
|---|---|---|
| ملف الإعداد العام | ~/.codex/config.toml | %USERPROFILE%\.codex\config.toml |
| ملف إعداد المشروع | .codex/config.toml (المشاريع الموثوقة فقط) | same |
| أمر التشغيل | npx --yes skillry-cli@latest mcp | cmd /c npx --yes skillry-cli@latest mcp |
| التحقق | codex mcp list أو /mcp | same |
[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 أو شغّل أمر التشغيل مرة واحدة يدويًا؛ بعد ذلك يبدأ فورًا.
المصادر
هل ساعدك هذا الدليل؟
