{"title":"MCP Nedir?","slug":"what-is-mcp","category":"mcp","summary":"Model Context Protocol, LLM'lerin harici araçları çağırmasını sağlar. Synapse resmi MCP sunucusu üzerinden 79 araç sunar.","audience":["human","llm"],"tags":["mcp","intro","overview"],"difficulty":"beginner","updated":"2026-06-27","word_count":538,"read_minutes":3,"llm_context":"MCP = Model Context Protocol (Anthropic, 2024). Open standard for LLM-tool integration.\nSynapse has official MCP server: synapse-mcp-api (npm package, npx -y synapse-mcp-api@latest)\n79 tools exposed: 22 memory, 7 chat, 8 scheduler, 4 tasks, 5 scripts, 9 computers, 4 push, 5 user, 3 utility\n3 transports: stdio (local), HTTP/SSE (remote), WebSocket (mobile)\nSupported clients: Claude Desktop, Claude Code, Cursor, Continue, Cline, any MCP-compatible client\nTool Profiles (v1.4.0): minimal (8 tools), standard (25), full (119) — controlled via MCP_PROFILE env or Mcp-Tool-Profile header\n","lang":"tr","translated":true,"requested_lang":"tr","content_markdown":"\n# MCP Nedir?\n\n**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.\n\n## Synapse MCP Sunucusu\n\nSynapse, tüm Synapse özelliklerini kapsayan **79 araç** sunan resmi bir MCP sunucusu (`npm'de synapse-mcp-api`) ile gelir:\n\n| Kategori | Araçlar | Sayı |\n|----------|-------|-------|\n| 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 |\n| Chat | poll, reply, status, history, unread, send, upload | 7 |\n| Scheduler | cron_list, cron_create, cron_delete, cron_toggle, var_list, var_get, var_set, var_delete | 8 |\n| Tasks | task_list, task_get, task_create, task_update | 4 |\n| Scripts | script_list, script_get, script_info, script_store, script_delete | 5 |\n| Computers | computer_list, computer_get, install_code, screenshot, command_queue, command_status, commands_list, disable, delete | 9 |\n| Push | vapid_public_key, subscribe, unsubscribe, test | 4 |\n| User/Mind | register, login, minds_list, mind_create, mind_delete | 5 |\n| Utility | time, calc, random | 3 |\n| Visualization | graph, tags, compact | 3 |\n| Sharing | share, list, revoke | 3 |\n| Webhooks | register, list, get, update, delete | 5 |\n| Browser | new, navigate, click, type, screenshot, close | 6 |\n| **Toplam** | | **79+** |\n\n## Nasıl Çalışır\n\n```\n┌──────────────────┐    MCP protocol    ┌──────────────────┐    HTTP    ┌──────────┐\n│  LLM Client      │ ◀─────────────────▶│  Synapse MCP     │ ─────────▶ │ Synapse  │\n│ (Claude/Cursor)  │   (stdio/SSE/WS)   │  Server          │            │ API      │\n└──────────────────┘                    └──────────────────┘            └──────────┘\n```\n\n1. LLM istemcinizi (Claude Desktop, Cursor vb.) Synapse MCP sunucusunu kullanacak şekilde yapılandırırsınız\n2. İstemci MCP sunucusunu başlatır (`npx -y synapse-mcp-api@latest` ile)\n3. MCP sunucusu Mind Key'inizi kullanarak Synapse API'ye bağlanır\n4. LLM tüm 79 aracı çağırabileceği yerel işlevler olarak görür\n5. LLM bir şeyi hatırlamak istediğinde `memory_store` çağırır — MCP sunucusu bunu Synapse'ta `POST /memory`'ye çevirir\n\n## Taşıyıcılar\n\nSynapse MCP sunucusu üç taşıyıcıyı destekler:\n\n### stdio (yerel, masaüstü için önerilir)\n\n```json\n{\n  \"mcpServers\": {\n    \"synapse\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"synapse-mcp-api@latest\"],\n      \"env\": {\n        \"SYNAPSE_MIND_KEY\": \"mk_...\",\n        \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n      }\n    }\n  }\n}\n```\n\n### HTTP/SSE (uzak, çok kiracılı)\n\nMCP istemcinizi şuraya bağlayın:\n\n```\nURL: https://synapse-mcp.schaefer.zone/sse\nHeaders: Authorization: Bearer YOUR_MIND_KEY\n```\n\n### WebSocket (mobil, yüksek hacimli)\n\n```\nURL: wss://synapse-mcp.schaefer.zone/ws?mind_key=YOUR_MIND_KEY\n```\n\n## Araç Profilleri (v1.4.0)\n\nDaha küçük LLM'ler için token ek yükünü azaltmak amacıyla MCP sunucusu üç araç profili destekler:\n\n| Profil | Araçlar | Token'lar | En Uygun |\n|---------|-------|--------|----------|\n| `minimal` | 8 (bileşik dispatch) | ~500 | ≤8k bağlamlı self-hosted LLM'ler |\n| `standard` | 25 (adlandırılmış) | ~2,500 | Orta boyutlu LLM'ler (Claude Haiku, GPT-3.5) |\n| `full` | 119 (tümü) | ~8,250 | Büyük LLM'ler (Claude Sonnet/Opus, GPT-4) — varsayılan |\n\nŞununla kontrol edin:\n\n- Env değişkeni: `MCP_PROFILE=minimal|standard|full`\n- Başlık: `Mcp-Tool-Profile: minimal|standard|full`\n\n## Desteklenen İstemciler\n\n- [Claude Desktop](/docs/mcp/claude-desktop) — Anthropic'in masaüstü uygulaması\n- [Claude Code](/docs/mcp/claude-code) — terminal kodlama ajanı\n- [Cursor](/docs/mcp/cursor) — AI destekli IDE\n- [Continue.dev](/docs/mcp/continue) — açık kaynaklı AI kodlama asistanı\n- [Cline](/docs/mcp/claude-code) — VS Code uzantısı\n- MCP uyumlu herhangi bir istemci\n\n## Doğrudan API Yerine Neden MCP?\n\n| Yaklaşım | Artıları | Eksileri |\n|----------|------|------|\n| Doğrudan API | Basit, ekstra katman yok | LLM URL'leri, başlıkları, kimlik doğrulamayı bilmeli |\n| MCP | LLM yerel araçları görür, URL ezberleme yok | Ekstra MCP sunucu süreci |\n\nÇ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.\n\n## Sonraki Adımlar\n\n- [Claude Desktop Kurulumu](/docs/mcp/claude-desktop) — 2 dakikalık yapılandırma\n- [Claude Code Kurulumu](/docs/mcp/claude-code) — terminal entegrasyonu\n- [Özel MCP İstemcisi](/docs/mcp/custom-client) — kendiniz inşa edin\n","content_html":"<h1>MCP Nedir?</h1>\n<p><strong>Model Context Protocol (MCP)</strong>, Anthropic (2024) tarafından LLM&#39;lerin harici araçları yapılandırılmış bir şekilde çağırmasını sağlayan açık bir standarttır. API docs&#39;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.</p>\n<h2>Synapse MCP Sunucusu</h2>\n<p>Synapse, tüm Synapse özelliklerini kapsayan <strong>79 araç</strong> sunan resmi bir MCP sunucusu (<code>npm&#39;de synapse-mcp-api</code>) ile gelir:</p>\n<table>\n<thead>\n<tr>\n<th>Kategori</th>\n<th>Araçlar</th>\n<th>Sayı</th>\n</tr>\n</thead>\n<tbody><tr>\n<td>Memory</td>\n<td>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</td>\n<td>22</td>\n</tr>\n<tr>\n<td>Chat</td>\n<td>poll, reply, status, history, unread, send, upload</td>\n<td>7</td>\n</tr>\n<tr>\n<td>Scheduler</td>\n<td>cron_list, cron_create, cron_delete, cron_toggle, var_list, var_get, var_set, var_delete</td>\n<td>8</td>\n</tr>\n<tr>\n<td>Tasks</td>\n<td>task_list, task_get, task_create, task_update</td>\n<td>4</td>\n</tr>\n<tr>\n<td>Scripts</td>\n<td>script_list, script_get, script_info, script_store, script_delete</td>\n<td>5</td>\n</tr>\n<tr>\n<td>Computers</td>\n<td>computer_list, computer_get, install_code, screenshot, command_queue, command_status, commands_list, disable, delete</td>\n<td>9</td>\n</tr>\n<tr>\n<td>Push</td>\n<td>vapid_public_key, subscribe, unsubscribe, test</td>\n<td>4</td>\n</tr>\n<tr>\n<td>User/Mind</td>\n<td>register, login, minds_list, mind_create, mind_delete</td>\n<td>5</td>\n</tr>\n<tr>\n<td>Utility</td>\n<td>time, calc, random</td>\n<td>3</td>\n</tr>\n<tr>\n<td>Visualization</td>\n<td>graph, tags, compact</td>\n<td>3</td>\n</tr>\n<tr>\n<td>Sharing</td>\n<td>share, list, revoke</td>\n<td>3</td>\n</tr>\n<tr>\n<td>Webhooks</td>\n<td>register, list, get, update, delete</td>\n<td>5</td>\n</tr>\n<tr>\n<td>Browser</td>\n<td>new, navigate, click, type, screenshot, close</td>\n<td>6</td>\n</tr>\n<tr>\n<td><strong>Toplam</strong></td>\n<td></td>\n<td><strong>79+</strong></td>\n</tr>\n</tbody></table>\n<h2>Nasıl Çalışır</h2>\n<pre><code class=\"hljs language-plaintext\">┌──────────────────┐    MCP protocol    ┌──────────────────┐    HTTP    ┌──────────┐\n│  LLM Client      │ ◀─────────────────▶│  Synapse MCP     │ ─────────▶ │ Synapse  │\n│ (Claude/Cursor)  │   (stdio/SSE/WS)   │  Server          │            │ API      │\n└──────────────────┘                    └──────────────────┘            └──────────┘</code></pre><ol>\n<li>LLM istemcinizi (Claude Desktop, Cursor vb.) Synapse MCP sunucusunu kullanacak şekilde yapılandırırsınız</li>\n<li>İstemci MCP sunucusunu başlatır (<code>npx -y synapse-mcp-api@latest</code> ile)</li>\n<li>MCP sunucusu Mind Key&#39;inizi kullanarak Synapse API&#39;ye bağlanır</li>\n<li>LLM tüm 79 aracı çağırabileceği yerel işlevler olarak görür</li>\n<li>LLM bir şeyi hatırlamak istediğinde <code>memory_store</code> çağırır — MCP sunucusu bunu Synapse&#39;ta <code>POST /memory</code>&#39;ye çevirir</li>\n</ol>\n<h2>Taşıyıcılar</h2>\n<p>Synapse MCP sunucusu üç taşıyıcıyı destekler:</p>\n<h3>stdio (yerel, masaüstü için önerilir)</h3>\n<pre><code class=\"hljs language-json\"><span class=\"hljs-punctuation\">{</span>\n  <span class=\"hljs-attr\">&quot;mcpServers&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">{</span>\n    <span class=\"hljs-attr\">&quot;synapse&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">{</span>\n      <span class=\"hljs-attr\">&quot;command&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;npx&quot;</span><span class=\"hljs-punctuation\">,</span>\n      <span class=\"hljs-attr\">&quot;args&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">[</span><span class=\"hljs-string\">&quot;-y&quot;</span><span class=\"hljs-punctuation\">,</span> <span class=\"hljs-string\">&quot;synapse-mcp-api@latest&quot;</span><span class=\"hljs-punctuation\">]</span><span class=\"hljs-punctuation\">,</span>\n      <span class=\"hljs-attr\">&quot;env&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">{</span>\n        <span class=\"hljs-attr\">&quot;SYNAPSE_MIND_KEY&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;mk_...&quot;</span><span class=\"hljs-punctuation\">,</span>\n        <span class=\"hljs-attr\">&quot;SYNAPSE_URL&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;https://synapse.schaefer.zone&quot;</span>\n      <span class=\"hljs-punctuation\">}</span>\n    <span class=\"hljs-punctuation\">}</span>\n  <span class=\"hljs-punctuation\">}</span>\n<span class=\"hljs-punctuation\">}</span></code></pre><h3>HTTP/SSE (uzak, çok kiracılı)</h3>\n<p>MCP istemcinizi şuraya bağlayın:</p>\n<pre><code class=\"hljs language-plaintext\">URL: https://synapse-mcp.schaefer.zone/sse\nHeaders: Authorization: Bearer YOUR_MIND_KEY</code></pre><h3>WebSocket (mobil, yüksek hacimli)</h3>\n<pre><code class=\"hljs language-plaintext\">URL: wss://synapse-mcp.schaefer.zone/ws?mind_key=YOUR_MIND_KEY</code></pre><h2>Araç Profilleri (v1.4.0)</h2>\n<p>Daha küçük LLM&#39;ler için token ek yükünü azaltmak amacıyla MCP sunucusu üç araç profili destekler:</p>\n<table>\n<thead>\n<tr>\n<th>Profil</th>\n<th>Araçlar</th>\n<th>Token&#39;lar</th>\n<th>En Uygun</th>\n</tr>\n</thead>\n<tbody><tr>\n<td><code>minimal</code></td>\n<td>8 (bileşik dispatch)</td>\n<td>~500</td>\n<td>≤8k bağlamlı self-hosted LLM&#39;ler</td>\n</tr>\n<tr>\n<td><code>standard</code></td>\n<td>25 (adlandırılmış)</td>\n<td>~2,500</td>\n<td>Orta boyutlu LLM&#39;ler (Claude Haiku, GPT-3.5)</td>\n</tr>\n<tr>\n<td><code>full</code></td>\n<td>119 (tümü)</td>\n<td>~8,250</td>\n<td>Büyük LLM&#39;ler (Claude Sonnet/Opus, GPT-4) — varsayılan</td>\n</tr>\n</tbody></table>\n<p>Şununla kontrol edin:</p>\n<ul>\n<li>Env değişkeni: <code>MCP_PROFILE=minimal|standard|full</code></li>\n<li>Başlık: <code>Mcp-Tool-Profile: minimal|standard|full</code></li>\n</ul>\n<h2>Desteklenen İstemciler</h2>\n<ul>\n<li><a href=\"/docs/mcp/claude-desktop\">Claude Desktop</a> — Anthropic&#39;in masaüstü uygulaması</li>\n<li><a href=\"/docs/mcp/claude-code\">Claude Code</a> — terminal kodlama ajanı</li>\n<li><a href=\"/docs/mcp/cursor\">Cursor</a> — AI destekli IDE</li>\n<li><a href=\"/docs/mcp/continue\">Continue.dev</a> — açık kaynaklı AI kodlama asistanı</li>\n<li><a href=\"/docs/mcp/claude-code\">Cline</a> — VS Code uzantısı</li>\n<li>MCP uyumlu herhangi bir istemci</li>\n</ul>\n<h2>Doğrudan API Yerine Neden MCP?</h2>\n<table>\n<thead>\n<tr>\n<th>Yaklaşım</th>\n<th>Artıları</th>\n<th>Eksileri</th>\n</tr>\n</thead>\n<tbody><tr>\n<td>Doğrudan API</td>\n<td>Basit, ekstra katman yok</td>\n<td>LLM URL&#39;leri, başlıkları, kimlik doğrulamayı bilmeli</td>\n</tr>\n<tr>\n<td>MCP</td>\n<td>LLM yerel araçları görür, URL ezberleme yok</td>\n<td>Ekstra MCP sunucu süreci</td>\n</tr>\n</tbody></table>\n<p>Ç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.</p>\n<h2>Sonraki Adımlar</h2>\n<ul>\n<li><a href=\"/docs/mcp/claude-desktop\">Claude Desktop Kurulumu</a> — 2 dakikalık yapılandırma</li>\n<li><a href=\"/docs/mcp/claude-code\">Claude Code Kurulumu</a> — terminal entegrasyonu</li>\n<li><a href=\"/docs/mcp/custom-client\">Özel MCP İstemcisi</a> — kendiniz inşa edin</li>\n</ul>\n","urls":{"html":"/docs/mcp/what-is-mcp","text":"/docs/mcp/what-is-mcp?format=text","json":"/docs/mcp/what-is-mcp?format=json","llm":"/docs/mcp/what-is-mcp?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}