Claude Desktop'ta MCP

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.

Önkoşullar

• Claude Desktop uygulaması (macOS veya Windows)
• Node.js 18+ yüklü (node --version)
• Synapse Mind Key'iniz

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

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Dosya mevcut değilse, oluşturun.

Adım 2: Synapse MCP Sunucusu Ekleyin

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

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

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

Adım 4: Test Edin

Yeni bir sohbette şunu yazı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").

Kullanılabilir Araçlar (Seçim)

Tam liste: MCP Nedir?

Sorun Giderme

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

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

"Mind Key invalid" hatası

• SYNAPSE_MIND_KEY'in mk_ ile başladığını doğrulayın
• POST /minds ile yeni bir anahtar alın (/login'den JWT gerektirir)
• JSON'da anahtarın etrafında tırnak olmamalı

npx bulunamadı

• Node.js 18+ yükleyin: https://nodejs.org/
• Yükledikten sonra terminali yeniden başlatın
• Homebrew ile macOS'ta: brew install node

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

• SYNAPSE_URL'in erişilebilir olduğunu kontrol edin: curl https://synapse.schaefer.zone/health
• Mind Key'inizin çalıştığını doğrulayın: curl -H "Authorization: Bearer mk_..." https://synapse.schaefer.zone/memory/recall
• Bkz. MCP Sorun Giderme

Araç Profilleri (Token Tasarrufu)

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

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

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

Sonraki Adımlar

• Claude Code Kurulumu
• Cursor Kurulumu
• MCP Sorun Giderme