# 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 (без trailing-запятых)
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)

## Tool Profiles (экономия токенов)

Если вы используете меньший LLM или хотите сэкономить контекстные токены,
установите tool profile:

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