# MCP في Claude Code

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

## الإعداد

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

```bash
# أضف 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`:

```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:

```bash
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:

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

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

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

### خادم MCP لا يبدأ

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

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

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

```bash
# تحقق من تعيين متغير البيئة
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](/docs/mcp/troubleshooting)

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

- [إعداد Claude Desktop](/docs/mcp/claude-desktop)
- [إعداد Cursor](/docs/mcp/cursor)
- [دليل وكيل LLM الدائم](/docs/guides/persistent-llm-agent)