الإجابة المختصرة
- 1في skillry.dev/mcp، اختر Cursor ثم Add to Cursor، وأكد الخادم داخل Cursor.
- 2أو ادمج إدخال
skillryفي~/.cursor/mcp.jsonلكل المشاريع، أو.cursor/mcp.jsonلمشروع واحد. - 3تحقّق من صفحة Customize في Cursor: ينبغي أن تكون
skillryمفعّلة وتعرض أدواتها.
قبل البدء
رُوجع بالرجوع إلى التوثيق الرسمي في 28 أكتوبر 2026. لم يُجرَّب بعد على تثبيت فعلي لهذا العميل؛ إذا اختلفت خطوة على جهازك، فاستخدم الإبلاغ عن مشكلة في الأسفل.
- Cursor مثبّت ومسجّل الدخول.
- Node.js 22 أو أحدث (
node --version). يشغّل Cursor الخادم باستخدامnpx.
| الملف | ينطبق على | متى تستخدمه؟ |
|---|---|---|
~/.cursor/mcp.json | كل مشروع على هذا الجهاز | تريد Skillry في كل مكان. هذا هو إعداد هذا الدليل. |
.cursor/mcp.json داخل مشروع | ذلك المشروع فقط | تريد مشاركتها مع فريق عبر المستودع. |
إضافة Skillry إلى Cursor
- 1
افتح skillry.dev/mcp، واختر Cursor ونظام التشغيل لديك.
- 2
اختر Add to Cursor. يسألك المتصفح إن كنت تريد فتح Cursor؛ اسمح بذلك.
- 3
في Cursor، راجع الخادم المسمى
skillryوأمرnpxالخاص به، ثم أكّد.يُفترض أن ترى:
skillryفي قائمة MCP بصفحة Customize.فتح Cursor لا يعني أن Skillry متصلة. تحقّق من صفحة Customize أو نفّذ البحث الأول أدناه.
- 1
أنشئ أو افتح
~/.cursor/mcp.json. لمشروع واحد، استخدم بدلًا منه.cursor/mcp.jsonداخل ذلك المشروع. - 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
احفظ الملف. يلتقط Cursor التغيير؛ وإذا لم يظهر الخادم، فأعِد تشغيل Cursor.
يُفترض أن ترى:
skillryفي قائمة MCP بصفحة Customize.
تحقّق من اتصال Cursor
- 1
افتح Customize من الشريط الجانبي وابحث عن
skillryبين خوادم MCP.يُفترض أن ترى: الخادم مفعّل وبحالة سليمة، وأدواته مدرجة بدءًا بـ
search_skills. - 2
إذا ظهر خطأ، فاختره لقراءة السجل؛ ينزّل البدء الأول الحزمة وقد يستغرق عشر ثوانٍ أو أكثر.
جرّب بحثك الأول
لا يتطلب البحث حسابًا، لذا فهو أسرع طريقة للتأكد من أن الاتصال يعمل.
- 1
ابدأ محادثة جديدة في محادثة الوكيل في Cursor والصق هذا الطلب.
مطالبة لوكيلك 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، أو توقف الطلب دون استجابة، فانتقل إلى لا يعمل.
إذا لم يستطع Cursor رؤية Skillry
| ما الذي تراه؟ | السبب المرجح | ما الذي تفعله؟ |
|---|---|---|
skillry غير موجودة في صفحة Customize | الملف في المكان الخطأ، أو JSON غير صالح | تحقّق من المسار (~/.cursor/mcp.json لجميع المشاريع) ومن صحة JSON: لا فواصل زائدة في النهاية، وskillry داخل mcpServers. |
| لم يفعل رابط Add to Cursor شيئًا | حظر المتصفح رابط cursor:// | اسمح للمتصفح بفتح Cursor، أو استخدم تبويب تحرير mcp.json. |
| الخادم معطّل | عُطّل من صفحة Customize | فعّله؛ يحتفظ Cursor بالإدخال في الحالتين. |
| الخادم موجود في القائمة لكنه يظهر فاشلًا، أو لا يبدأ أبدًا | 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
أزِل
skillryمن صفحة Customize، أو احذف إدخاله منmcp.json. وللاحتفاظ به مع منع تحميله، عطّله هناك بدلًا من حذفه.يُفترض أن ترى: اختفاء
skillryمن قائمة MCP.
إزالة الإدخال لا تسجّل خروجك من Skillry. ولإلغاء الموافقة المحفوظة أيضًا، اطلب من الوكيل فصل حسابك في Skillry أولًا، أو أزل الإدخال واترك الموافقة تنتهي بعد 7 أيام.
المرجع
| العنصر | macOS وLinux | Windows |
|---|---|---|
| ملف الإعداد العام | ~/.cursor/mcp.json | %USERPROFILE%\.cursor\mcp.json |
| ملف إعداد المشروع | .cursor/mcp.json | same |
| أمر التشغيل | npx --yes skillry-cli@latest mcp | cmd /c npx --yes skillry-cli@latest mcp |
| التحقق | صفحة Customize | same |
{
"mcpServers": {
"skillry": {
"command": "npx",
"args": [
"--yes",
"skillry-cli@latest",
"mcp"
]
}
}
}رابط Add to Cursor هو cursor://anysphere.cursor-deeplink/mcp/install?name=skillry&config=…، حيث config هو الإدخال نفسه بترميز base64. يفك Cursor الترميز ويعرضه عليك قبل الحفظ. التفاصيل في توثيق روابط التثبيت.
أسئلة شائعة
هل رابط Add to Cursor آمن؟
يحمل اسم الخادم وأمر التشغيل فقط، بترميز base64. يعرض Cursor كليهما قبل تأكيدك، ولا يعمل شيء حتى تؤكد.
الملف العام أم ملف المشروع؟
العام (~/.cursor/mcp.json) لاستخدامك الشخصي. وملف المشروع (.cursor/mcp.json) عندما ينبغي أن يحصل عليه الفريق من المستودع.
هل يحتاج Cursor إلى إعادة التشغيل؟
عادةً لا: تتحدّث صفحة Customize عند تغيّر الملف. أعِد تشغيل Cursor إذا لم يظهر الخادم.
المصادر
هل ساعدك هذا الدليل؟
