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

ربط Skillry MCP في VS Code

يضيف VS Code خوادم MCP من رابط أو لوحة الأوامر أو سطر الأوامر أو ملف mcp.json، ويستخدمها في وضع الوكيل في Copilot Chat. اختر المسار الذي تفضله؛ تنتهي جميعها بظهور skillry في MCP: List Servers.

لمن؟
VS Code مع Copilot
الوقت
4 دقائق للإكمال
تم الاختبار
code --add-mcp، على macOS، ‏28 أكتوبر 2026

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

  1. 1تحتاج إلى تفعيل GitHub Copilot في VS Code (تكفي الفئة المجانية). من دونه لا تتوفر أوامر MCP.
  2. 2الأسرع: Add to VS Code على skillry.dev/mcp، أو أمر code --add-mcp واحد في الطرفية.
  3. 3تحقّق باستخدام MCP: List Servers في لوحة الأوامر: ينبغي أن تكون skillry قيد التشغيل.

قبل البدء

اختُبر مسار code --add-mcp على macOS مع VS Code 1.141 في 28 أكتوبر 2026. تتبع المسارات الأخرى التوثيق الرسمي ولم تُجرَّب على تثبيت فعلي بعد.

  • VS Code مع تسجيل الدخول إلى GitHub Copilot وتفعيل ميزات الذكاء الاصطناعي. تكفي فئة Copilot المجانية.
  • Node.js 22 أو أحدث (node --version). يشغّل VS Code الخادم باستخدام npx.
  • لدى VS Code تنسيقان للملفات: ملف mcp.json الخاص به بمفتاح servers، وملف Copilot القابل للنقل ~/.copilot/mcp-config.json بمفتاح mcpServers. يعمل كلاهما؛ وتوضح هذه الصفحة الملف الذي يكتبه كل مسار.
المساريكتب إلىمناسب عندما
رابط Add to VS Codemcp.json في ملف تعريف المستخدمأنت بالفعل على skillry.dev/mcp
MCP: Add Server في لوحة الأوامر~/.copilot/mcp-config.json ‏(Copilot العام)تفضل استخدام النقرات داخل VS Code
code --add-mcp في الطرفيةmcp.json في ملف تعريف المستخدمتفضل أمرًا واحدًا
تحرير mcp.json بنفسكأي ملف تفتحهتريد رؤية الإدخال

إضافة Skillry إلى VS Code

الأسرع من skillry.dev
  1. 1

    افتح skillry.dev/mcp، واختر VS Code ونظام التشغيل، ثم Add to VS Code. اسمح للمتصفح بفتح VS Code.

  2. 2

    يعرض VS Code اسم الخادم وأمره ويطلب التأكيد. اختر Install.

    يُفترض أن ترى: الإدخال في ملف المستخدم mcp.json، مع إجراء Start فوقه. اختره، أو انتظر حتى يبدأ الخادم عند الاستخدام الأول.

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

  1. 1

    شغّل MCP: List Servers من لوحة الأوامر واختر skillry.

    يُفترض أن ترى: خادم قيد التشغيل مع إجراءات مثل Stop وRestart وShow Output. إذا كان متوقفًا، فاختر Start.

  2. 2

    افتح Chat، وانتقل إلى وضع Agent، وافتح منتقي الأدوات.

    يُفترض أن ترى: أدوات Skillry، بدءًا بـsearch_skills، متاحة للتحديد.

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

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

  1. 1

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

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

  2. 2

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

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

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

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

ما الذي تراه؟السبب المرجحما الذي تفعله؟
لا يوجد MCP: Add Server في لوحة الأوامرلم يُسجَّل الدخول إلى Copilot، أو ميزات الذكاء الاصطناعي معطّلةسجّل الدخول إلى GitHub وفعّل Copilot. تظهر أوامر MCP بمجرد توفر Chat.
الخادم مدرج لكنه متوقف، أو يعرض خطألم يبدأ مطلقًا، أو فشل npxاختر Start في MCP: List Servers ثم Show Output لقراءة الخطأ. غياب npx يعني أن Node.js غير مثبّت لصدفة الأوامر التي يستخدمها VS Code.
لا تظهر الأدوات في Chat مطلقًاChat ليس في وضع Agent، أو لم تُحدَّد الأدواتانتقل إلى وضع Agent، وافتح منتقي الأدوات وحدّد أدوات Skillry.
الخادم موجود في القائمة لكنه يظهر فاشلًا، أو لا يبدأ أبدًا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: List Servers، واختر skillry ثم Uninstall؛ أو احذف الإدخال من الملف الذي يحتويه.

    يُفترض أن ترى: اختفاء skillry من القائمة.

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

المرجع

الملفmacOSLinuxWindows
mcp.json في ملف تعريف المستخدم (مفتاح servers)~/Library/Application Support/Code/User/mcp.json~/.config/Code/User/mcp.json%APPDATA%\Code\User\mcp.json
ملف Copilot (مفتاح mcpServers)~/.copilot/mcp-config.json~/.copilot/mcp-config.json%USERPROFILE%\.copilot\mcp-config.json
ملف مساحة العمل.vscode/mcp.json في المشروعsamesame
أمر التشغيلnpx --yes skillry-cli@latest mcpnpx --yes skillry-cli@latest mcpcmd /c npx --yes skillry-cli@latest mcp
الإدخال الذي يحفظه VS Code في mcp.json ‏(macOS وLinux)
{
  "servers": {
    "skillry": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "--yes",
        "skillry-cli@latest",
        "mcp"
      ]
    }
  }
}

جميع الحقول وتنسيق رابط التثبيت وتنسيقا الملفات في مرجع إعداد MCP.

أسئلة شائعة

هل أحتاج إلى Copilot؟

نعم. يوجد دعم MCP في VS Code داخل وضع الوكيل في Copilot Chat. وتكفي فئة Copilot المجانية.

أي ملف ينبغي أن أستخدم؟

أي واحد منها. يكتب الرابط وcode --add-mcp ملف mcp.json الخاص بالمستخدم؛ ويكتب MCP: Add Server ملف Copilot. لا تضف Skillry إلى كليهما.

هل يمكنني مشاركته مع فريقي؟

ضع الإدخال في .vscode/mcp.json داخل المستودع بتنسيق servers. يتلقى الزملاء طلب ثقة عند تشغيله لأول مرة بواسطة VS Code.

المصادر

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