MCP في Claude Code

Claude Code وكيل برمجة طرفي من Anthropic. مع Synapse MCP، يكتسب Claude Code ذاكرة دائمة عبر جلسات البرمجة — يتذكر سياق مشروعك، القرارات السابقة، وأنماط قاعدة الكود.

الإعداد

الطريقة 1: أمر CLI (موصى به)

# أضف Synapse كخادم MCP
claude mcp add synapse -- npx -y synapse-mcp-api@latest

# عيّن Mind Key كم متغير بيئة (أضف إلى ~/.bashrc أو ~/.zshrc)
export SYNAPSE_MIND_KEY="mk_YOUR_MIND_KEY_HERE"
export SYNAPSE_URL="https://synapse.schaefer.zone"  # اختياري، افتراضي synapse.schaefer.zone

الطريقة 2: حرّر ملف الإعداد

حرّر ~/.claude/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"
      }
    }
  }
}

تحقق أنه يعمل

ابدأ Claude Code:

claude

في Claude Code prompt، اكتب:

recall all my memories

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

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

استمرارية سياق المشروع

عند بدء جلسة برمجة:

recalling my memories — what projects am I working on?

يستدعي Claude memory_recall، يرى قائمة مشاريعك، ويواصل العمل من حيث توقفت.

قرارات قاعدة الكود

عند اتخاذ قرار معماري:

store this: "We chose PostgreSQL over SQLite because of concurrent write
performance. Decision made on 2026-06-27."

يستدعي Claude memory_store مع الفئة project، الأولوية high.

تجنب الأخطاء السابقة

what mistakes have I made with this codebase?

يبحث Claude في الذكريات بالفئة mistake ويذكّرك بالأخطاء السابقة.

تتبع المهام

create a task: "Refactor auth module to use JWT refresh tokens"

يستدعي Claude task_create، وتستمر المهمة عبر الجلسات.

ملفات الأدوات

لجلسات البرمجة التي لا تحتاج جميع الأدوات الـ 119:

# عيّن الملف عبر متغير البيئة
export MCP_PROFILE="standard"  # 25 أداة، ~2500 رمز

# أو في config.json
"env": {
  "SYNAPSE_MIND_KEY": "mk_...",
  "MCP_PROFILE": "standard"
}

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

خادم MCP لا يبدأ

# اختبر خادم MCP يدويًا
npx -y synapse-mcp-api@latest

# يجب أن يطبع:
# [info] synapse-mcp Streamable HTTP server ready
# [info]   MCP:      http://localhost:13100/mcp

Mind Key غير معترف به

# تحقق من تعيين متغير البيئة
echo $SYNAPSE_MIND_KEY

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

Claude Code لا يرى الأدوات

• أعد تشغيل Claude Code بعد تغييرات الإعداد
• تحقق من claude mcp list للتأكد من تسجيل Synapse
• راجع استكشاف أخطاء MCP

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

• إعداد Claude Desktop
• إعداد Cursor
• دليل وكيل LLM الدائم