{"title":"Claude Desktop 中的 MCP","slug":"claude-desktop","category":"mcp","summary":"2 分钟把 Synapse 接入 Claude Desktop。Claude 原生获得 79 个 Synapse 工具。","audience":["human","llm"],"tags":["mcp","claude","desktop","integration"],"difficulty":"beginner","updated":"2026-06-27","word_count":235,"read_minutes":1,"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":"zh","translated":true,"requested_lang":"zh","content_markdown":"\n# Claude Desktop 中的 MCP\n\nClaude Desktop 是 Anthropic 推出的 macOS 与 Windows 桌面应用。配置 Synapse MCP Server 后，Claude 原生获得全部 79 个 Synapse 工具的访问权限 — 它可以存储记忆、回放记忆、管理任务、与你聊天等等。\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 步：添加 Synapse MCP Server\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 Server，只需把 `\"synapse\"` 块添加到已有的 `\"mcpServers\"` 对象内。\n\n## 第 3 步：重启 Claude Desktop\n\n1. 完全退出 Claude Desktop（macOS 上 Cmd+Q，而非只关窗口）\n2. 重新打开 Claude Desktop\n3. 开启新聊天\n4. 查看左下角的 🔌 插头图标 — 应显示 “79 tools”\n\n## 第 4 步：测试\n\n在新聊天中输入：\n\n```\nmemory_recall aufrufen\n```\n\nClaude 应该调用 `memory_recall` 工具，并返回已存储记忆的摘要（如果 Mind 为空则返回 “No memories yet”）。\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（无尾随逗号）\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` 获取新 key（需要 `/login` 的 JWT）\n- JSON 中 key 不要加引号\n\n### npx 未找到\n\n- 安装 Node.js 18+：\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## 工具配置文件（节省 tokens）\n\n如果你使用较小的 LLM 或想节省上下文 tokens，设置工具配置文件：\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":"

Claude Desktop 中的 MCP

\n

Claude Desktop 是 Anthropic 推出的 macOS 与 Windows 桌面应用。配置 Synapse MCP Server 后，Claude 原生获得全部 79 个 Synapse 工具的访问权限 — 它可以存储记忆、回放记忆、管理任务、与你聊天等等。

\n

前置条件

\n\n

第 1 步：打开配置文件

\n\n

如果文件不存在，请创建。

\n

第 2 步：添加 Synapse MCP Server

\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}
如果你已经配置了其他 MCP Server，只需把 `\"synapse\"` 块添加到已有的 `\"mcpServers\"` 对象内。

第 3 步：重启 Claude Desktop

\n
    \n
  1. 完全退出 Claude Desktop（macOS 上 Cmd+Q，而非只关窗口）
    2. \n
  2. 重新打开 Claude Desktop
    3. \n
  3. 开启新聊天
    4. \n
  4. 查看左下角的 🔌 插头图标 — 应显示 “79 tools”
    5. \n
\n

第 4 步：测试

\n

在新聊天中输入：

\n
memory_recall aufrufen

Claude 应该调用 memory_recall 工具，并返回已存储记忆的摘要（如果 Mind 为空则返回 “No memories yet”）。

\n

可用工具（部分）

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
工具说明
memory_recall回放所有记忆
memory_store存储新记忆
memory_search搜索记忆
task_list列出任务
task_create创建任务
chat_poll检查新消息
chat_reply回复消息
browser_new打开浏览器标签页
computer_list列出已注册计算机
\n

完整列表：MCP 是什么？

\n

故障排查

\n

Claude Desktop 中没有工具出现

\n
    \n
  1. 验证 Node.js 版本：node --version（必须 ≥ 18）
    2. \n
  2. 检查配置文件是否为有效 JSON（无尾随逗号）
    3. \n
  3. 完全重启 Claude Desktop（Cmd+Q，而非只关窗口）
    4. \n
  4. 查看 Claude Desktop 日志：~/Library/Logs/Claude/mcp.log（macOS）
    5. \n
\n

“Mind Key invalid” 错误

\n\n

npx 未找到

\n\n

工具出现但调用失败

\n\n

工具配置文件（节省 tokens）

\n

如果你使用较小的 LLM 或想节省上下文 tokens，设置工具配置文件：

\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}

配置文件：minimal（8 个工具）、standard（25）、full（119，默认）。

\n

下一步

\n\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"]}