الإجابة المختصرة
- 1تحتاج إلى تفعيل GitHub Copilot في VS Code (تكفي الفئة المجانية). من دونه لا تتوفر أوامر MCP.
- 2الأسرع: Add to VS Code على skillry.dev/mcp، أو أمر
code --add-mcpواحد في الطرفية. - 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 Code | mcp.json في ملف تعريف المستخدم | أنت بالفعل على skillry.dev/mcp |
| MCP: Add Server في لوحة الأوامر | ~/.copilot/mcp-config.json (Copilot العام) | تفضل استخدام النقرات داخل VS Code |
code --add-mcp في الطرفية | mcp.json في ملف تعريف المستخدم | تفضل أمرًا واحدًا |
تحرير mcp.json بنفسك | أي ملف تفتحه | تريد رؤية الإدخال |
إضافة Skillry إلى VS Code
- 1
افتح skillry.dev/mcp، واختر VS Code ونظام التشغيل، ثم Add to VS Code. اسمح للمتصفح بفتح VS Code.
- 2
يعرض VS Code اسم الخادم وأمره ويطلب التأكيد. اختر Install.
يُفترض أن ترى: الإدخال في ملف المستخدم
mcp.json، مع إجراء Start فوقه. اختره، أو انتظر حتى يبدأ الخادم عند الاستخدام الأول.
- 1
افتح لوحة الأوامر (⇧⌘P على macOS، وCtrl+Shift+P على Windows وLinux) وشغّل MCP: Add Server.
- 2
اختر Command (stdio) وأدخل أمر التشغيل:
npx --yes skillry-cli@latest mcpعلى macOS وLinux، أوcmd /c npx --yes skillry-cli@latest mcpعلى Windows. - 3
أدخل
skillryمعرّفًا للخادم. - 4
اختر Global، ثم Copilot Global عند الطلب. يكتب ذلك
~/.copilot/mcp-config.json.يُفترض أن ترى: طلب ثقة بالخادم الجديد. اقبله للسماح لـVS Code بتشغيله.
- 1
شغّل هذا في الطرفية. على Windows استخدم PowerShell، حيث تعمل علامات الاقتباس المفردة كما هي مكتوبة.
macOS وLinux code --add-mcp '{"name":"skillry","type":"stdio","command":"npx","args":["--yes","skillry-cli@latest","mcp"]}'يُفترض أن ترى:
Added MCP servers: skillry. يفتح VS Code أو ينتقل إلى المقدمة. - 2
على Windows، شغّل هذا بدلًا منه حتى يستطيع Windows بدء
npx:Windows (PowerShell) code --add-mcp '{"name":"skillry","type":"stdio","command":"cmd","args":["/c","npx","--yes","skillry-cli@latest","mcp"]}'
- 1
شغّل MCP: Open User Configuration من لوحة الأوامر. يفتح ملف
mcp.jsonفي ملف تعريف المستخدم، وينشئه عند الحاجة. - 2
ادمج هذا داخل كائن
serversمع الاحتفاظ بأي خوادم موجودة.macOS وLinux { "servers": { "skillry": { "type": "stdio", "command": "npx", "args": [ "--yes", "skillry-cli@latest", "mcp" ] } } } - 3
على Windows، استخدم هذا الإدخال بدلًا منه.
Windows { "servers": { "skillry": { "type": "stdio", "command": "cmd", "args": [ "/c", "npx", "--yes", "skillry-cli@latest", "mcp" ] } } } - 4
احفظ. يعرض VS Code إجراء Start فوق الإدخال؛ اختره.
يُفترض أن ترى: الخادم قيد التشغيل في MCP: List Servers.
تحقّق من اتصال VS Code
- 1
شغّل MCP: List Servers من لوحة الأوامر واختر
skillry.يُفترض أن ترى: خادم قيد التشغيل مع إجراءات مثل Stop وRestart وShow Output. إذا كان متوقفًا، فاختر Start.
- 2
افتح Chat، وانتقل إلى وضع Agent، وافتح منتقي الأدوات.
يُفترض أن ترى: أدوات Skillry، بدءًا بـ
search_skills، متاحة للتحديد.
جرّب بحثك الأول
لا يتطلب البحث حسابًا، لذا فهو أسرع طريقة للتأكد من أن الاتصال يعمل.
- 1
ابدأ محادثة جديدة في وضع الوكيل في Copilot Chat والصق هذا الطلب.
مطالبة لوكيلك 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، أو توقف الطلب دون استجابة، فانتقل إلى لا يعمل.
إذا لم يستطع 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
شغّل MCP: List Servers، واختر
skillryثم Uninstall؛ أو احذف الإدخال من الملف الذي يحتويه.يُفترض أن ترى: اختفاء
skillryمن القائمة.
إزالة الإدخال لا تسجّل خروجك من Skillry. ولإلغاء الموافقة المحفوظة أيضًا، اطلب من الوكيل فصل حسابك في Skillry أولًا، أو أزل الإدخال واترك الموافقة تنتهي بعد 7 أيام.
المرجع
| الملف | macOS | Linux | Windows |
|---|---|---|---|
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 في المشروع | same | same |
| أمر التشغيل | npx --yes skillry-cli@latest mcp | npx --yes skillry-cli@latest mcp | cmd /c npx --yes skillry-cli@latest mcp |
{
"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.
المصادر
هل ساعدك هذا الدليل؟
