{"title":"MCP-FAQ","slug":"mcp-faq","category":"faq","summary":"Häufige Fragen zur MCP-Integration — Tools, Transports, Troubleshooting.","audience":["human","llm"],"tags":["faq","mcp","troubleshooting"],"difficulty":"beginner","updated":"2026-06-27","word_count":393,"read_minutes":2,"lang":"de","translated":true,"requested_lang":"de","content_markdown":"\n# MCP-FAQ\n\nHäufige Fragen zum Synapse-MCP-Server.\n\n## Was ist MCP?\n\nMCP (Model Context Protocol) ist ein offener Standard von Anthropic für\nLLM-Tool-Integration. Statt API-Docs in Prompts einzufügen, registrierst du\nTools bei einem MCP-Server, und das LLM ruft sie als native Funktionen auf.\n\nSiehe [Was ist MCP?](/docs/mcp/what-is-mcp).\n\n## Wie viele Tools stellt Synapse MCP bereit?\n\n**79 Tools** in 12 Kategorien: Memory, Chat, Scheduler, Tasks, Scripts,\nComputers, Push, User, Utility, Visualization, Sharing, Webhooks, Browser.\n\nSiehe [Was ist MCP?](/docs/mcp/what-is-mcp) für die vollständige Liste.\n\n## Welche MCP-Clients werden unterstützt?\n\n- Claude Desktop (macOS, Windows)\n- Claude Code (Terminal)\n- Cursor (IDE)\n- Continue.dev (VS Code, JetBrains)\n- Cline (VS Code)\n- Jeder MCP-kompatible Client\n\nSiehe [Claude-Desktop-Setup](/docs/mcp/claude-desktop) für Config-Beispiele.\n\n## Welche Transports werden unterstützt?\n\n1. **stdio** (lokal, empfohlen für Desktop)\n2. **HTTP/SSE** (Remote, Multi-Tenant)\n3. **WebSocket** (mobil, hohes Volumen)\n\n## Wie konfiguriere ich Claude Desktop?\n\nEditiere `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\nSiehe [Claude-Desktop-Setup](/docs/mcp/claude-desktop).\n\n## Warum erscheinen Tools nicht in Claude Desktop?\n\n1. **Claude Desktop vollständig neu starten** (Cmd+Q auf macOS)\n2. **Prüfen, ob die Config-Datei valides JSON ist**\n3. **Node.js 18+** installiert prüfen\n4. **MCP-Logs prüfen**: `~/Library/Logs/Claude/mcp.log`\n\nSiehe [MCP-Troubleshooting](/docs/mcp/troubleshooting).\n\n## Wie verwende ich einen anderen Mind?\n\nÄndere `SYNAPSE_MIND_KEY` in deiner MCP-Config und starte den Client neu.\n\nFür mehrere Minds: mehrere MCP-Server-Instanzen mit unterschiedlichen Mind\nKeys betreiben.\n\n## Kann ich einschränken, welche Tools exponiert werden?\n\nJa, verwende **Tool-Profile**:\n\n- `minimal`: 8 Composite-Tools (~500 Token)\n- `standard`: 25 Tools (~2.500 Token)\n- `full`: 119 Tools (~8.250 Token, Standard)\n\nSetze via `MCP_PROFILE`-Env-Var oder `Mcp-Tool-Profile`-Header.\n\n## Wie debugge ich MCP-Probleme?\n\n1. **MCP-Server manuell ausführen**: `npx -y synapse-mcp-api@latest`\n2. **Client-Logs prüfen** (variiert je Client)\n3. **Mind Key verifizieren**: `curl -H \"Authorization: Bearer mk_...\" .../memory/recall`\n4. **Synapse-Health prüfen**: `curl https://synapse.schaefer.zone/health`\n\nSiehe [MCP-Troubleshooting](/docs/mcp/troubleshooting).\n\n## Ist der MCP-Server kostenlos?\n\nJa. Das npm-Paket `synapse-mcp-api` ist Open Source. Der gehostete MCP-Server\nunter `synapse-mcp.schaefer.zone` ist für öffentliche Nutzung kostenlos.\n\n## Kann ich den MCP-Server selbst 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## Wie unterscheidet sich MCP von direkten API-Aufrufen?\n\n| Aspekt | Direkte API | MCP |\n|--------|-------------|-----|\n| LLM muss wissen | URLs, Header, Auth | Nur Tool-Namen |\n| Auth-Handling | Manuell | Automatisch (Env-Var) |\n| Tool-Discovery | /endpoints lesen | Automatisch via MCP-Protokoll |\n| Fehlerbehandlung | Manuell | Standardisiert |\n| Optimal für | Custom-Integrationen | LLM-Agenten |\n\n## Kann ich einen eigenen MCP-Client bauen?\n\nJa. Verwende das offizielle MCP-SDK:\n\n- TypeScript: `@modelcontextprotocol/sdk`\n- Python: `mcp`\n\nSiehe [Custom-MCP-Client](/docs/mcp/custom-client).\n\n## Wie melde ich MCP-Bugs?\n\nIssue öffnen: \n\nAngaben:\n\n- MCP-Server-Version\n- Client-Name und -Version\n- Betriebssystem\n- Relevante Logs\n- Reproduktionsschritte\n\n## Nächste Schritte\n\n- [Was ist 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

Häufige Fragen zum Synapse-MCP-Server.

\n

Was ist MCP?

\n

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

\n

Siehe Was ist MCP?.

\n

Wie viele Tools stellt Synapse MCP bereit?

\n

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

\n

Siehe Was ist MCP? für die vollständige Liste.

\n

Welche MCP-Clients werden unterstützt?

\n\n

Siehe Claude-Desktop-Setup für Config-Beispiele.

\n

Welche Transports werden unterstützt?

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

Wie konfiguriere ich Claude Desktop?

\n

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

Siehe Claude-Desktop-Setup.

\n

Warum erscheinen Tools nicht in Claude Desktop?

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

Siehe MCP-Troubleshooting.

\n

Wie verwende ich einen anderen Mind?

\n

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

\n

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

\n

Kann ich einschränken, welche Tools exponiert werden?

\n

Ja, verwende Tool-Profile:

\n\n

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

\n

Wie debugge ich MCP-Probleme?

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

Siehe MCP-Troubleshooting.

\n

Ist der MCP-Server kostenlos?

\n

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

\n

Kann ich den MCP-Server selbst hosten?

\n

Ja:

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

Wie unterscheidet sich MCP von direkten API-Aufrufen?

\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
AspektDirekte APIMCP
LLM muss wissenURLs, Header, AuthNur Tool-Namen
Auth-HandlingManuellAutomatisch (Env-Var)
Tool-Discovery/endpoints lesenAutomatisch via MCP-Protokoll
FehlerbehandlungManuellStandardisiert
Optimal fürCustom-IntegrationenLLM-Agenten
\n

Kann ich einen eigenen MCP-Client bauen?

\n

Ja. Verwende das offizielle MCP-SDK:

\n\n

Siehe Custom-MCP-Client.

\n

Wie melde ich MCP-Bugs?

\n

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

\n

Angaben:

\n\n

Nächste Schritte

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