{"title":"MCP-FAQ","slug":"mcp-faq","category":"faq","summary":"Veelgestelde vragen over MCP-integratie — tools, transporten, troubleshooting.","audience":["human","llm"],"tags":["faq","mcp","troubleshooting"],"difficulty":"beginner","updated":"2026-06-27","word_count":414,"read_minutes":2,"lang":"nl","translated":true,"requested_lang":"nl","content_markdown":"\n# MCP-FAQ\n\nVeelgestelde vragen over de Synapse MCP-server.\n\n## Wat is MCP?\n\nMCP (Model Context Protocol) is een open standaard van Anthropic voor LLM-tool-\nintegratie. In plaats van API-documentatie in prompts te plakken, registreert u tools\nbij een MCP-server, en de LLM roept ze aan als native functies.\n\nZie [Wat is MCP?](/docs/mcp/what-is-mcp).\n\n## Hoeveel tools stelt Synapse MCP beschikbaar?\n\n**79 tools** in 12 categorieën: memory, chat, scheduler, tasks, scripts,\ncomputers, push, user, utility, visualization, sharing, webhooks, browser.\n\nZie [Wat is MCP?](/docs/mcp/what-is-mcp) voor de volledige lijst.\n\n## Welke MCP-clients worden ondersteund?\n\n- Claude Desktop (macOS, Windows)\n- Claude Code (terminal)\n- Cursor (IDE)\n- Continue.dev (VS Code, JetBrains)\n- Cline (VS Code)\n- Elke MCP-compatibele client\n\nZie [Claude Desktop Setup](/docs/mcp/claude-desktop) voor configuratievoorbeelden.\n\n## Welke transporten worden ondersteund?\n\n1. **stdio** (lokaal, aanbevolen voor desktop)\n2. **HTTP/SSE** (remote, multi-tenant)\n3. **WebSocket** (mobiel, hoog volume)\n\n## Hoe configureer ik Claude Desktop?\n\nBewerk `claude_desktop_config.json`:\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\nZie [Claude Desktop Setup](/docs/mcp/claude-desktop).\n\n## Waarom verschijnen tools niet in Claude Desktop?\n\n1. **Herstart Claude Desktop volledig** (Cmd+Q op macOS)\n2. **Controleer of configuratiebestand geldige JSON is**\n3. **Verifieer Node.js 18+** geïnstalleerd\n4. **Controleer MCP-logs**: `~/Library/Logs/Claude/mcp.log`\n\nZie [MCP Troubleshooting](/docs/mcp/troubleshooting).\n\n## Hoe gebruik ik een andere mind?\n\nWijzig `SYNAPSE_MIND_KEY` in uw MCP-configuratie en herstart de client.\n\nVoor meerdere minds, draai meerdere MCP-server-instanties met verschillende\nMind Keys.\n\n## Kan ik beperken welke tools worden getoond?\n\nJa, gebruik **Tool Profiles**:\n\n- `minimal`: 8 samengestelde tools (~500 tokens)\n- `standard`: 25 tools (~2,500 tokens)\n- `full`: 119 tools (~8,250 tokens, standaard)\n\nStel in via `MCP_PROFILE`-env-var of `Mcp-Tool-Profile`-header.\n\n## Hoe debug ik MCP-problemen?\n\n1. **Draai MCP-server handmatig**: `npx -y synapse-mcp-api@latest`\n2. **Controleer client-logs** (verschilt per client)\n3. **Verifieer dat Mind Key werkt**: `curl -H \"Authorization: Bearer mk_...\" .../memory/recall`\n4. **Controleer Synapse-gezondheid**: `curl https://synapse.schaefer.zone/health`\n\nZie [MCP Troubleshooting](/docs/mcp/troubleshooting).\n\n## Is de MCP-server gratis?\n\nJa. Het npm-pakket `synapse-mcp-api` is open source. De gehoste MCP-server\nop `synapse-mcp.schaefer.zone` is gratis voor publiek gebruik.\n\n## Kan ik de MCP-server zelf hosten?\n\nJa:\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## Hoe verschilt MCP van directe API-aanroepen?\n\n| Aspect | Directe API | MCP |\n|--------|-------------|-----|\n| LLM moet weten | URL's, headers, auth | Alleen tool-namen |\n| Auth-handling | Handmatig | Automatisch (env-var) |\n| Tool-ontdekking | Lees /endpoints | Automatisch via MCP-protocol |\n| Foutafhandeling | Handmatig | Gestandaardiseerd |\n| Geschikt voor | Aangepaste integraties | LLM-agents |\n\n## Kan ik mijn eigen MCP-client bouwen?\n\nJa. Gebruik de officiële MCP-SDK:\n\n- TypeScript: `@modelcontextprotocol/sdk`\n- Python: `mcp`\n\nZie [Aangepaste MCP-client](/docs/mcp/custom-client).\n\n## Hoe meld ik MCP-bugs?\n\nOpen een issue: \n\nVermeld:\n\n- MCP-server-versie\n- Client-naam en versie\n- Besturingssysteem\n- Relevante logs\n- Stappen om te reproduceren\n\n## Volgende stappen\n\n- [Wat is MCP?](/docs/mcp/what-is-mcp)\n- [Claude Desktop Setup](/docs/mcp/claude-desktop)\n- [MCP Troubleshooting](/docs/mcp/troubleshooting)\n","content_html":"

MCP-FAQ

\n

Veelgestelde vragen over de Synapse MCP-server.

\n

Wat is MCP?

\n

MCP (Model Context Protocol) is een open standaard van Anthropic voor LLM-tool-\nintegratie. In plaats van API-documentatie in prompts te plakken, registreert u tools\nbij een MCP-server, en de LLM roept ze aan als native functies.

\n

Zie Wat is MCP?.

\n

Hoeveel tools stelt Synapse MCP beschikbaar?

\n

79 tools in 12 categorieën: memory, chat, scheduler, tasks, scripts,\ncomputers, push, user, utility, visualization, sharing, webhooks, browser.

\n

Zie Wat is MCP? voor de volledige lijst.

\n

Welke MCP-clients worden ondersteund?

\n\n

Zie Claude Desktop Setup voor configuratievoorbeelden.

\n

Welke transporten worden ondersteund?

\n
    \n
  1. stdio (lokaal, aanbevolen voor desktop)
    2. \n
  2. HTTP/SSE (remote, multi-tenant)
    3. \n
  3. WebSocket (mobiel, hoog volume)
    4. \n
\n

Hoe configureer ik Claude Desktop?

\n

Bewerk claude_desktop_config.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}

Zie Claude Desktop Setup.

\n

Waarom verschijnen tools niet in Claude Desktop?

\n
    \n
  1. Herstart Claude Desktop volledig (Cmd+Q op macOS)
    2. \n
  2. Controleer of configuratiebestand geldige JSON is
    3. \n
  3. Verifieer Node.js 18+ geïnstalleerd
    4. \n
  4. Controleer MCP-logs: ~/Library/Logs/Claude/mcp.log
    5. \n
\n

Zie MCP Troubleshooting.

\n

Hoe gebruik ik een andere mind?

\n

Wijzig SYNAPSE_MIND_KEY in uw MCP-configuratie en herstart de client.

\n

Voor meerdere minds, draai meerdere MCP-server-instanties met verschillende\nMind Keys.

\n

Kan ik beperken welke tools worden getoond?

\n

Ja, gebruik Tool Profiles:

\n\n

Stel in via MCP_PROFILE-env-var of Mcp-Tool-Profile-header.

\n

Hoe debug ik MCP-problemen?

\n
    \n
  1. Draai MCP-server handmatig: npx -y synapse-mcp-api@latest
    2. \n
  2. Controleer client-logs (verschilt per client)
    3. \n
  3. Verifieer dat Mind Key werkt: curl -H "Authorization: Bearer mk_..." .../memory/recall
    4. \n
  4. Controleer Synapse-gezondheid: curl https://synapse.schaefer.zone/health
    5. \n
\n

Zie MCP Troubleshooting.

\n

Is de MCP-server gratis?

\n

Ja. Het npm-pakket synapse-mcp-api is open source. De gehoste MCP-server\nop synapse-mcp.schaefer.zone is gratis voor publiek gebruik.

\n

Kan ik de MCP-server zelf hosten?

\n

Ja:

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

Hoe verschilt MCP van directe API-aanroepen?

\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
AspectDirecte APIMCP
LLM moet wetenURL's, headers, authAlleen tool-namen
Auth-handlingHandmatigAutomatisch (env-var)
Tool-ontdekkingLees /endpointsAutomatisch via MCP-protocol
FoutafhandelingHandmatigGestandaardiseerd
Geschikt voorAangepaste integratiesLLM-agents
\n

Kan ik mijn eigen MCP-client bouwen?

\n

Ja. Gebruik de officiële MCP-SDK:

\n\n

Zie Aangepaste MCP-client.

\n

Hoe meld ik MCP-bugs?

\n

Open een issue: https://gitlab.com/schaefer-services/synapse-mcp/-/issues

\n

Vermeld:

\n\n

Volgende stappen

\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"]}