{"title":"Claude Desktop'ta MCP","slug":"claude-desktop","category":"mcp","summary":"Synapse'i 2 dakikada Claude Desktop'a bağlayın. Claude 79 Synapse aracını yerel olarak alır.","audience":["human","llm"],"tags":["mcp","claude","desktop","integration"],"difficulty":"beginner","updated":"2026-06-27","word_count":367,"read_minutes":2,"llm_context":"Config file: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)\n %APPDATA%\\Claude\\claude_desktop_config.json (Windows)\nMCP server command: npx -y synapse-mcp-api@latest\nEnv vars: SYNAPSE_MIND_KEY (required), SYNAPSE_URL (optional, default https://synapse.schaefer.zone)\nAfter config: restart Claude Desktop, check for 🔌 icon with \"79 tools\"\nTest: type \"memory_recall aufrufen\" in a new chat\nTroubleshooting: Node.js ≥ 18, check Mind Key, see /docs/mcp/troubleshooting\n","lang":"tr","translated":true,"requested_lang":"tr","content_markdown":"\n# Claude Desktop'ta MCP\n\nClaude Desktop, Anthropic'in macOS ve Windows için masaüstü uygulamasıdır. Synapse MCP sunucusu yapılandırıldığında, Claude tüm 79 Synapse aracına yerel erişim kazanır — bellek saklayabilir, geri çağırabilir, görevleri yönetebilir, sizinle sohbet edebilir ve daha fazlasını yapabilir.\n\n## Önkoşullar\n\n- Claude Desktop uygulaması (macOS veya Windows)\n- Node.js 18+ yüklü (`node --version`)\n- Synapse Mind Key'iniz\n\n## Adım 1: Yapılandırma Dosyasını Açın\n\n- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\nDosya mevcut değilse, oluşturun.\n\n## Adım 2: Synapse MCP Sunucusu Ekleyin\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_YOUR_MIND_KEY_HERE\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n }\n }\n }\n}\n```\n\n> [!TIP]\n> Halihazırda diğer MCP sunucuları yapılandırılmışsa, mevcut `\"mcpServers\"` nesnesinin içine `\"synapse\"` bloğunu eklemeniz yeterlidir.\n\n## Adım 3: Claude Desktop'ı Yeniden Başlatın\n\n1. Claude Desktop'ı tamamen kapatın (macOS'ta Cmd+Q, sadece pencereyi kapatmak değil)\n2. Claude Desktop'ı yeniden açın\n3. Yeni bir sohbet başlatın\n4. Sol alttaki 🔌 fiş simgesini arayın — \"79 tools\" demeli\n\n## Adım 4: Test Edin\n\nYeni bir sohbette şunu yazın:\n\n```\nmemory_recall aufrufen\n```\n\nClaude `memory_recall` aracını çağırmalı ve sakladığınız belleklerin özetiyle yanıt vermelidir (veya mind boşsa \"No memories yet\").\n\n## Kullanılabilir Araçlar (Seçim)\n\n| Araç | Açıklama |\n|------|-------------|\n| `memory_recall` | Tüm bellekleri geri çağır |\n| `memory_store` | Yeni bir bellek sakla |\n| `memory_search` | Bellekleri ara |\n| `task_list` | Görevleri listele |\n| `task_create` | Bir görev oluştur |\n| `chat_poll` | Yeni mesajları kontrol et |\n| `chat_reply` | Bir mesaja yanıtla |\n| `browser_new` | Bir tarayıcı sekmesi aç |\n| `computer_list` | Kayıtlı bilgisayarları listele |\n\nTam liste: [MCP Nedir?](/docs/mcp/what-is-mcp)\n\n## Sorun Giderme\n\n### Claude Desktop'da hiç araç görünmüyor\n\n1. Node.js sürümünü doğrulayın: `node --version` (≥ 18 olmalı)\n2. Yapılandırma dosyasının geçerli JSON olduğunu kontrol edin (sonda virgül yok)\n3. Claude Desktop'ı tamamen yeniden başlatın (Cmd+Q, sadece kapatmak değil)\n4. Claude Desktop loglarını kontrol edin: `~/Library/Logs/Claude/mcp.log` (macOS)\n\n### \"Mind Key invalid\" hatası\n\n- `SYNAPSE_MIND_KEY`'in `mk_` ile başladığını doğrulayın\n- `POST /minds` ile yeni bir anahtar alın (`/login`'den JWT gerektirir)\n- JSON'da anahtarın etrafında tırnak olmamalı\n\n### npx bulunamadı\n\n- Node.js 18+ yükleyin: \n- Yükledikten sonra terminali yeniden başlatın\n- Homebrew ile macOS'ta: `brew install node`\n\n### Araçlar görünüyor ama çağrılar başarısız\n\n- `SYNAPSE_URL`'in erişilebilir olduğunu kontrol edin: `curl https://synapse.schaefer.zone/health`\n- Mind Key'inizin çalıştığını doğrulayın: `curl -H \"Authorization: Bearer mk_...\" https://synapse.schaefer.zone/memory/recall`\n- Bkz. [MCP Sorun Giderme](/docs/mcp/troubleshooting)\n\n## Araç Profilleri (Token Tasarrufu)\n\nDaha küçük bir LLM kullanıyorsanız veya bağlam token'larından tasarruf etmek istiyorsanız, bir araç profili ayarlayın:\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 \"MCP_PROFILE\": \"standard\"\n }\n }\n }\n}\n```\n\nProfiller: `minimal` (8 araç), `standard` (25), `full` (119, varsayılan).\n\n## Sonraki Adımlar\n\n- [Claude Code Kurulumu](/docs/mcp/claude-code)\n- [Cursor Kurulumu](/docs/mcp/cursor)\n- [MCP Sorun Giderme](/docs/mcp/troubleshooting)\n","content_html":"

Claude Desktop'ta MCP

\n

Claude Desktop, Anthropic'in macOS ve Windows için masaüstü uygulamasıdır. Synapse MCP sunucusu yapılandırıldığında, Claude tüm 79 Synapse aracına yerel erişim kazanır — bellek saklayabilir, geri çağırabilir, görevleri yönetebilir, sizinle sohbet edebilir ve daha fazlasını yapabilir.

\n

Önkoşullar

\n\n

Adım 1: Yapılandırma Dosyasını Açın

\n\n

Dosya mevcut değilse, oluşturun.

\n

Adım 2: Synapse MCP Sunucusu Ekleyin

\n
{\n  "mcpServers": {\n    "synapse": {\n      "command": "npx",\n      "args": ["-y", "synapse-mcp-api@latest"],\n      "env": {\n        "SYNAPSE_MIND_KEY": "mk_YOUR_MIND_KEY_HERE",\n        "SYNAPSE_URL": "https://synapse.schaefer.zone"\n      }\n    }\n  }\n}
Halihazırda diğer MCP sunucuları yapılandırılmışsa, mevcut `\"mcpServers\"` nesnesinin içine `\"synapse\"` bloğunu eklemeniz yeterlidir.

Adım 3: Claude Desktop'ı Yeniden Başlatın

\n
    \n
  1. Claude Desktop'ı tamamen kapatın (macOS'ta Cmd+Q, sadece pencereyi kapatmak değil)
    2. \n
  2. Claude Desktop'ı yeniden açın
    3. \n
  3. Yeni bir sohbet başlatın
    4. \n
  4. Sol alttaki 🔌 fiş simgesini arayın — "79 tools" demeli
    5. \n
\n

Adım 4: Test Edin

\n

Yeni bir sohbette şunu yazın:

\n
memory_recall aufrufen

Claude memory_recall aracını çağırmalı ve sakladığınız belleklerin özetiyle yanıt vermelidir (veya mind boşsa "No memories yet").

\n

Kullanılabilir Araçlar (Seçim)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
AraçAçıklama
memory_recallTüm bellekleri geri çağır
memory_storeYeni bir bellek sakla
memory_searchBellekleri ara
task_listGörevleri listele
task_createBir görev oluştur
chat_pollYeni mesajları kontrol et
chat_replyBir mesaja yanıtla
browser_newBir tarayıcı sekmesi aç
computer_listKayıtlı bilgisayarları listele
\n

Tam liste: MCP Nedir?

\n

Sorun Giderme

\n

Claude Desktop'da hiç araç görünmüyor

\n
    \n
  1. Node.js sürümünü doğrulayın: node --version (≥ 18 olmalı)
    2. \n
  2. Yapılandırma dosyasının geçerli JSON olduğunu kontrol edin (sonda virgül yok)
    3. \n
  3. Claude Desktop'ı tamamen yeniden başlatın (Cmd+Q, sadece kapatmak değil)
    4. \n
  4. Claude Desktop loglarını kontrol edin: ~/Library/Logs/Claude/mcp.log (macOS)
    5. \n
\n

"Mind Key invalid" hatası

\n\n

npx bulunamadı

\n\n

Araçlar görünüyor ama çağrılar başarısız

\n\n

Araç Profilleri (Token Tasarrufu)

\n

Daha küçük bir LLM kullanıyorsanız veya bağlam token'larından tasarruf etmek istiyorsanız, bir araç profili ayarlayın:

\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        "MCP_PROFILE": "standard"\n      }\n    }\n  }\n}

Profiller: minimal (8 araç), standard (25), full (119, varsayılan).

\n

Sonraki Adımlar

\n\n","urls":{"html":"/docs/mcp/claude-desktop","text":"/docs/mcp/claude-desktop?format=text","json":"/docs/mcp/claude-desktop?format=json","llm":"/docs/mcp/claude-desktop?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}