# 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

```json
{
  "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"
      }
    }
  }
}
```

> [!TIP]
> 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

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)

| Araç | Açıklama |
|------|-------------|
| `memory_recall` | Tüm bellekleri geri çağır |
| `memory_store` | Yeni bir bellek sakla |
| `memory_search` | Bellekleri ara |
| `task_list` | Görevleri listele |
| `task_create` | Bir görev oluştur |
| `chat_poll` | Yeni mesajları kontrol et |
| `chat_reply` | Bir mesaja yanıtla |
| `browser_new` | Bir tarayıcı sekmesi aç |
| `computer_list` | Kayıtlı bilgisayarları listele |

Tam liste: [MCP Nedir?](/docs/mcp/what-is-mcp)

## 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](/docs/mcp/troubleshooting)

## 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:

```json
{
  "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](/docs/mcp/claude-code)
- [Cursor Kurulumu](/docs/mcp/cursor)
- [MCP Sorun Giderme](/docs/mcp/troubleshooting)