# Claude Desktop 中的 MCP
SUMMARY: 2 分钟把 Synapse 接入 Claude Desktop。Claude 原生获得 79 个 Synapse 工具。

KEY CONTEXT:
Config file: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
             %APPDATA%\Claude\claude_desktop_config.json (Windows)
MCP server command: npx -y synapse-mcp-api@latest
Env vars: SYNAPSE_MIND_KEY (required), SYNAPSE_URL (optional, default https://synapse.schaefer.zone)
After config: restart Claude Desktop, check for 🔌 icon with "79 tools"
Test: type "memory_recall aufrufen" in a new chat
Troubleshooting: Node.js ≥ 18, check Mind Key, see /docs/mcp/troubleshooting

Claude Desktop 中的 MCP
Claude Desktop 是 Anthropic 推出的 macOS 与 Windows 桌面应用。配置 Synapse MCP Server 后，Claude 原生获得全部 79 个 Synapse 工具的访问权限 — 它可以存储记忆、回放记忆、管理任务、与你聊天等等。
前置条件
- Claude Desktop 应用（macOS 或 Windows）
- 已安装 Node.js 18+（）
- 你的 Synapse Mind Key
第 1 步：打开配置文件
- macOS：
- Windows：
如果文件不存在，请创建。
第 2 步：添加 Synapse MCP Server
[CODE BLOCK]
> [!TIP]
> 如果你已经配置了其他 MCP Server，只需把  块添加到已有的  对象内。
第 3 步：重启 Claude Desktop
1. 完全退出 Claude Desktop（macOS 上 Cmd+Q，而非只关窗口）
2. 重新打开 Claude Desktop
3. 开启新聊天
4. 查看左下角的 🔌 插头图标 — 应显示 “79 tools”
第 4 步：测试
在新聊天中输入：
[CODE BLOCK]
Claude 应该调用  工具，并返回已存储记忆的摘要（如果 Mind 为空则返回 “No memories yet”）。
可用工具（部分）
| 工具 | 说明 |
|------|-------------|
|  | 回放所有记忆 |
|  | 存储新记忆 |
|  | 搜索记忆 |
|  | 列出任务 |
|  | 创建任务 |
|  | 检查新消息 |
|  | 回复消息 |
|  | 打开浏览器标签页 |
|  | 列出已注册计算机 |
完整列表：MCP 是什么？
故障排查
Claude Desktop 中没有工具出现
1. 验证 Node.js 版本：（必须 ≥ 18）
2. 检查配置文件是否为有效 JSON（无尾随逗号）
3. 完全重启 Claude Desktop（Cmd+Q，而非只关窗口）
4. 查看 Claude Desktop 日志：（macOS）
“Mind Key invalid” 错误
- 确认  以  开头
- 通过  获取新 key（需要  的 JWT）
- JSON 中 key 不要加引号
npx 未找到
- 安装 Node.js 18+：<https://nodejs.org/>
- 安装后重启终端
- macOS 用 Homebrew：
工具出现但调用失败
- 检查  是否可达：
- 验证 Mind Key 可用：
- 参见 MCP 故障排查
工具配置文件（节省 tokens）
如果你使用较小的 LLM 或想节省上下文 tokens，设置工具配置文件：
[CODE BLOCK]
配置文件：（8 个工具）、（25）、（119，默认）。
下一步
- Claude Code 配置
- Cursor 配置
- MCP 故障排查