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?.

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? 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 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:

{
  "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.

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.

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.

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:

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.

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?
• Claude-Desktop-Setup
• MCP-Troubleshooting