# Cursor 中的 MCP

Cursor 是基于 VS Code 的 AI 驱动 IDE。借助 Synapse MCP，Cursor 在会话之间获得持久化记忆 — 它会记住你的项目决策、代码库模式和过往调试会话。

## 前置条件

- 已安装 Cursor IDE（<https://cursor.com>）
- Node.js 18+
- 你的 Synapse Mind Key

## 配置

### 第 1 步：打开 Cursor 设置

在 Cursor 中：

1. 打开设置（macOS Cmd+,，Windows/Linux Ctrl+,）
2. 搜索 “MCP” 或导航到 `Cursor Settings → MCP Servers`

### 第 2 步：添加 Synapse MCP Server

点击 “Add MCP Server” 并配置：

| 字段 | 值 |
|-------|-------|
| Name | `synapse` |
| Type | `stdio` |
| Command | `npx -y synapse-mcp-api@latest` |
| Env | `SYNAPSE_MIND_KEY=mk_YOUR_KEY, SYNAPSE_URL=https://synapse.schaefer.zone` |

### 第 3 步：直接编辑 config.json（备选）

Cursor 把 MCP 配置存储在 `~/.cursor/config.json`：

```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"
      }
    }
  }
}
```

### 第 4 步：重启 Cursor

完全重启 Cursor（macOS 上 Cmd+Q 后重新打开）。

## 验证可用

在 Cursor 的聊天面板中（Cmd+L）：

```
recall all my memories
```

Cursor 应调用 `memory_recall` 并返回你已存储的记忆。

## 常见模式

### 项目入门

打开新项目时：

```
recalling project context — what do I know about this codebase?
```

Cursor 调用 `memory_recall` 并从中断处继续工作。

### 架构决策

```
store this decision: "Using Fastify instead of Express for this project
because of schema validation. Date: 2026-06-27."
```

Cursor 把它存为 `project` 记忆，优先级 `high`。

### 调试历史

```
what bugs have I hit in this codebase?
```

Cursor 搜索 `mistake` 记忆并提醒你过往修复。

### 跨会话代码模式

```
search memories: "authentication pattern"
```

Cursor 找出你以前实现过的认证相关记忆。

## 故障排查

### MCP Server 未连接

1. 验证 Node.js：`node --version`（≥ 18）
2. 测试 MCP Server：`npx -y synapse-mcp-api@latest`（应无错启动）
3. 查看 Cursor 的 MCP 日志（View → Output → MCP）
4. 完全重启 Cursor

### 工具未出现

- 检查 `~/.cursor/config.json` 是否为有效 JSON
- 验证 `SYNAPSE_MIND_KEY` 环境变量已设置
- 检查 Cursor 版本是否支持 MCP（≥ 0.42）

### Mind Key 无效

```bash
# 直接测试你的 Mind Key
curl -H "Authorization: Bearer mk_YOUR_KEY" \
     https://synapse.schaefer.zone/memory/recall
```

## 下一步

- [Claude Desktop 配置](/docs/mcp/claude-desktop)
- [Continue.dev 配置](/docs/mcp/continue)
- [持久化 LLM Agent 指南](/docs/guides/persistent-llm-agent)