التكاملات وMCP6 دقائق

ربط VS Code وCursor مع SNG MCP

دليل IDE مستقل لاختيار النظام ونسخ الإعداد الجاهز وحفظ مفتاح الوصول بأمان

تعرض لوحة SNG إعدادًا جاهزًا حسب محرر النصوص ونظام التشغيل. اختر VS Code أو Cursor ثم Windows أو macOS أو Linux؛ ستتغير صيغة الملف ومساره تلقائيًا، فلا تحتاج إلى كتابة الإعداد من الصفر.

تنبيه

مفتاح API سري ويظهر كاملًا مرة واحدة. لا تكتبه داخل المحادثة، ولا تحفظه في ملف مرفوع إلى Git أو داخل مشروع عام.

1
الخطوة 1
اختر IDE ونظام التشغيل
افتح الإعدادات ← API وMCP في لوحة SNG. اختر VS Code أو Cursor، ثم اختر Windows أو macOS أو Linux. ستعرض اللوحة مسار الملف الصحيح وإعداد الاتصال المناسب تلقائيًا.
2
الخطوة 2
أنشئ مفتاحًا مخصصًا لهذا الجهاز
اضغط إنشاء مفتاح API، واكتب اسمًا واضحًا مثل Office-VSCode، وحدد مدة الانتهاء والصلاحيات المطلوبة فقط. ابدأ بصلاحيات القراءة، ثم أضف صلاحيات أخرى عندما تحتاجها.
ملاحظة
لا تستخدم المفتاح نفسه على عدة أجهزة؛ هذا يجعل إلغاء جهاز واحد آمنًا وسهلًا.
3
الخطوة 3
انسخ الإعداد الجاهز إلى المسار الظاهر
اضغط نسخ بجوار الإعداد الذي أنشأته اللوحة، ثم أنشئ الملف في المسار المعروض والصق المحتوى. VS Code يستخدم ملفًا داخل المشروع، بينما Cursor يستخدم ملفًا داخل مجلد المستخدم.
4
الخطوة 4
أضف المفتاح من دون نشره
في VS Code سيطلب المحرر المفتاح كحقل سري عند بدء الاتصال. في Cursor استبدل YOUR_SNG_PERSONAL_TOKEN داخل ملف محلي غير متتبع، وتأكد أن الملف أو السر غير مضاف إلى Git.
ملاحظة
إذا كان المشروع مشتركًا، لا تضع قيمة المفتاح داخل ملف يمكن لأعضاء الفريق أو CI قراءته.
5
الخطوة 5
أعد تشغيل IDE واختبر الاتصال
أعد تشغيل المحرر أو أعد تحميل النافذة، ثم افتح أدوات MCP وتأكد أن SNG متصل. ابدأ بطلب: «اعرض خدماتي فقط» قبل تجربة أي إجراء.

مسارات الملفات

IDE	Windows	macOS	Linux
VS Code	<project>\.vscode\mcp.json	<project>/.vscode/mcp.json	<project>/.vscode/mcp.json
Cursor	%USERPROFILE%\.cursor\mcp.json	/Users/<username>/.cursor/mcp.json	/home/<username>/.cursor/mcp.json