MCP у Claude Desktop

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

Передумови

• Додаток Claude Desktop (macOS або Windows)
• Node.js 18+ встановлено (node --version)
• Ваш Synapse Mind Key

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

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

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

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

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

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

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

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

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

memory_recall aufrufen

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

Доступні інструменти (вибірка)

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

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

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

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

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

• Перевірте, що SYNAPSE_MIND_KEY починається з mk_
• Отримайте свіжий ключ через POST /minds (потребує JWT з /login)
• Без лапок навколо ключа в JSON

npx не знайдено

• Встановіть Node.js 18+: https://nodejs.org/
• Перезапустіть термінал після встановлення
• На macOS з Homebrew: brew install node

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

• Перевірте, що SYNAPSE_URL доступний: curl https://synapse.schaefer.zone/health
• Перевірте, що ваш Mind Key працює: curl -H "Authorization: Bearer mk_..." https://synapse.schaefer.zone/memory/recall
• Див. Вирішення проблем MCP

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

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

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

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

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

• Налаштування Claude Code
• Налаштування Cursor
• Вирішення проблем MCP