MCP w Claude Desktop

Claude Desktop to aplikacja biurkowa Anthropic dla macOS i Windows. Po skonfigurowaniu serwera Synapse MCP Claude zyskuje natywny dostęp do wszystkich 79 narzędzi Synapse — może zapisywać wspomnienia, przypominać je, zarządzać zadaniami, czatować i więcej.

Wymagania wstępne

• Aplikacja Claude Desktop (macOS lub Windows)
• Node.js 18+ zainstalowany (node --version)
• Twój Mind Key Synapse

Krok 1: otwarcie pliku konfiguracyjnego

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Jeśli plik nie istnieje, utworzyć go.

Krok 2: dodanie serwera Synapse MCP

{
  "mcpServers": {
    "synapse": {
      "command": "npx",
      "args": ["-y", "synapse-mcp-api@latest"],
      "env": {
        "SYNAPSE_MIND_KEY": "mk_YOUR_MIND_KEY_HERE",
        "SYNAPSE_URL": "https://synapse.schaefer.zone"
      }
    }
  }
}

Krok 3: restart Claude Desktop

1. W pełni zamknąć Claude Desktop (Cmd+Q na macOS, nie tylko zamknąć okno)
2. Ponownie otworzyć Claude Desktop
3. Rozpocząć nowy czat
4. Poszukać ikony wtyczki 🔌 w lewym dolnym rogu — powinna wskazywać „79 tools"

Krok 4: test

W nowym czacie wpisać:

memory_recall aufrufen

Claude powinien wywołać narzędzie memory_recall i odpowiedzieć z podsumowaniem zapisanych wspomnień (lub „No memories yet", jeśli umysł jest pusty).

Dostępne narzędzia (wybór)

Pełna lista: Czym jest MCP?

Rozwiązywanie problemów

Brak narzędzi w Claude Desktop

1. Zweryfikować wersję Node.js: node --version (musi być ≥ 18)
2. Sprawdzić, czy plik konfiguracyjny jest poprawnym JSON-em (bez końcowych przecinków)
3. W pełni zrestartować Claude Desktop (Cmd+Q, nie tylko zamknąć)
4. Sprawdzić logi Claude Desktop: ~/Library/Logs/Claude/mcp.log (macOS)

Błąd „Mind Key invalid"

• Zweryfikować, że SYNAPSE_MIND_KEY zaczyna się od mk_
• Uzyskać nowy klucz przez POST /minds (wymaga JWT z /login)
• Brak cudzysłowów wokół klucza w JSON

npx nie znalezione

• Zainstalować Node.js 18+: https://nodejs.org/
• Zrestartować terminal po instalacji
• Na macOS z Homebrew: brew install node

Narzędzia się wyświetlają, ale wywołania zawodzą

• Sprawdzić, czy SYNAPSE_URL jest osiągalny: curl https://synapse.schaefer.zone/health
• Zweryfikować działanie Mind Key: curl -H "Authorization: Bearer mk_..." https://synapse.schaefer.zone/memory/recall
• Patrz Rozwiązywanie problemów MCP

Profile narzędzi (oszczędność tokenów)

Jeśli używany jest mniejszy LLM lub zachodzi potrzeba oszczędności tokenów kontekstu, ustawić profil narzędzi:

{
  "mcpServers": {
    "synapse": {
      "command": "npx",
      "args": ["-y", "synapse-mcp-api@latest"],
      "env": {
        "SYNAPSE_MIND_KEY": "mk_...",
        "SYNAPSE_URL": "https://synapse.schaefer.zone",
        "MCP_PROFILE": "standard"
      }
    }
  }
}

Profile: minimal (8 narzędzi), standard (25), full (119, domyślnie).

Następne kroki

• Konfiguracja Claude Code
• Konfiguracja Cursor
• Rozwiązywanie problemów MCP