# ما هو MCP؟

**Model Context Protocol (MCP)** معيار مفتوح من Anthropic (2024)
يتيح لـ LLMs استدعاء أدوات خارجية بطريقة منظمة. بدلًا من لصق وثائق API
في الـ prompt، تسجّل الأدوات مع خادم MCP، ويستدعيها الـ LLM
عند الحاجة — مثل استدعاء الدوال، لكن موحّد ومستقل عن العميل.

## خادم Synapse MCP

يأتي Synapse بخادم MCP رسمي (`synapse-mcp-api` على npm) يعرض
**79 أداة** تغطي جميع ميزات Synapse:

| الفئة | الأدوات | العدد |
|----------|-------|-------|
| الذاكرة | recall, list, store, search, semantic-search, update, delete, bulk-delete, stats, unverified, contradictions, audit, related, by-tag, diff, expiring, health, sync, embed-batch, verify, unverify, mind-export | 22 |
| الدردشة | poll, reply, status, history, unread, send, upload | 7 |
| المجدول | cron_list, cron_create, cron_delete, cron_toggle, var_list, var_get, var_set, var_delete | 8 |
| المهام | task_list, task_get, task_create, task_update | 4 |
| السكربتات | script_list, script_get, script_info, script_store, script_delete | 5 |
| الأجهزة | computer_list, computer_get, install_code, screenshot, command_queue, command_status, commands_list, disable, delete | 9 |
| الإشعارات | vapid_public_key, subscribe, unsubscribe, test | 4 |
| المستخدم/العقل | register, login, minds_list, mind_create, mind_delete | 5 |
| الأدوات | time, calc, random | 3 |
| التصور | graph, tags, compact | 3 |
| المشاركة | share, list, revoke | 3 |
| الـ Webhooks | register, list, get, update, delete | 5 |
| المتصفح | new, navigate, click, type, screenshot, close | 6 |
| **الإجمالي** | | **79+** |

## كيف يعمل

```
┌──────────────────┐    MCP protocol    ┌──────────────────┐    HTTP    ┌──────────┐
│  LLM Client      │ ◀─────────────────▶│  Synapse MCP     │ ─────────▶ │ Synapse  │
│ (Claude/Cursor)  │   (stdio/SSE/WS)   │  Server          │            │ API      │
└──────────────────┘                    └──────────────────┘            └──────────┘
```

1. تُعدّ عميل LLM (Claude Desktop، Cursor، إلخ) لاستخدام خادم Synapse MCP
2. يبدأ العميل خادم MCP (عبر `npx -y synapse-mcp-api@latest`)
3. يتصل خادم MCP بـ Synapse API باستخدام Mind Key الخاص بك
4. يرى الـ LLM جميع الأدوات الـ 79 كدوال أصلية يستطيع استدعاءها
5. عندما يحتاج الـ LLM لتذكر شيء، يستدعي `memory_store` — يترجم خادم MCP هذا إلى `POST /memory` على Synapse

## وسائل النقل

يدعم خادم Synapse MCP ثلاث وسائل نقل:

### stdio (محلي، موصى به لسطح المكتب)

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

### HTTP/SSE (بعيد، متعدد المستأجرين)

اربط عميل MCP الخاص بك بـ:

```
URL: https://synapse-mcp.schaefer.zone/sse
Headers: Authorization: Bearer YOUR_MIND_KEY
```

### WebSocket (موبايل، حجم عالي)

```
URL: wss://synapse-mcp.schaefer.zone/ws?mind_key=YOUR_MIND_KEY
```

## ملفات الأدوات (v1.4.0)

لتقليل عبء الرموز لـ LLMs أصغر، خادم MCP يدعم ثلاثة
ملفات أدوات:

| الملف | الأدوات | الرموز | الأفضل لـ |
|---------|-------|--------|----------|
| `minimal` | 8 (إرسال مركب) | ~500 | LLMs مستضافة ذاتيًا بسياق ≤8k |
| `standard` | 25 (مُسمّاة) | ~2,500 | LLMs متوسطة (Claude Haiku، GPT-3.5) |
| `full` | 119 (الكل) | ~8,250 | LLMs كبيرة (Claude Sonnet/Opus، GPT-4) — افتراضي |

التحكم عبر:

- متغير البيئة: `MCP_PROFILE=minimal|standard|full`
- الترويسة: `Mcp-Tool-Profile: minimal|standard|full`

## العملاء المدعومون

- [Claude Desktop](/docs/mcp/claude-desktop) — تطبيق سطح المكتب من Anthropic
- [Claude Code](/docs/mcp/claude-code) — وكيل برمجة طرفي
- [Cursor](/docs/mcp/cursor) — IDE ذكي مدعوم بـ AI
- [Continue.dev](/docs/mcp/continue) — مساعد برمجة ذكي مفتوح المصدر
- [Cline](/docs/mcp/claude-code) — امتداد VS Code
- أي عميل متوافق مع MCP

## لماذا تستخدم MCP بدلًا من API مباشر؟

| النهج | المزايا | العيوب |
|----------|------|------|
| API مباشر | بسيط، بلا طبقة إضافية | يحتاج LLM معرفة عناوين URL، الترويسات، المصادقة |
| MCP | يرى الـ LLM أدوات أصلية، بلا حفظ URL | عملية خادم MCP إضافية |

لمعظم حالات استخدام وكلاء LLM، MCP الخيار الأفضل — الـ LLM لا يحتاج
لتذكر مسارات API أو أنماط المصادقة.

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

- [إعداد Claude Desktop](/docs/mcp/claude-desktop) — إعداد بدقيقتين
- [إعداد Claude Code](/docs/mcp/claude-code) — تكامل الـ terminal
- [عميل MCP مخصص](/docs/mcp/custom-client) — ابنِ خاصتك