MCP-FAQ

Veelgestelde vragen over de Synapse MCP-server.

Wat is MCP?

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

Zie Wat is MCP?.

Hoeveel tools stelt Synapse MCP beschikbaar?

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

Zie Wat is MCP? voor de volledige lijst.

Welke MCP-clients worden ondersteund?

• Claude Desktop (macOS, Windows)
• Claude Code (terminal)
• Cursor (IDE)
• Continue.dev (VS Code, JetBrains)
• Cline (VS Code)
• Elke MCP-compatibele client

Zie Claude Desktop Setup voor configuratievoorbeelden.

Welke transporten worden ondersteund?

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

Hoe configureer ik Claude Desktop?

Bewerk claude_desktop_config.json:

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

Zie Claude Desktop Setup.

Waarom verschijnen tools niet in Claude Desktop?

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

Zie MCP Troubleshooting.

Hoe gebruik ik een andere mind?

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

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

Kan ik beperken welke tools worden getoond?

Ja, gebruik Tool Profiles:

• minimal: 8 samengestelde tools (~500 tokens)
• standard: 25 tools (~2,500 tokens)
• full: 119 tools (~8,250 tokens, standaard)

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

Hoe debug ik MCP-problemen?

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

Zie MCP Troubleshooting.

Is de MCP-server gratis?

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

Kan ik de MCP-server zelf hosten?

Ja:

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

Hoe verschilt MCP van directe API-aanroepen?

Aspect	Directe API	MCP
LLM moet weten	URL's, headers, auth	Alleen tool-namen
Auth-handling	Handmatig	Automatisch (env-var)
Tool-ontdekking	Lees /endpoints	Automatisch via MCP-protocol
Foutafhandeling	Handmatig	Gestandaardiseerd
Geschikt voor	Aangepaste integraties	LLM-agents

Kan ik mijn eigen MCP-client bouwen?

Ja. Gebruik de officiële MCP-SDK:

• TypeScript: @modelcontextprotocol/sdk
• Python: mcp

Zie Aangepaste MCP-client.

Hoe meld ik MCP-bugs?

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

Vermeld:

• MCP-server-versie
• Client-naam en versie
• Besturingssysteem
• Relevante logs
• Stappen om te reproduceren

Volgende stappen

• Wat is MCP?
• Claude Desktop Setup
• MCP Troubleshooting