Skip to main content

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      │
└──────────────────┘                    └──────────────────┘            └──────────┘
  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)

{
  "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

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