# MCP-FAQ

Häufige Fragen zum Synapse-MCP-Server.

## Was ist MCP?

MCP (Model Context Protocol) ist ein offener Standard von Anthropic für
LLM-Tool-Integration. Statt API-Docs in Prompts einzufügen, registrierst du
Tools bei einem MCP-Server, und das LLM ruft sie als native Funktionen auf.

Siehe [Was ist MCP?](/docs/mcp/what-is-mcp).

## Wie viele Tools stellt Synapse MCP bereit?

**79 Tools** in 12 Kategorien: Memory, Chat, Scheduler, Tasks, Scripts,
Computers, Push, User, Utility, Visualization, Sharing, Webhooks, Browser.

Siehe [Was ist MCP?](/docs/mcp/what-is-mcp) für die vollständige Liste.

## Welche MCP-Clients werden unterstützt?

- Claude Desktop (macOS, Windows)
- Claude Code (Terminal)
- Cursor (IDE)
- Continue.dev (VS Code, JetBrains)
- Cline (VS Code)
- Jeder MCP-kompatible Client

Siehe [Claude-Desktop-Setup](/docs/mcp/claude-desktop) für Config-Beispiele.

## Welche Transports werden unterstützt?

1. **stdio** (lokal, empfohlen für Desktop)
2. **HTTP/SSE** (Remote, Multi-Tenant)
3. **WebSocket** (mobil, hohes Volumen)

## Wie konfiguriere ich Claude Desktop?

Editiere `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"
      }
    }
  }
}
```

Siehe [Claude-Desktop-Setup](/docs/mcp/claude-desktop).

## Warum erscheinen Tools nicht in Claude Desktop?

1. **Claude Desktop vollständig neu starten** (Cmd+Q auf macOS)
2. **Prüfen, ob die Config-Datei valides JSON ist**
3. **Node.js 18+** installiert prüfen
4. **MCP-Logs prüfen**: `~/Library/Logs/Claude/mcp.log`

Siehe [MCP-Troubleshooting](/docs/mcp/troubleshooting).

## Wie verwende ich einen anderen Mind?

Ändere `SYNAPSE_MIND_KEY` in deiner MCP-Config und starte den Client neu.

Für mehrere Minds: mehrere MCP-Server-Instanzen mit unterschiedlichen Mind
Keys betreiben.

## Kann ich einschränken, welche Tools exponiert werden?

Ja, verwende **Tool-Profile**:

- `minimal`: 8 Composite-Tools (~500 Token)
- `standard`: 25 Tools (~2.500 Token)
- `full`: 119 Tools (~8.250 Token, Standard)

Setze via `MCP_PROFILE`-Env-Var oder `Mcp-Tool-Profile`-Header.

## Wie debugge ich MCP-Probleme?

1. **MCP-Server manuell ausführen**: `npx -y synapse-mcp-api@latest`
2. **Client-Logs prüfen** (variiert je Client)
3. **Mind Key verifizieren**: `curl -H "Authorization: Bearer mk_..." .../memory/recall`
4. **Synapse-Health prüfen**: `curl https://synapse.schaefer.zone/health`

Siehe [MCP-Troubleshooting](/docs/mcp/troubleshooting).

## Ist der MCP-Server kostenlos?

Ja. Das npm-Paket `synapse-mcp-api` ist Open Source. Der gehostete MCP-Server
unter `synapse-mcp.schaefer.zone` ist für öffentliche Nutzung kostenlos.

## Kann ich den MCP-Server selbst hosten?

Ja:

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

## Wie unterscheidet sich MCP von direkten API-Aufrufen?

| Aspekt | Direkte API | MCP |
|--------|-------------|-----|
| LLM muss wissen | URLs, Header, Auth | Nur Tool-Namen |
| Auth-Handling | Manuell | Automatisch (Env-Var) |
| Tool-Discovery | /endpoints lesen | Automatisch via MCP-Protokoll |
| Fehlerbehandlung | Manuell | Standardisiert |
| Optimal für | Custom-Integrationen | LLM-Agenten |

## Kann ich einen eigenen MCP-Client bauen?

Ja. Verwende das offizielle MCP-SDK:

- TypeScript: `@modelcontextprotocol/sdk`
- Python: `mcp`

Siehe [Custom-MCP-Client](/docs/mcp/custom-client).

## Wie melde ich MCP-Bugs?

Issue öffnen: <https://gitlab.com/schaefer-services/synapse-mcp/-/issues>

Angaben:

- MCP-Server-Version
- Client-Name und -Version
- Betriebssystem
- Relevante Logs
- Reproduktionsschritte

## Nächste Schritte

- [Was ist MCP?](/docs/mcp/what-is-mcp)
- [Claude-Desktop-Setup](/docs/mcp/claude-desktop)
- [MCP-Troubleshooting](/docs/mcp/troubleshooting)