{"title":"MCP w Claude Desktop","slug":"claude-desktop","category":"mcp","summary":"Podłączenie Synapse do Claude Desktop w 2 minuty. Claude zyskuje 79 narzędzi Synapse natywnie.","audience":["human","llm"],"tags":["mcp","claude","desktop","integration"],"difficulty":"beginner","updated":"2026-06-27","word_count":377,"read_minutes":2,"llm_context":"Config file: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)\n %APPDATA%\\Claude\\claude_desktop_config.json (Windows)\nMCP server command: npx -y synapse-mcp-api@latest\nEnv vars: SYNAPSE_MIND_KEY (required), SYNAPSE_URL (optional, default https://synapse.schaefer.zone)\nAfter config: restart Claude Desktop, check for 🔌 icon with \"79 tools\"\nTest: type \"memory_recall aufrufen\" in a new chat\nTroubleshooting: Node.js ≥ 18, check Mind Key, see /docs/mcp/troubleshooting\n","lang":"pl","translated":true,"requested_lang":"pl","content_markdown":"\n# MCP w Claude Desktop\n\nClaude Desktop to aplikacja biurkowa Anthropic dla macOS i Windows. Po\nskonfigurowaniu serwera Synapse MCP Claude zyskuje natywny dostęp do wszystkich\n79 narzędzi Synapse — może zapisywać wspomnienia, przypominać je, zarządzać\nzadaniami, czatować i więcej.\n\n## Wymagania wstępne\n\n- Aplikacja Claude Desktop (macOS lub Windows)\n- Node.js 18+ zainstalowany (`node --version`)\n- Twój Mind Key Synapse\n\n## Krok 1: otwarcie pliku konfiguracyjnego\n\n- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\nJeśli plik nie istnieje, utworzyć go.\n\n## Krok 2: dodanie serwera Synapse MCP\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_MIND_KEY_HERE\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n }\n }\n }\n}\n```\n\n> [!TIP]\n> Jeśli skonfigurowano już inne serwery MCP, wystarczy dodać blok `\"synapse\"`\n> wewnątrz istniejącego obiektu `\"mcpServers\"`.\n\n## Krok 3: restart Claude Desktop\n\n1. W pełni zamknąć Claude Desktop (Cmd+Q na macOS, nie tylko zamknąć okno)\n2. Ponownie otworzyć Claude Desktop\n3. Rozpocząć nowy czat\n4. Poszukać ikony wtyczki 🔌 w lewym dolnym rogu — powinna wskazywać „79 tools\"\n\n## Krok 4: test\n\nW nowym czacie wpisać:\n\n```\nmemory_recall aufrufen\n```\n\nClaude powinien wywołać narzędzie `memory_recall` i odpowiedzieć z podsumowaniem\nzapisanych wspomnień (lub „No memories yet\", jeśli umysł jest pusty).\n\n## Dostępne narzędzia (wybór)\n\n| Narzędzie | Opis |\n|------|-------------|\n| `memory_recall` | Przypomnienie wszystkich wspomnień |\n| `memory_store` | Zapis nowego wspomnienia |\n| `memory_search` | Wyszukiwanie wspomnień |\n| `task_list` | Lista zadań |\n| `task_create` | Utworzenie zadania |\n| `chat_poll` | Sprawdzenie nowych wiadomości |\n| `chat_reply` | Odpowiedź na wiadomość |\n| `browser_new` | Otwarcie karty przeglądarki |\n| `computer_list` | Lista zarejestrowanych komputerów |\n\nPełna lista: [Czym jest MCP?](/docs/mcp/what-is-mcp)\n\n## Rozwiązywanie problemów\n\n### Brak narzędzi w Claude Desktop\n\n1. Zweryfikować wersję Node.js: `node --version` (musi być ≥ 18)\n2. Sprawdzić, czy plik konfiguracyjny jest poprawnym JSON-em (bez końcowych przecinków)\n3. W pełni zrestartować Claude Desktop (Cmd+Q, nie tylko zamknąć)\n4. Sprawdzić logi Claude Desktop: `~/Library/Logs/Claude/mcp.log` (macOS)\n\n### Błąd „Mind Key invalid\"\n\n- Zweryfikować, że `SYNAPSE_MIND_KEY` zaczyna się od `mk_`\n- Uzyskać nowy klucz przez `POST /minds` (wymaga JWT z `/login`)\n- Brak cudzysłowów wokół klucza w JSON\n\n### npx nie znalezione\n\n- Zainstalować Node.js 18+: \n- Zrestartować terminal po instalacji\n- Na macOS z Homebrew: `brew install node`\n\n### Narzędzia się wyświetlają, ale wywołania zawodzą\n\n- Sprawdzić, czy `SYNAPSE_URL` jest osiągalny: `curl https://synapse.schaefer.zone/health`\n- Zweryfikować działanie Mind Key: `curl -H \"Authorization: Bearer mk_...\" https://synapse.schaefer.zone/memory/recall`\n- Patrz [Rozwiązywanie problemów MCP](/docs/mcp/troubleshooting)\n\n## Profile narzędzi (oszczędność tokenów)\n\nJeśli używany jest mniejszy LLM lub zachodzi potrzeba oszczędności tokenów\nkontekstu, ustawić profil narzędzi:\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_...\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\",\n \"MCP_PROFILE\": \"standard\"\n }\n }\n }\n}\n```\n\nProfile: `minimal` (8 narzędzi), `standard` (25), `full` (119, domyślnie).\n\n## Następne kroki\n\n- [Konfiguracja Claude Code](/docs/mcp/claude-code)\n- [Konfiguracja Cursor](/docs/mcp/cursor)\n- [Rozwiązywanie problemów MCP](/docs/mcp/troubleshooting)\n","content_html":"

MCP w Claude Desktop

\n

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

\n

Wymagania wstępne

\n\n

Krok 1: otwarcie pliku konfiguracyjnego

\n\n

Jeśli plik nie istnieje, utworzyć go.

\n

Krok 2: dodanie serwera Synapse MCP

\n
{\n  "mcpServers": {\n    "synapse": {\n      "command": "npx",\n      "args": ["-y", "synapse-mcp-api@latest"],\n      "env": {\n        "SYNAPSE_MIND_KEY": "mk_YOUR_MIND_KEY_HERE",\n        "SYNAPSE_URL": "https://synapse.schaefer.zone"\n      }\n    }\n  }\n}
Jeśli skonfigurowano już inne serwery MCP, wystarczy dodać blok `\"synapse\"`\nwewnątrz istniejącego obiektu `\"mcpServers\"`.

Krok 3: restart Claude Desktop

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

Krok 4: test

\n

W nowym czacie wpisać:

\n
memory_recall aufrufen

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

\n

Dostępne narzędzia (wybór)

\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\n\n\n\n\n\n\n\n\n\n
NarzędzieOpis
memory_recallPrzypomnienie wszystkich wspomnień
memory_storeZapis nowego wspomnienia
memory_searchWyszukiwanie wspomnień
task_listLista zadań
task_createUtworzenie zadania
chat_pollSprawdzenie nowych wiadomości
chat_replyOdpowiedź na wiadomość
browser_newOtwarcie karty przeglądarki
computer_listLista zarejestrowanych komputerów
\n

Pełna lista: Czym jest MCP?

\n

Rozwiązywanie problemów

\n

Brak narzędzi w Claude Desktop

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

Błąd „Mind Key invalid"

\n\n

npx nie znalezione

\n\n

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

\n\n

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

\n

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

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

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

\n

Następne kroki

\n\n","urls":{"html":"/docs/mcp/claude-desktop","text":"/docs/mcp/claude-desktop?format=text","json":"/docs/mcp/claude-desktop?format=json","llm":"/docs/mcp/claude-desktop?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}