MCP في Cursor

Cursor IDE ذكي مدعوم بـ AI مبني على VS Code. مع Synapse MCP، يكتسب Cursor ذاكرة دائمة عبر الجلسات — يتذكر قرارات مشروعك، أنماط قاعدة الكود، وجلسات تصحيح الأخطاء السابقة.

المتطلبات المسبقة

• Cursor IDE مثبت (https://cursor.com)
• Node.js 18+
• Mind Key الخاص بـ Synapse

الإعداد

الخطوة 1: افتح إعدادات Cursor

في Cursor:

1. افتح الإعدادات (Cmd+, على macOS، Ctrl+, على Windows/Linux)
2. ابحث عن "MCP" أو انتقل إلى Cursor Settings → MCP Servers

الخطوة 2: أضف خادم Synapse MCP

انقر "Add MCP Server" وأعد:

الحقل	القيمة
Name	synapse
Type	stdio
Command	npx -y synapse-mcp-api@latest
Env	SYNAPSE_MIND_KEY=mk_YOUR_KEY, SYNAPSE_URL=https://synapse.schaefer.zone

الخطوة 3: حرّر config.json مباشرة (بديل)

يخزّن Cursor إعداد MCP في ~/.cursor/config.json:

{
  "mcpServers": {
    "synapse": {
      "command": "npx",
      "args": ["-y", "synapse-mcp-api@latest"],
      "env": {
        "SYNAPSE_MIND_KEY": "mk_YOUR_MIND_KEY_HERE",
        "SYNAPSE_URL": "https://synapse.schaefer.zone"
      }
    }
  }
}

الخطوة 4: أعد تشغيل Cursor

أعد تشغيل Cursor بالكامل (Cmd+Q وأعد الفتح على macOS).

تحقق أنه يعمل

في لوحة دردشة Cursor (Cmd+L):

recall all my memories

يجب أن يستدعي Cursor memory_recall ويرد بذكرياتك المخزّنة.

الأنماط الشائعة

تهيئة المشروع

عند فتح مشروع جديد:

recalling project context — what do I know about this codebase?

يستدعي Cursor memory_recall ويواصل العمل من حيث توقفت.

القرارات المعمارية

store this decision: "Using Fastify instead of Express for this project
because of schema validation. Date: 2026-06-27."

يخزّنها Cursor كذاكرة project بأولوية high.

تاريخ التصحيح

what bugs have I hit in this codebase?

يبحث Cursor عن ذكريات mistake ويذكّرك بالإصلاحات السابقة.

أنماط الكود عبر الجلسات

search memories: "authentication pattern"

يجد Cursor ذكريات حول تطبيقات المصادقة التي فعلتها من قبل.

استكشاف الأخطاء

خادم MCP لا يتصل

1. تحقق من Node.js: node --version (≥ 18)
2. اختبر خادم MCP: npx -y synapse-mcp-api@latest (يجب أن يبدأ بلا أخطاء)
3. تحقق من سجلات MCP في Cursor (View → Output → MCP)
4. أعد تشغيل Cursor بالكامل

الأدوات لا تظهر

• تحقق أن ~/.cursor/config.json JSON صالح
• تحقق أن متغير البيئة SYNAPSE_MIND_KEY مُعيين
• تحقق أن إصدار Cursor يدعم MCP (≥ 0.42)

Mind Key غير صالح

# اختبر Mind Key مباشرة
curl -H "Authorization: Bearer mk_YOUR_KEY" \
     https://synapse.schaefer.zone/memory/recall

الخطوات التالية

• إعداد Claude Desktop
• إعداد Continue.dev
• دليل وكيل LLM الدائم