# MCP SSS

Synapse MCP sunucusu hakkında yaygın sorular.

## MCP nedir?

MCP (Model Context Protocol), Anthropic tarafından LLM-aracı entegrasyonu için geliştirilmiş açık bir standarttır. API docs'larını promptlara yapıştırmak yerine, araçları bir MCP sunucusuna kaydedersiniz ve LLM bunları yerel işlevler olarak çağırır.

Bkz. [MCP Nedir?](/docs/mcp/what-is-mcp).

## Synapse MCP kaç araç sunar?

12 kategoride **79 araç**: memory, chat, scheduler, tasks, scripts, computers, push, user, utility, visualization, sharing, webhooks, browser.

Tam liste için bkz. [MCP Nedir?](/docs/mcp/what-is-mcp).

## Hangi MCP istemcileri destekleniyor?

- Claude Desktop (macOS, Windows)
- Claude Code (terminal)
- Cursor (IDE)
- Continue.dev (VS Code, JetBrains)
- Cline (VS Code)
- MCP uyumlu herhangi bir istemci

Yapılandırma örnekleri için bkz. [Claude Desktop Kurulumu](/docs/mcp/claude-desktop).

## Hangi taşıyıcılar destekleniyor?

1. **stdio** (yerel, masaüstü için önerilir)
2. **HTTP/SSE** (uzak, çok kiracılı)
3. **WebSocket** (mobil, yüksek hacimli)

## Claude Desktop'ı nasıl yapılandırırım?

`claude_desktop_config.json` dosyasını düzenleyin:

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

Bkz. [Claude Desktop Kurulumu](/docs/mcp/claude-desktop).

## Araçlar Claude Desktop'da neden görünmüyor?

1. **Claude Desktop'ı tamamen yeniden başlatın** (macOS'ta Cmd+Q)
2. **Yapılandırma dosyasının geçerli JSON olduğunu kontrol edin**
3. **Node.js 18+** kurulu olduğunu doğrulayın
4. **MCP loglarını kontrol edin**: `~/Library/Logs/Claude/mcp.log`

Bkz. [MCP Sorun Giderme](/docs/mcp/troubleshooting).

## Farklı bir mind'i nasıl kullanırım?

MCP yapılandırmanızdaki `SYNAPSE_MIND_KEY` değerini değiştirin ve istemciyi yeniden başlatın.

Birden çok mind için farklı Mind Key'lerle birden çok MCP sunucu örneği çalıştırın.

## Hangi araçların sunulacağını sınırlayabilir miyim?

Evet, **Araç Profilleri** kullanın:

- `minimal`: 8 bileşik araç (~500 token)
- `standard`: 25 araç (~2,500 token)
- `full`: 119 araç (~8,250 token, varsayılan)

`MCP_PROFILE` env değişkeni veya `Mcp-Tool-Profile` başlığı ile ayarlayın.

## MCP sorunlarını nasıl hata ayıklarım?

1. **MCP sunucusunu manuel çalıştırın**: `npx -y synapse-mcp-api@latest`
2. **İstemci loglarını kontrol edin** (istemciye göre değişir)
3. **Mind Key'in çalıştığını doğrulayın**: `curl -H "Authorization: Bearer mk_..." .../memory/recall`
4. **Synapse sağlığını kontrol edin**: `curl https://synapse.schaefer.zone/health`

Bkz. [MCP Sorun Giderme](/docs/mcp/troubleshooting).

## MCP sunucusu ücretsiz mi?

Evet. `synapse-mcp-api` npm paketi açık kaynaktır. `synapse-mcp.schaefer.zone` adresindeki barındırılan MCP sunucusu herkese açık kullanım için ücretsizdir.

## MCP sunucusunu self-host edebilir miyim?

Evet:

```bash
npm install -g synapse-mcp-api
SYNAPSE_URL=https://your-synapse-instance.com \
SYNAPSE_MIND_KEY=mk_... \
synapse-mcp-api
```

## MCP, doğrudan API çağrılarından nasıl farklı?

| Yön | Doğrudan API | MCP |
|--------|-----------|-----|
| LLM'in bilmesi gereken | URL'ler, başlıklar, kimlik doğrulama | Yalnızca araç adları |
| Kimlik doğrulama yönetimi | Manuel | Otomatik (env değişkeni) |
| Araç keşfi | /endpoints okuma | MCP protokolü üzerinden otomatik |
| Hata yönetimi | Manuel | Standartlaştırılmış |
| En uygun | Özel entegrasyonlar | LLM ajanları |

## Kendi MCP istemcimi inşa edebilir miyim?

Evet. Resmi MCP SDK'sını kullanın:

- TypeScript: `@modelcontextprotocol/sdk`
- Python: `mcp`

Bkz. [Özel MCP İstemcisi](/docs/mcp/custom-client).

## MCP hatalarını nasıl bildiririm?

Bir issue açın: <https://gitlab.com/schaefer-services/synapse-mcp/-/issues>

Şunları dahil edin:

- MCP sunucu sürümü
- İstemci adı ve sürümü
- İşletim sistemi
- İlgili loglar
- Yeniden üretme adımları

## Sonraki Adımlar

- [MCP Nedir?](/docs/mcp/what-is-mcp)
- [Claude Desktop Kurulumu](/docs/mcp/claude-desktop)
- [MCP Sorun Giderme](/docs/mcp/troubleshooting)