# 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

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

## Крок 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 порожній).

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

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

Повний список: [Що таке MCP?](/docs/mcp/what-is-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](/docs/mcp/troubleshooting)

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

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

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

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

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

- [Налаштування Claude Code](/docs/mcp/claude-code)
- [Налаштування Cursor](/docs/mcp/cursor)
- [Вирішення проблем MCP](/docs/mcp/troubleshooting)