{"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":"ru","translated":true,"requested_lang":"ru","content_markdown":"\n# MCP в Claude Desktop\n\nClaude Desktop — настольное приложение Anthropic для macOS и Windows. С\nнастроенным MCP-сервером Synapse Claude получает нативный доступ ко всем\n79 инструментам 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 (без trailing-запятых)\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+: <https://nodejs.org/>\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## Tool Profiles (экономия токенов)\n\nЕсли вы используете меньший LLM или хотите сэкономить контекстные токены,\nустановите tool profile:\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":"<h1>MCP в Claude Desktop</h1>\n<p>Claude Desktop — настольное приложение Anthropic для macOS и Windows. С\nнастроенным MCP-сервером Synapse Claude получает нативный доступ ко всем\n79 инструментам Synapse — он может сохранять воспоминания, отзывать их,\nуправлять задачами, общаться с вами в чате и многое другое.</p>\n<h2>Предварительные требования</h2>\n<ul>\n<li>Приложение Claude Desktop (macOS или Windows)</li>\n<li>Установленный Node.js 18+ (<code>node --version</code>)</li>\n<li>Ваш Synapse Mind Key</li>\n</ul>\n<h2>Шаг 1: откройте файл конфигурации</h2>\n<ul>\n<li><strong>macOS:</strong> <code>~/Library/Application Support/Claude/claude_desktop_config.json</code></li>\n<li><strong>Windows:</strong> <code>%APPDATA%\\Claude\\claude_desktop_config.json</code></li>\n</ul>\n<p>Если файл не существует, создайте его.</p>\n<h2>Шаг 2: добавьте MCP-сервер Synapse</h2>\n<pre><code class=\"hljs language-json\"><span class=\"hljs-punctuation\">{</span>\n  <span class=\"hljs-attr\">&quot;mcpServers&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">{</span>\n    <span class=\"hljs-attr\">&quot;synapse&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">{</span>\n      <span class=\"hljs-attr\">&quot;command&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;npx&quot;</span><span class=\"hljs-punctuation\">,</span>\n      <span class=\"hljs-attr\">&quot;args&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">[</span><span class=\"hljs-string\">&quot;-y&quot;</span><span class=\"hljs-punctuation\">,</span> <span class=\"hljs-string\">&quot;synapse-mcp-api@latest&quot;</span><span class=\"hljs-punctuation\">]</span><span class=\"hljs-punctuation\">,</span>\n      <span class=\"hljs-attr\">&quot;env&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">{</span>\n        <span class=\"hljs-attr\">&quot;SYNAPSE_MIND_KEY&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;mk_YOUR_MIND_KEY_HERE&quot;</span><span class=\"hljs-punctuation\">,</span>\n        <span class=\"hljs-attr\">&quot;SYNAPSE_URL&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;https://synapse.schaefer.zone&quot;</span>\n      <span class=\"hljs-punctuation\">}</span>\n    <span class=\"hljs-punctuation\">}</span>\n  <span class=\"hljs-punctuation\">}</span>\n<span class=\"hljs-punctuation\">}</span></code></pre><div class=\"callout callout-ok\">Если у вас уже настроены другие MCP-серверы, просто добавьте блок `\"synapse\"`\nвнутрь существующего объекта `\"mcpServers\"`.</div><h2>Шаг 3: перезапустите Claude Desktop</h2>\n<ol>\n<li>Полностью закройте Claude Desktop (Cmd+Q на macOS, а не просто закрывайте окно)</li>\n<li>Откройте Claude Desktop снова</li>\n<li>Начните новый чат</li>\n<li>Найдите иконку штекера 🔌 в левом нижнем углу — должно быть написано «79 tools»</li>\n</ol>\n<h2>Шаг 4: проверка</h2>\n<p>В новом чате введите:</p>\n<pre><code class=\"hljs language-plaintext\">memory_recall aufrufen</code></pre><p>Claude должен вызвать инструмент <code>memory_recall</code> и ответить резюме ваших\nсохранённых воспоминаний (или «No memories yet», если mind пуст).</p>\n<h2>Доступные инструменты (избранное)</h2>\n<table>\n<thead>\n<tr>\n<th>Инструмент</th>\n<th>Описание</th>\n</tr>\n</thead>\n<tbody><tr>\n<td><code>memory_recall</code></td>\n<td>Отозвать все воспоминания</td>\n</tr>\n<tr>\n<td><code>memory_store</code></td>\n<td>Сохранить новое воспоминание</td>\n</tr>\n<tr>\n<td><code>memory_search</code></td>\n<td>Поиск по воспоминаниям</td>\n</tr>\n<tr>\n<td><code>task_list</code></td>\n<td>Получить список задач</td>\n</tr>\n<tr>\n<td><code>task_create</code></td>\n<td>Создать задачу</td>\n</tr>\n<tr>\n<td><code>chat_poll</code></td>\n<td>Проверить новые сообщения</td>\n</tr>\n<tr>\n<td><code>chat_reply</code></td>\n<td>Ответить на сообщение</td>\n</tr>\n<tr>\n<td><code>browser_new</code></td>\n<td>Открыть вкладку браузера</td>\n</tr>\n<tr>\n<td><code>computer_list</code></td>\n<td>Получить список зарегистрированных компьютеров</td>\n</tr>\n</tbody></table>\n<p>Полный список: <a href=\"/docs/mcp/what-is-mcp\">Что такое MCP?</a></p>\n<h2>Устранение проблем</h2>\n<h3>В Claude Desktop не появляются инструменты</h3>\n<ol>\n<li>Проверьте версию Node.js: <code>node --version</code> (должна быть ≥ 18)</li>\n<li>Убедитесь, что файл конфигурации — валидный JSON (без trailing-запятых)</li>\n<li>Полностью перезапустите Claude Desktop (Cmd+Q, а не просто закрытие)</li>\n<li>Проверьте логи Claude Desktop: <code>~/Library/Logs/Claude/mcp.log</code> (macOS)</li>\n</ol>\n<h3>Ошибка «Mind Key invalid»</h3>\n<ul>\n<li>Проверьте, что <code>SYNAPSE_MIND_KEY</code> начинается с <code>mk_</code></li>\n<li>Получите новый ключ через <code>POST /minds</code> (требуется JWT из <code>/login</code>)</li>\n<li>Без кавычек вокруг ключа в JSON</li>\n</ul>\n<h3>npx не найден</h3>\n<ul>\n<li>Установите Node.js 18+: <a href=\"https://nodejs.org/\">https://nodejs.org/</a></li>\n<li>Перезапустите терминал после установки</li>\n<li>На macOS через Homebrew: <code>brew install node</code></li>\n</ul>\n<h3>Инструменты видны, но вызовы падают</h3>\n<ul>\n<li>Проверьте доступность <code>SYNAPSE_URL</code>: <code>curl https://synapse.schaefer.zone/health</code></li>\n<li>Убедитесь, что ваш Mind Key работает: <code>curl -H &quot;Authorization: Bearer mk_...&quot; https://synapse.schaefer.zone/memory/recall</code></li>\n<li>См. <a href=\"/docs/mcp/troubleshooting\">Устранение проблем MCP</a></li>\n</ul>\n<h2>Tool Profiles (экономия токенов)</h2>\n<p>Если вы используете меньший LLM или хотите сэкономить контекстные токены,\nустановите tool profile:</p>\n<pre><code class=\"hljs language-json\"><span class=\"hljs-punctuation\">{</span>\n  <span class=\"hljs-attr\">&quot;mcpServers&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">{</span>\n    <span class=\"hljs-attr\">&quot;synapse&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">{</span>\n      <span class=\"hljs-attr\">&quot;command&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;npx&quot;</span><span class=\"hljs-punctuation\">,</span>\n      <span class=\"hljs-attr\">&quot;args&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">[</span><span class=\"hljs-string\">&quot;-y&quot;</span><span class=\"hljs-punctuation\">,</span> <span class=\"hljs-string\">&quot;synapse-mcp-api@latest&quot;</span><span class=\"hljs-punctuation\">]</span><span class=\"hljs-punctuation\">,</span>\n      <span class=\"hljs-attr\">&quot;env&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">{</span>\n        <span class=\"hljs-attr\">&quot;SYNAPSE_MIND_KEY&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;mk_...&quot;</span><span class=\"hljs-punctuation\">,</span>\n        <span class=\"hljs-attr\">&quot;SYNAPSE_URL&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;https://synapse.schaefer.zone&quot;</span><span class=\"hljs-punctuation\">,</span>\n        <span class=\"hljs-attr\">&quot;MCP_PROFILE&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;standard&quot;</span>\n      <span class=\"hljs-punctuation\">}</span>\n    <span class=\"hljs-punctuation\">}</span>\n  <span class=\"hljs-punctuation\">}</span>\n<span class=\"hljs-punctuation\">}</span></code></pre><p>Профили: <code>minimal</code> (8 инструментов), <code>standard</code> (25), <code>full</code> (119, по умолчанию).</p>\n<h2>Следующие шаги</h2>\n<ul>\n<li><a href=\"/docs/mcp/claude-code\">Настройка Claude Code</a></li>\n<li><a href=\"/docs/mcp/cursor\">Настройка Cursor</a></li>\n<li><a href=\"/docs/mcp/troubleshooting\">Устранение проблем MCP</a></li>\n</ul>\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"]}