FAQ MCP

Częste pytania dotyczące serwera MCP Synapse.

Czym jest MCP?

MCP (Model Context Protocol) to otwarty standard Anthropic dla integracji LLM z narzędziami. Zamiast wklejać dokumentację API do promptów, rejestruje się narzędzia w serwerze MCP, a LLM wywołuje je jako funkcje natywne.

Patrz Czym jest MCP?.

Ile narzędzi udostępnia Synapse MCP?

79 narzędzi w 12 kategoriach: memory, chat, scheduler, tasks, scripts, computers, push, user, utility, visualization, sharing, webhooks, browser.

Pełna lista w sekcji Czym jest MCP?.

Które klienty MCP są obsługiwane?

• Claude Desktop (macOS, Windows)
• Claude Code (terminal)
• Cursor (IDE)
• Continue.dev (VS Code, JetBrains)
• Cline (VS Code)
• Dowolny klient zgodny z MCP

Przykłady konfiguracji w sekcji Konfiguracja Claude Desktop.

Jakie transporty są obsługiwane?

1. stdio (lokalny, zalecany dla komputerów biurkowych)
2. HTTP/SSE (zdalny, wielodostępny)
3. WebSocket (mobilny, duży ruch)

Jak skonfigurować Claude Desktop?

Edytować 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"
      }
    }
  }
}

Patrz Konfiguracja Claude Desktop.

Dlaczego narzędzia nie pojawiają się w Claude Desktop?

1. W pełni zrestartować Claude Desktop (Cmd+Q na macOS)
2. Sprawdzić, czy plik konfiguracyjny jest poprawnym JSON-em
3. Zweryfikować Node.js 18+ zainstalowany
4. Sprawdzić logi MCP: ~/Library/Logs/Claude/mcp.log

Patrz Rozwiązywanie problemów MCP.

Jak używać innego umysłu?

Zmienić SYNAPSE_MIND_KEY w konfiguracji MCP i zrestartować klienta.

Dla wielu umysłów uruchomić wiele instancji serwera MCP z różnymi Mind Key.

Czy mogę ograniczyć, które narzędzia są udostępniane?

Tak, użyć Profili narzędzi:

• minimal: 8 narzędzi złożonych (około 500 tokenów)
• standard: 25 narzędzi (około 2 500 tokenów)
• full: 119 narzędzi (około 8 250 tokenów, domyślnie)

Ustawić przez zmienną środowiskową MCP_PROFILE lub nagłówek Mcp-Tool-Profile.

Jak debugować problemy MCP?

1. Uruchomić serwer MCP ręcznie: npx -y synapse-mcp-api@latest
2. Sprawdzić logi klienta (różne w zależności od klienta)
3. Zweryfikować działanie Mind Key: curl -H "Authorization: Bearer mk_..." .../memory/recall
4. Sprawdzić kondycję Synapse: curl https://synapse.schaefer.zone/health

Patrz Rozwiązywanie problemów MCP.

Czy serwer MCP jest darmowy?

Tak. Pakiet npm synapse-mcp-api jest open source. Hostowany serwer MCP pod adresem synapse-mcp.schaefer.zone jest darmowy do użytku publicznego.

Czy mogę hostować serwer MCP samodzielnie?

Tak:

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

Czym MCP różni się od bezpośrednich wywołań API?

Aspekt	Bezpośrednie API	MCP
LLM musi znać	URL-e, nagłówki, autoryzację	Tylko nazwy narzędzi
Obsługa autoryzacji	Ręczna	Automatyczna (zmienna środowiskowa)
Wykrywanie narzędzi	Czytanie /endpoints	Automatyczne przez protokół MCP
Obsługa błędów	Ręczna	Ustandaryzowana
Najlepsze do	Niestandardowych integracji	Agentów LLM

Czy mogę zbudować własnego klienta MCP?

Tak. Użyć oficjalnego SDK MCP:

• TypeScript: @modelcontextprotocol/sdk
• Python: mcp

Patrz Niestandardowy klient MCP.

Jak zgłaszać błędy MCP?

Otworzyć zgłoszenie: https://gitlab.com/schaefer-services/synapse-mcp/-/issues

Dołączyć:

• Wersję serwera MCP
• Nazwę i wersję klienta
• System operacyjny
• Istotne logi
• Kroki reprodukcji

Następne kroki

• Czym jest MCP?
• Konfiguracja Claude Desktop
• Rozwiązywanie problemów MCP