الإجابة المختصرة
- 1شغّل
claude mcp add --scope user --transport stdio skillry -- npx --yes skillry-cli@latest mcpمرة واحدة في أي طرفية. من دون--scope user، يوجد الخادم فقط في المجلد الذي شغّلته منه. - 2تحقّق باستخدام
claude mcp get skillry. ينبغي أن يقرأ سطر الحالة✔ Connected. - 3يوجد الإدخال في
~/.claude.json(Windows:%USERPROFILE%\.claude.json). ويمكنك أيضًا لصق JSON هناك يدويًا.
قبل البدء
اختُبر على macOS مع Claude Code 2.1.296 في 28 أكتوبر 2026. يستخدم Linux الأمر نفسه المستخدم في macOS. تتبع أوامر Windows وLinux التوثيق الرسمي ولم تُجرَّب على جهاز فعلي بعد.
- Claude Code مثبّت ومسجّل الدخول. ينبغي أن يُظهر
claude --versionإصدارًا من السلسلة 2.x. - Node.js 22 أو أحدث (
node --version). يشغّل Claude Code الخادم باستخدامnpxالذي يأتي مع Node. - لا تحتاج إلى تنزيل شيء من Skillry: يجلب
npxالحزمة عند بدء الخادم لأول مرة.
يحفظ Claude Code الخادم في أحد ثلاثة نطاقات. يستخدم هذا الدليل نطاق المستخدم، حتى تتوفر Skillry في كل مشروع.
| النطاق | الخيار | مكان التخزين | متى تستخدمه؟ |
|---|---|---|---|
| المستخدم | --scope user | ~/.claude.json، في المستوى الأعلى | تريد Skillry في كل مشروع. هذا هو نطاق هذا الدليل. |
| محلي (افتراضي) | none | ~/.claude.json، تحت مسار المشروع الحالي | تريدها في هذا المجلد فقط. |
| المشروع | --scope project | .mcp.json في المستودع | تريد أن يحصل عليها زملاؤك من المستودع. يوافق كل منهم عند التشغيل الأول. |
إضافة Skillry إلى Claude Code
- 1
افتح طرفية في أي مجلد وشغّل:
macOS وLinux claude mcp add --scope user --transport stdio skillry -- npx --yes skillry-cli@latest mcpيُفترض أن ترى:
Added stdio MCP server skillry with command: npx --yes skillry-cli@latest mcp to user config، ثمFile modified: ~/.claude.json. - 2
على Windows، شغّل الأمر التالي بدلًا منه. يتيح الغلاف
cmd /cلـWindows تشغيلnpx، وهو برنامج نصي وليس برنامجًا تنفيذيًا.Windows (PowerShell أو Command Prompt) claude mcp add --scope user --transport stdio skillry -- cmd /c npx --yes skillry-cli@latest mcp - 3
ابدأ جلسة Claude Code جديدة، أو اكتب
/mcpفي جلسة مفتوحة بالفعل.يُفترض أن ترى:
skillryفي قائمة/mcp. اختره لرؤية أدواته الـ12.
- 1
افتح
~/.claude.jsonفي محرر. على Windows، الملف هو%USERPROFILE%\.claude.json. ينشئه Claude Code عند تشغيله لأول مرة. - 2
ادمج هذا داخل كائن
mcpServersفي المستوى الأعلى، مع الاحتفاظ بأي خوادم موجودة.macOS وLinux { "mcpServers": { "skillry": { "command": "npx", "args": [ "--yes", "skillry-cli@latest", "mcp" ] } } }المستوى الأعلى يعني بجانب المفاتيح الأخرى في جذر الملف. الإدخال تحت مسار مشروع لا يُحمَّل إلا في ذلك المشروع.
- 3
على Windows، استخدم هذا الإدخال بدلًا منه.
Windows { "mcpServers": { "skillry": { "command": "cmd", "args": [ "/c", "npx", "--yes", "skillry-cli@latest", "mcp" ] } } } - 4
احفظ الملف وابدأ جلسة جديدة.
يُفترض أن ترى:
skillryفي قائمة/mcp.
تحقّق من اتصال Claude Code
- 1
في الطرفية، شغّل:
الطرفية claude mcp get skillryيُفترض أن ترى:
Scope: User config (available in all your projects)وStatus: ✔ Connectedوأمرnpxالذي أضفته. - 2
لعرض جميع الخوادم وحالتها معًا، شغّل
claude mcp list. داخل الجلسة، يعرض/mcpالقائمة نفسها ويتيح فتح أدوات أي خادم.
يشغّل الفحص الأول الخادم، وينزّل البدء الأول skillry-cli. امنحه عشر ثوانٍ أو أكثر. استمرار ✘ Failed to connect بعد ذلك يعني غياب Node أو npx؛ راجع أدناه.
جرّب بحثك الأول
لا يتطلب البحث حسابًا، لذا فهو أسرع طريقة للتأكد من أن الاتصال يعمل.
- 1
ابدأ محادثة جديدة في Claude Code والصق هذا الطلب.
مطالبة لوكيلك 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، أو توقف الطلب دون استجابة، فانتقل إلى لا يعمل.
إذا لم يعرض /mcp خدمة Skillry
| ما الذي تراه؟ | السبب المرجح | ما الذي تفعله؟ |
|---|---|---|
لا يعرض /mcp خدمة skillry | أُضيفت بنطاق محلي في مجلد آخر، أو بدأت الجلسة قبل إضافتها | شغّل claude mcp get skillry. إذا ظهر Scope: Local config، فأزلها وأعِد إضافتها باستخدام --scope user. وإذا ظهر نطاق المستخدم، فابدأ جلسة جديدة. |
يعرض claude mcp add رسالة “was not saved” | تعذّر على Claude Code الكتابة إلى ~/.claude.json | أغلق جلسات Claude Code الأخرى، وتأكد من أن الملف ليس للقراءة فقط، ثم شغّل الأمر مجددًا. |
| متصل على Mac، لكنه يفشل على Windows | يشغّل إدخال Windows الأمر npx دون cmd /c | شغّل claude mcp remove skillry -s user، ثم أضف أمر Windows من هذه الصفحة. |
| الخادم موجود في القائمة لكنه يظهر فاشلًا، أو لا يبدأ أبدًا | 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
أزِل الخادم من إعدادات المستخدم:
الطرفية claude mcp remove skillry -s userيُفترض أن ترى:
Removed MCP server skillry from user config. - 2
للاحتفاظ بالخادم مع تعطيله لمشروع واحد، بدّل حالته في
/mcp؛ يتذكر Claude Code ذلك لكل مشروع.
إزالة الإدخال لا تسجّل خروجك من Skillry. ولإلغاء الموافقة المحفوظة أيضًا، اطلب من الوكيل فصل حسابك في Skillry أولًا، أو أزل الإدخال واترك الموافقة تنتهي بعد 7 أيام.
المرجع
| العنصر | macOS وLinux | Windows |
|---|---|---|
| ملف الإعداد (نطاق المستخدم والنطاق المحلي) | ~/.claude.json | %USERPROFILE%\.claude.json |
| أمر التشغيل | npx --yes skillry-cli@latest mcp | cmd /c npx --yes skillry-cli@latest mcp |
| التحقق | claude mcp get skillry | same |
| الإزالة | claude mcp remove skillry -s user | same |
{
"mcpServers": {
"skillry": {
"command": "npx",
"args": [
"--yes",
"skillry-cli@latest",
"mcp"
]
}
}
}ستجد أولوية النطاقات والموافقة على المشروع وجميع الخيارات الأخرى في توثيق MCP الرسمي.
أسئلة شائعة
هل يجب تشغيل الأمر في كل مشروع؟
لا. يجعل --scope user خدمة Skillry متاحة في جميع مشاريعك. أما النطاق المحلي الافتراضي فيربطها بالمجلد الذي شغّلت الأمر منه.
هل يحتاج Claude Code إلى إعادة التشغيل؟
تلتقط الجلسة الجديدة الخادم. وفي الجلسة المفتوحة، يعرضه /mcp بعد فحص الحالة.
هل يمكن لفريقي مشاركة الإدخال؟
نعم. يكتبه --scope project في .mcp.json داخل المستودع، ويوافق كل زميل عند فتح Claude Code هناك لأول مرة.
المصادر
هل ساعدك هذا الدليل؟
