{"title":"MCP في Cursor","slug":"cursor","category":"mcp","summary":"اربط Synapse بـ Cursor IDE لذاكرة مشروع دائمة عبر جلسات البرمجة.","audience":["human"],"tags":["mcp","cursor","ide","coding"],"difficulty":"intermediate","updated":"2026-06-27","word_count":285,"read_minutes":1,"lang":"ar","translated":true,"requested_lang":"ar","content_markdown":"\n# MCP في Cursor\n\nCursor IDE ذكي مدعوم بـ AI مبني على VS Code. مع Synapse MCP، يكتسب Cursor\nذاكرة دائمة عبر الجلسات — يتذكر قرارات مشروعك،\nأنماط قاعدة الكود، وجلسات تصحيح الأخطاء السابقة.\n\n## المتطلبات المسبقة\n\n- Cursor IDE مثبت ()\n- Node.js 18+\n- Mind Key الخاص بـ Synapse\n\n## الإعداد\n\n### الخطوة 1: افتح إعدادات Cursor\n\nفي Cursor:\n\n1. افتح الإعدادات (Cmd+, على macOS، Ctrl+, على Windows/Linux)\n2. ابحث عن \"MCP\" أو انتقل إلى `Cursor Settings → MCP Servers`\n\n### الخطوة 2: أضف خادم Synapse MCP\n\nانقر \"Add MCP Server\" وأعد:\n\n| الحقل | القيمة |\n|-------|-------|\n| Name | `synapse` |\n| Type | `stdio` |\n| Command | `npx -y synapse-mcp-api@latest` |\n| Env | `SYNAPSE_MIND_KEY=mk_YOUR_KEY, SYNAPSE_URL=https://synapse.schaefer.zone` |\n\n### الخطوة 3: حرّر config.json مباشرة (بديل)\n\nيخزّن Cursor إعداد MCP في `~/.cursor/config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"synapse\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"synapse-mcp-api@latest\"],\n \"env\": {\n \"SYNAPSE_MIND_KEY\": \"mk_YOUR_MIND_KEY_HERE\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n }\n }\n }\n}\n```\n\n### الخطوة 4: أعد تشغيل Cursor\n\nأعد تشغيل Cursor بالكامل (Cmd+Q وأعد الفتح على macOS).\n\n## تحقق أنه يعمل\n\nفي لوحة دردشة Cursor (Cmd+L):\n\n```\nrecall all my memories\n```\n\nيجب أن يستدعي Cursor `memory_recall` ويرد بذكرياتك المخزّنة.\n\n## الأنماط الشائعة\n\n### تهيئة المشروع\n\nعند فتح مشروع جديد:\n\n```\nrecalling project context — what do I know about this codebase?\n```\n\nيستدعي Cursor `memory_recall` ويواصل العمل من حيث توقفت.\n\n### القرارات المعمارية\n\n```\nstore this decision: \"Using Fastify instead of Express for this project\nbecause of schema validation. Date: 2026-06-27.\"\n```\n\nيخزّنها Cursor كذاكرة `project` بأولوية `high`.\n\n### تاريخ التصحيح\n\n```\nwhat bugs have I hit in this codebase?\n```\n\nيبحث Cursor عن ذكريات `mistake` ويذكّرك بالإصلاحات السابقة.\n\n### أنماط الكود عبر الجلسات\n\n```\nsearch memories: \"authentication pattern\"\n```\n\nيجد Cursor ذكريات حول تطبيقات المصادقة التي فعلتها من قبل.\n\n## استكشاف الأخطاء\n\n### خادم MCP لا يتصل\n\n1. تحقق من Node.js: `node --version` (≥ 18)\n2. اختبر خادم MCP: `npx -y synapse-mcp-api@latest` (يجب أن يبدأ بلا أخطاء)\n3. تحقق من سجلات MCP في Cursor (View → Output → MCP)\n4. أعد تشغيل Cursor بالكامل\n\n### الأدوات لا تظهر\n\n- تحقق أن `~/.cursor/config.json` JSON صالح\n- تحقق أن متغير البيئة `SYNAPSE_MIND_KEY` مُعيين\n- تحقق أن إصدار Cursor يدعم MCP (≥ 0.42)\n\n### Mind Key غير صالح\n\n```bash\n# اختبر Mind Key مباشرة\ncurl -H \"Authorization: Bearer mk_YOUR_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n```\n\n## الخطوات التالية\n\n- [إعداد Claude Desktop](/docs/mcp/claude-desktop)\n- [إعداد Continue.dev](/docs/mcp/continue)\n- [دليل وكيل LLM الدائم](/docs/guides/persistent-llm-agent)\n","content_html":"

MCP في Cursor

\n

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

\n

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

\n\n

الإعداد

\n

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

\n

في Cursor:

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

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

\n

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

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
الحقلالقيمة
Namesynapse
Typestdio
Commandnpx -y synapse-mcp-api@latest
EnvSYNAPSE_MIND_KEY=mk_YOUR_KEY, SYNAPSE_URL=https://synapse.schaefer.zone
\n

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

\n

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

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

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

\n

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

\n

تحقق أنه يعمل

\n

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

\n
recall all my memories

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

\n

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

\n

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

\n

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

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

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

\n

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

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

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

\n

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

\n
what bugs have I hit in this codebase?

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

\n

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

\n
search memories: "authentication pattern"

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

\n

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

\n

خادم MCP لا يتصل

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

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

\n\n

Mind Key غير صالح

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

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

\n\n","urls":{"html":"/docs/mcp/cursor","text":"/docs/mcp/cursor?format=text","json":"/docs/mcp/cursor?format=json","llm":"/docs/mcp/cursor?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}