# 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

```json
{
  "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"
      }
    }
  }
}
```

> [!TIP]
> Jeśli skonfigurowano już inne serwery MCP, wystarczy dodać blok `"synapse"`
> wewnątrz istniejącego obiektu `"mcpServers"`.

## 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)

| Narzędzie | Opis |
|------|-------------|
| `memory_recall` | Przypomnienie wszystkich wspomnień |
| `memory_store` | Zapis nowego wspomnienia |
| `memory_search` | Wyszukiwanie wspomnień |
| `task_list` | Lista zadań |
| `task_create` | Utworzenie zadania |
| `chat_poll` | Sprawdzenie nowych wiadomości |
| `chat_reply` | Odpowiedź na wiadomość |
| `browser_new` | Otwarcie karty przeglądarki |
| `computer_list` | Lista zarejestrowanych komputerów |

Pełna lista: [Czym jest MCP?](/docs/mcp/what-is-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](/docs/mcp/troubleshooting)

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

```json
{
  "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](/docs/mcp/claude-code)
- [Konfiguracja Cursor](/docs/mcp/cursor)
- [Rozwiązywanie problemów MCP](/docs/mcp/troubleshooting)