MCP Nedir?
Model Context Protocol, LLM'lerin harici araçları çağırmasını sağlar. Synapse resmi MCP sunucusu üzerinden 79 araç sunar.
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 │
└──────────────────┘ └──────────────────┘ └──────────┘- LLM istemcinizi (Claude Desktop, Cursor vb.) Synapse MCP sunucusunu kullanacak şekilde yapılandırırsınız
- İstemci MCP sunucusunu başlatır (
npx -y synapse-mcp-api@latestile) - MCP sunucusu Mind Key'inizi kullanarak Synapse API'ye bağlanır
- LLM tüm 79 aracı çağırabileceği yerel işlevler olarak görür
- LLM bir şeyi hatırlamak istediğinde
memory_storeçağırır — MCP sunucusu bunu Synapse'taPOST /memory'ye çevirir
Taşıyıcılar
Synapse MCP sunucusu üç taşıyıcıyı destekler:
stdio (yerel, masaüstü için önerilir)
{
"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_KEYWebSocket (mobil, yüksek hacimli)
URL: wss://synapse-mcp.schaefer.zone/ws?mind_key=YOUR_MIND_KEYAraç 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 — Anthropic'in masaüstü uygulaması
- Claude Code — terminal kodlama ajanı
- Cursor — AI destekli IDE
- Continue.dev — açık kaynaklı AI kodlama asistanı
- Cline — 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 — 2 dakikalık yapılandırma
- Claude Code Kurulumu — terminal entegrasyonu
- Özel MCP İstemcisi — kendiniz inşa edin