# MCP Nedir?

**Model Context Protocol (MCP)**, Anthropic (2024) tarafından LLM'lerin harici araçları yapılandırılmış bir şekilde çağırmasını sağlayan açık bir standarttır. API docs'larını prompta yapıştırmak yerine, araçları MCP sunucusuna kaydedersiniz ve LLM bunları gerektiği gibi çağırır — function calling gibi, ama standartlaştırılmış ve istemciden bağımsız.

## Synapse MCP Sunucusu

Synapse, tüm Synapse özelliklerini kapsayan **79 araç** sunan resmi bir MCP sunucusu (`npm'de synapse-mcp-api`) ile gelir:

| Kategori | Araçlar | Sayı |
|----------|-------|-------|
| Memory | 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 |
| Chat | poll, reply, status, history, unread, send, upload | 7 |
| Scheduler | cron_list, cron_create, cron_delete, cron_toggle, var_list, var_get, var_set, var_delete | 8 |
| Tasks | task_list, task_get, task_create, task_update | 4 |
| Scripts | script_list, script_get, script_info, script_store, script_delete | 5 |
| Computers | computer_list, computer_get, install_code, screenshot, command_queue, command_status, commands_list, disable, delete | 9 |
| Push | vapid_public_key, subscribe, unsubscribe, test | 4 |
| User/Mind | register, login, minds_list, mind_create, mind_delete | 5 |
| Utility | time, calc, random | 3 |
| Visualization | graph, tags, compact | 3 |
| Sharing | share, list, revoke | 3 |
| Webhooks | register, list, get, update, delete | 5 |
| Browser | new, navigate, click, type, screenshot, close | 6 |
| **Toplam** | | **79+** |

## Nasıl Çalışır

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

1. LLM istemcinizi (Claude Desktop, Cursor vb.) Synapse MCP sunucusunu kullanacak şekilde yapılandırırsınız
2. İstemci MCP sunucusunu başlatır (`npx -y synapse-mcp-api@latest` ile)
3. MCP sunucusu Mind Key'inizi kullanarak Synapse API'ye bağlanır
4. LLM tüm 79 aracı çağırabileceği yerel işlevler olarak görür
5. LLM bir şeyi hatırlamak istediğinde `memory_store` çağırır — MCP sunucusu bunu Synapse'ta `POST /memory`'ye çevirir

## Taşıyıcılar

Synapse MCP sunucusu üç taşıyıcıyı destekler:

### stdio (yerel, masaüstü için önerilir)

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

### HTTP/SSE (uzak, çok kiracılı)

MCP istemcinizi şuraya bağlayın:

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

### WebSocket (mobil, yüksek hacimli)

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

## Araç Profilleri (v1.4.0)

Daha küçük LLM'ler için token ek yükünü azaltmak amacıyla MCP sunucusu üç araç profili destekler:

| Profil | Araçlar | Token'lar | En Uygun |
|---------|-------|--------|----------|
| `minimal` | 8 (bileşik dispatch) | ~500 | ≤8k bağlamlı self-hosted LLM'ler |
| `standard` | 25 (adlandırılmış) | ~2,500 | Orta boyutlu LLM'ler (Claude Haiku, GPT-3.5) |
| `full` | 119 (tümü) | ~8,250 | Büyük LLM'ler (Claude Sonnet/Opus, GPT-4) — varsayılan |

Şununla kontrol edin:

- Env değişkeni: `MCP_PROFILE=minimal|standard|full`
- Başlık: `Mcp-Tool-Profile: minimal|standard|full`

## Desteklenen İstemciler

- [Claude Desktop](/docs/mcp/claude-desktop) — Anthropic'in masaüstü uygulaması
- [Claude Code](/docs/mcp/claude-code) — terminal kodlama ajanı
- [Cursor](/docs/mcp/cursor) — AI destekli IDE
- [Continue.dev](/docs/mcp/continue) — açık kaynaklı AI kodlama asistanı
- [Cline](/docs/mcp/claude-code) — VS Code uzantısı
- MCP uyumlu herhangi bir istemci

## Doğrudan API Yerine Neden MCP?

| Yaklaşım | Artıları | Eksileri |
|----------|------|------|
| Doğrudan API | Basit, ekstra katman yok | LLM URL'leri, başlıkları, kimlik doğrulamayı bilmeli |
| MCP | LLM yerel araçları görür, URL ezberleme yok | Ekstra MCP sunucu süreci |

Çoğu LLM ajan kullanım senaryosu için MCP daha iyi bir seçimdir — LLM API yollarını veya kimlik doğrulama desenlerini hatırlamak zorunda değildir.

## Sonraki Adımlar

- [Claude Desktop Kurulumu](/docs/mcp/claude-desktop) — 2 dakikalık yapılandırma
- [Claude Code Kurulumu](/docs/mcp/claude-code) — terminal entegrasyonu
- [Özel MCP İstemcisi](/docs/mcp/custom-client) — kendiniz inşa edin