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 (без 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

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

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

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