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

ربط Skillry MCP في Claude Code

يسجّل أمر claude mcp add واحد Skillry لكل مشروع تفتحه. تقدم هذه الصفحة الأمر لـmacOS وLinux وWindows، والملف الذي يكتبه، وكيفية تأكيد اتصال الخادم، وما الذي تفحصه عندما لا يظهر في /mcp.

لمن؟
مستخدمو Claude Code
الوقت
3 دقائق للإكمال
تم الاختبار
Claude Code 2.1، على macOS، ‏28 أكتوبر 2026

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

  1. 1شغّل claude mcp add --scope user --transport stdio skillry -- npx --yes skillry-cli@latest mcp مرة واحدة في أي طرفية. من دون --scope user، يوجد الخادم فقط في المجلد الذي شغّلته منه.
  2. 2تحقّق باستخدام claude mcp get skillry. ينبغي أن يقرأ سطر الحالة ✔ Connected.
  3. 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

الأسرع. يعمل في أي صدفة أوامر، بما فيها PowerShell وCommand Prompt
  1. 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. 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. 3

    ابدأ جلسة Claude Code جديدة، أو اكتب /mcp في جلسة مفتوحة بالفعل.

    يُفترض أن ترى: skillry في قائمة /mcp. اختره لرؤية أدواته الـ12.

تحقّق من اتصال Claude Code

  1. 1

    في الطرفية، شغّل:

    الطرفية
    claude mcp get skillry

    يُفترض أن ترى: Scope: User config (available in all your projects) وStatus: ✔ Connected وأمر npx الذي أضفته.

  2. 2

    لعرض جميع الخوادم وحالتها معًا، شغّل claude mcp list. داخل الجلسة، يعرض /mcp القائمة نفسها ويتيح فتح أدوات أي خادم.

يشغّل الفحص الأول الخادم، وينزّل البدء الأول skillry-cli. امنحه عشر ثوانٍ أو أكثر. استمرار ✘ Failed to connect بعد ذلك يعني غياب Node أو npx؛ راجع أدناه.

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

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

  1. 1

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

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

  2. 2

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

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

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

    أزِل الخادم من إعدادات المستخدم:

    الطرفية
    claude mcp remove skillry -s user

    يُفترض أن ترى: Removed MCP server skillry from user config.

  2. 2

    للاحتفاظ بالخادم مع تعطيله لمشروع واحد، بدّل حالته في /mcp؛ يتذكر Claude Code ذلك لكل مشروع.

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

المرجع

العنصرmacOS وLinuxWindows
ملف الإعداد (نطاق المستخدم والنطاق المحلي)~/.claude.json%USERPROFILE%\.claude.json
أمر التشغيلnpx --yes skillry-cli@latest mcpcmd /c npx --yes skillry-cli@latest mcp
التحققclaude mcp get skillrysame
الإزالةclaude mcp remove skillry -s usersame
الإدخال الذي يحفظه Claude Code ‏(macOS وLinux)
{
  "mcpServers": {
    "skillry": {
      "command": "npx",
      "args": [
        "--yes",
        "skillry-cli@latest",
        "mcp"
      ]
    }
  }
}

ستجد أولوية النطاقات والموافقة على المشروع وجميع الخيارات الأخرى في توثيق MCP الرسمي.

أسئلة شائعة

هل يجب تشغيل الأمر في كل مشروع؟

لا. يجعل --scope user خدمة Skillry متاحة في جميع مشاريعك. أما النطاق المحلي الافتراضي فيربطها بالمجلد الذي شغّلت الأمر منه.

هل يحتاج Claude Code إلى إعادة التشغيل؟

تلتقط الجلسة الجديدة الخادم. وفي الجلسة المفتوحة، يعرضه /mcp بعد فحص الحالة.

هل يمكن لفريقي مشاركة الإدخال؟

نعم. يكتبه --scope project في .mcp.json داخل المستودع، ويوافق كل زميل عند فتح Claude Code هناك لأول مرة.

المصادر

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