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?.

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?.

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.

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:

{
  "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.

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.

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.

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:

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.

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?
• Claude Desktop Kurulumu
• MCP Sorun Giderme