{"title":"MCP SSS","slug":"mcp-faq","category":"faq","summary":"MCP entegrasyonu hakkında yaygın sorular — araçlar, taşıyıcılar, sorun giderme.","audience":["human","llm"],"tags":["faq","mcp","troubleshooting"],"difficulty":"beginner","updated":"2026-06-27","word_count":427,"read_minutes":2,"lang":"tr","translated":true,"requested_lang":"tr","content_markdown":"\n# MCP SSS\n\nSynapse MCP sunucusu hakkında yaygın sorular.\n\n## MCP nedir?\n\nMCP (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.\n\nBkz. [MCP Nedir?](/docs/mcp/what-is-mcp).\n\n## Synapse MCP kaç araç sunar?\n\n12 kategoride **79 araç**: memory, chat, scheduler, tasks, scripts, computers, push, user, utility, visualization, sharing, webhooks, browser.\n\nTam liste için bkz. [MCP Nedir?](/docs/mcp/what-is-mcp).\n\n## Hangi MCP istemcileri destekleniyor?\n\n- Claude Desktop (macOS, Windows)\n- Claude Code (terminal)\n- Cursor (IDE)\n- Continue.dev (VS Code, JetBrains)\n- Cline (VS Code)\n- MCP uyumlu herhangi bir istemci\n\nYapılandırma örnekleri için bkz. [Claude Desktop Kurulumu](/docs/mcp/claude-desktop).\n\n## Hangi taşıyıcılar destekleniyor?\n\n1. **stdio** (yerel, masaüstü için önerilir)\n2. **HTTP/SSE** (uzak, çok kiracılı)\n3. **WebSocket** (mobil, yüksek hacimli)\n\n## Claude Desktop'ı nasıl yapılandırırım?\n\n`claude_desktop_config.json` dosyasını düzenleyin:\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_KEY\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n }\n }\n }\n}\n```\n\nBkz. [Claude Desktop Kurulumu](/docs/mcp/claude-desktop).\n\n## Araçlar Claude Desktop'da neden görünmüyor?\n\n1. **Claude Desktop'ı tamamen yeniden başlatın** (macOS'ta Cmd+Q)\n2. **Yapılandırma dosyasının geçerli JSON olduğunu kontrol edin**\n3. **Node.js 18+** kurulu olduğunu doğrulayın\n4. **MCP loglarını kontrol edin**: `~/Library/Logs/Claude/mcp.log`\n\nBkz. [MCP Sorun Giderme](/docs/mcp/troubleshooting).\n\n## Farklı bir mind'i nasıl kullanırım?\n\nMCP yapılandırmanızdaki `SYNAPSE_MIND_KEY` değerini değiştirin ve istemciyi yeniden başlatın.\n\nBirden çok mind için farklı Mind Key'lerle birden çok MCP sunucu örneği çalıştırın.\n\n## Hangi araçların sunulacağını sınırlayabilir miyim?\n\nEvet, **Araç Profilleri** kullanın:\n\n- `minimal`: 8 bileşik araç (~500 token)\n- `standard`: 25 araç (~2,500 token)\n- `full`: 119 araç (~8,250 token, varsayılan)\n\n`MCP_PROFILE` env değişkeni veya `Mcp-Tool-Profile` başlığı ile ayarlayın.\n\n## MCP sorunlarını nasıl hata ayıklarım?\n\n1. **MCP sunucusunu manuel çalıştırın**: `npx -y synapse-mcp-api@latest`\n2. **İstemci loglarını kontrol edin** (istemciye göre değişir)\n3. **Mind Key'in çalıştığını doğrulayın**: `curl -H \"Authorization: Bearer mk_...\" .../memory/recall`\n4. **Synapse sağlığını kontrol edin**: `curl https://synapse.schaefer.zone/health`\n\nBkz. [MCP Sorun Giderme](/docs/mcp/troubleshooting).\n\n## MCP sunucusu ücretsiz mi?\n\nEvet. `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.\n\n## MCP sunucusunu self-host edebilir miyim?\n\nEvet:\n\n```bash\nnpm install -g synapse-mcp-api\nSYNAPSE_URL=https://your-synapse-instance.com \\\nSYNAPSE_MIND_KEY=mk_... \\\nsynapse-mcp-api\n```\n\n## MCP, doğrudan API çağrılarından nasıl farklı?\n\n| Yön | Doğrudan API | MCP |\n|--------|-----------|-----|\n| LLM'in bilmesi gereken | URL'ler, başlıklar, kimlik doğrulama | Yalnızca araç adları |\n| Kimlik doğrulama yönetimi | Manuel | Otomatik (env değişkeni) |\n| Araç keşfi | /endpoints okuma | MCP protokolü üzerinden otomatik |\n| Hata yönetimi | Manuel | Standartlaştırılmış |\n| En uygun | Özel entegrasyonlar | LLM ajanları |\n\n## Kendi MCP istemcimi inşa edebilir miyim?\n\nEvet. Resmi MCP SDK'sını kullanın:\n\n- TypeScript: `@modelcontextprotocol/sdk`\n- Python: `mcp`\n\nBkz. [Özel MCP İstemcisi](/docs/mcp/custom-client).\n\n## MCP hatalarını nasıl bildiririm?\n\nBir issue açın: \n\nŞunları dahil edin:\n\n- MCP sunucu sürümü\n- İstemci adı ve sürümü\n- İşletim sistemi\n- İlgili loglar\n- Yeniden üretme adımları\n\n## Sonraki Adımlar\n\n- [MCP Nedir?](/docs/mcp/what-is-mcp)\n- [Claude Desktop Kurulumu](/docs/mcp/claude-desktop)\n- [MCP Sorun Giderme](/docs/mcp/troubleshooting)\n","content_html":"

MCP SSS

\n

Synapse MCP sunucusu hakkında yaygın sorular.

\n

MCP nedir?

\n

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.

\n

Bkz. MCP Nedir?.

\n

Synapse MCP kaç araç sunar?

\n

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

\n

Tam liste için bkz. MCP Nedir?.

\n

Hangi MCP istemcileri destekleniyor?

\n\n

Yapılandırma örnekleri için bkz. Claude Desktop Kurulumu.

\n

Hangi taşıyıcılar destekleniyor?

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

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

\n

claude_desktop_config.json dosyasını düzenleyin:

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

Bkz. Claude Desktop Kurulumu.

\n

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

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

Bkz. MCP Sorun Giderme.

\n

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

\n

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

\n

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

\n

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

\n

Evet, Araç Profilleri kullanın:

\n\n

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

\n

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

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

Bkz. MCP Sorun Giderme.

\n

MCP sunucusu ücretsiz mi?

\n

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.

\n

MCP sunucusunu self-host edebilir miyim?

\n

Evet:

\n
npm install -g synapse-mcp-api\nSYNAPSE_URL=https://your-synapse-instance.com \\\nSYNAPSE_MIND_KEY=mk_... \\\nsynapse-mcp-api

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

\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
YönDoğrudan APIMCP
LLM'in bilmesi gerekenURL'ler, başlıklar, kimlik doğrulamaYalnızca araç adları
Kimlik doğrulama yönetimiManuelOtomatik (env değişkeni)
Araç keşfi/endpoints okumaMCP protokolü üzerinden otomatik
Hata yönetimiManuelStandartlaştırılmış
En uygunÖzel entegrasyonlarLLM ajanları
\n

Kendi MCP istemcimi inşa edebilir miyim?

\n

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

\n\n

Bkz. Özel MCP İstemcisi.

\n

MCP hatalarını nasıl bildiririm?

\n

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

\n

Şunları dahil edin:

\n\n

Sonraki Adımlar

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