# 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?](/docs/mcp/what-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?](/docs/mcp/what-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](/docs/mcp/claude-desktop) 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`:

```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](/docs/mcp/claude-desktop).

## 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](/docs/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](/docs/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:

```bash
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](/docs/mcp/custom-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?](/docs/mcp/what-is-mcp)
- [Claude Desktop Setup](/docs/mcp/claude-desktop)
- [MCP Troubleshooting](/docs/mcp/troubleshooting)