{"title":"MCP у Claude Desktop","slug":"claude-desktop","category":"mcp","summary":"Підключіть Synapse до Claude Desktop за 2 хвилини. Claude отримує 79 інструментів Synapse нативно.","audience":["human","llm"],"tags":["mcp","claude","desktop","integration"],"difficulty":"beginner","updated":"2026-06-27","word_count":384,"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":"uk","translated":true,"requested_lang":"uk","content_markdown":"\n# MCP у Claude Desktop\n\nClaude Desktop — це десктоп-додаток Anthropic для macOS та Windows. Із\nналаштованим MCP-сервером Synapse Claude отримує нативний доступ до всіх 79\nінструментів Synapse — він може зберігати спогади, відкликати їх, керувати\nзавданнями, спілкуватися з вами через чат та багато іншого.\n\n## Передумови\n\n- Додаток Claude Desktop (macOS або Windows)\n- Node.js 18+ встановлено (`node --version`)\n- Ваш Synapse Mind Key\n\n## Крок 1: відкрийте конфігураційний файл\n\n- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\nЯкщо файл не існує, створіть його.\n\n## Крок 2: додайте MCP-сервер Synapse\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> Якщо у вас вже налаштовано інші MCP-сервери, просто додайте блок `\"synapse\"`\n> усередину наявного об'єкта `\"mcpServers\"`.\n\n## Крок 3: перезапустіть Claude Desktop\n\n1. Повністю закрийте Claude Desktop (Cmd+Q на macOS, а не просто закрийте вікно)\n2. Знову відкрийте Claude Desktop\n3. Почніть новий чат\n4. Знайдіть значок роз'єму 🔌 у нижньому лівому куті — має писати «79 tools»\n\n## Крок 4: перевірте\n\nУ новому чаті введіть:\n\n```\nmemory_recall aufrufen\n```\n\nClaude має викликати інструмент `memory_recall` і відповісти резюме ваших\nзбережених спогадів (або «No memories yet», якщо ваш mind порожній).\n\n## Доступні інструменти (вибірка)\n\n| Інструмент | Опис |\n|------|-------------|\n| `memory_recall` | Відкликати всі спогади |\n| `memory_store` | Зберегти новий спогад |\n| `memory_search` | Шукати спогади |\n| `task_list` | Вивести список завдань |\n| `task_create` | Створити завдання |\n| `chat_poll` | Перевірити нові повідомлення |\n| `chat_reply` | Відповісти на повідомлення |\n| `browser_new` | Відкрити вкладку браузера |\n| `computer_list` | Вивести список зареєстрованих комп'ютерів |\n\nПовний список: [Що таке MCP?](/docs/mcp/what-is-mcp)\n\n## Вирішення проблем\n\n### Інструменти не з'являються в Claude Desktop\n\n1. Перевірте версію Node.js: `node --version` (має бути ≥ 18)\n2. Перевірте, що конфігураційний файл є коректним JSON (без кінцевих ком)\n3. Повністю перезапустіть Claude Desktop (Cmd+Q, а не просто закрити)\n4. Перевірте логи Claude Desktop: `~/Library/Logs/Claude/mcp.log` (macOS)\n\n### Помилка «Mind Key invalid»\n\n- Перевірте, що `SYNAPSE_MIND_KEY` починається з `mk_`\n- Отримайте свіжий ключ через `POST /minds` (потребує JWT з `/login`)\n- Без лапок навколо ключа в JSON\n\n### npx не знайдено\n\n- Встановіть Node.js 18+: \n- Перезапустіть термінал після встановлення\n- На macOS з Homebrew: `brew install node`\n\n### Інструменти відображаються, але виклики зазнають невдачі\n\n- Перевірте, що `SYNAPSE_URL` доступний: `curl https://synapse.schaefer.zone/health`\n- Перевірте, що ваш Mind Key працює: `curl -H \"Authorization: Bearer mk_...\" https://synapse.schaefer.zone/memory/recall`\n- Див. [Вирішення проблем MCP](/docs/mcp/troubleshooting)\n\n## Профілі інструментів (економія токенів)\n\nЯкщо ви використовуєте менший LLM або хочете зберегти контекстні токени, установіть профіль інструментів:\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\nПрофілі: `minimal` (8 інструментів), `standard` (25), `full` (119, за замовчуванням).\n\n## Наступні кроки\n\n- [Налаштування Claude Code](/docs/mcp/claude-code)\n- [Налаштування Cursor](/docs/mcp/cursor)\n- [Вирішення проблем MCP](/docs/mcp/troubleshooting)\n","content_html":"

MCP у Claude Desktop

\n

Claude Desktop — це десктоп-додаток Anthropic для macOS та Windows. Із\nналаштованим MCP-сервером Synapse Claude отримує нативний доступ до всіх 79\nінструментів Synapse — він може зберігати спогади, відкликати їх, керувати\nзавданнями, спілкуватися з вами через чат та багато іншого.

\n

Передумови

\n\n

Крок 1: відкрийте конфігураційний файл

\n\n

Якщо файл не існує, створіть його.

\n

Крок 2: додайте MCP-сервер Synapse

\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}
Якщо у вас вже налаштовано інші MCP-сервери, просто додайте блок `\"synapse\"`\nусередину наявного об'єкта `\"mcpServers\"`.

Крок 3: перезапустіть Claude Desktop

\n
    \n
  1. Повністю закрийте Claude Desktop (Cmd+Q на macOS, а не просто закрийте вікно)
    2. \n
  2. Знову відкрийте Claude Desktop
    3. \n
  3. Почніть новий чат
    4. \n
  4. Знайдіть значок роз'єму 🔌 у нижньому лівому куті — має писати «79 tools»
    5. \n
\n

Крок 4: перевірте

\n

У новому чаті введіть:

\n
memory_recall aufrufen

Claude має викликати інструмент memory_recall і відповісти резюме ваших\nзбережених спогадів (або «No memories yet», якщо ваш mind порожній).

\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\n
ІнструментОпис
memory_recallВідкликати всі спогади
memory_storeЗберегти новий спогад
memory_searchШукати спогади
task_listВивести список завдань
task_createСтворити завдання
chat_pollПеревірити нові повідомлення
chat_replyВідповісти на повідомлення
browser_newВідкрити вкладку браузера
computer_listВивести список зареєстрованих комп'ютерів
\n

Повний список: Що таке MCP?

\n

Вирішення проблем

\n

Інструменти не з'являються в Claude Desktop

\n
    \n
  1. Перевірте версію Node.js: node --version (має бути ≥ 18)
    2. \n
  2. Перевірте, що конфігураційний файл є коректним JSON (без кінцевих ком)
    3. \n
  3. Повністю перезапустіть Claude Desktop (Cmd+Q, а не просто закрити)
    4. \n
  4. Перевірте логи Claude Desktop: ~/Library/Logs/Claude/mcp.log (macOS)
    5. \n
\n

Помилка «Mind Key invalid»

\n\n

npx не знайдено

\n\n

Інструменти відображаються, але виклики зазнають невдачі

\n\n

Профілі інструментів (економія токенів)

\n

Якщо ви використовуєте менший LLM або хочете зберегти контекстні токени, установіть профіль інструментів:

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

Профілі: minimal (8 інструментів), standard (25), full (119, за замовчуванням).

\n

Наступні кроки

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