{"title":"Cursor 中的 MCP","slug":"cursor","category":"mcp","summary":"把 Synapse 接入 Cursor IDE，为编码会话提供持久化的项目记忆。","audience":["human"],"tags":["mcp","cursor","ide","coding"],"difficulty":"intermediate","updated":"2026-06-27","word_count":191,"read_minutes":1,"lang":"zh","translated":true,"requested_lang":"zh","content_markdown":"\n# Cursor 中的 MCP\n\nCursor 是基于 VS Code 的 AI 驱动 IDE。借助 Synapse MCP，Cursor 在会话之间获得持久化记忆 — 它会记住你的项目决策、代码库模式和过往调试会话。\n\n## 前置条件\n\n- 已安装 Cursor IDE（）\n- Node.js 18+\n- 你的 Synapse Mind Key\n\n## 配置\n\n### 第 1 步：打开 Cursor 设置\n\n在 Cursor 中：\n\n1. 打开设置（macOS Cmd+,，Windows/Linux Ctrl+,）\n2. 搜索 “MCP” 或导航到 `Cursor Settings → MCP Servers`\n\n### 第 2 步：添加 Synapse MCP Server\n\n点击 “Add MCP Server” 并配置：\n\n| 字段 | 值 |\n|-------|-------|\n| Name | `synapse` |\n| Type | `stdio` |\n| Command | `npx -y synapse-mcp-api@latest` |\n| Env | `SYNAPSE_MIND_KEY=mk_YOUR_KEY, SYNAPSE_URL=https://synapse.schaefer.zone` |\n\n### 第 3 步：直接编辑 config.json（备选）\n\nCursor 把 MCP 配置存储在 `~/.cursor/config.json`：\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### 第 4 步：重启 Cursor\n\n完全重启 Cursor（macOS 上 Cmd+Q 后重新打开）。\n\n## 验证可用\n\n在 Cursor 的聊天面板中（Cmd+L）：\n\n```\nrecall all my memories\n```\n\nCursor 应调用 `memory_recall` 并返回你已存储的记忆。\n\n## 常见模式\n\n### 项目入门\n\n打开新项目时：\n\n```\nrecalling project context — what do I know about this codebase?\n```\n\nCursor 调用 `memory_recall` 并从中断处继续工作。\n\n### 架构决策\n\n```\nstore this decision: \"Using Fastify instead of Express for this project\nbecause of schema validation. Date: 2026-06-27.\"\n```\n\nCursor 把它存为 `project` 记忆，优先级 `high`。\n\n### 调试历史\n\n```\nwhat bugs have I hit in this codebase?\n```\n\nCursor 搜索 `mistake` 记忆并提醒你过往修复。\n\n### 跨会话代码模式\n\n```\nsearch memories: \"authentication pattern\"\n```\n\nCursor 找出你以前实现过的认证相关记忆。\n\n## 故障排查\n\n### MCP Server 未连接\n\n1. 验证 Node.js：`node --version`（≥ 18）\n2. 测试 MCP Server：`npx -y synapse-mcp-api@latest`（应无错启动）\n3. 查看 Cursor 的 MCP 日志（View → Output → MCP）\n4. 完全重启 Cursor\n\n### 工具未出现\n\n- 检查 `~/.cursor/config.json` 是否为有效 JSON\n- 验证 `SYNAPSE_MIND_KEY` 环境变量已设置\n- 检查 Cursor 版本是否支持 MCP（≥ 0.42）\n\n### Mind Key 无效\n\n```bash\n# 直接测试你的 Mind Key\ncurl -H \"Authorization: Bearer mk_YOUR_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n```\n\n## 下一步\n\n- [Claude Desktop 配置](/docs/mcp/claude-desktop)\n- [Continue.dev 配置](/docs/mcp/continue)\n- [持久化 LLM Agent 指南](/docs/guides/persistent-llm-agent)\n","content_html":"

Cursor 中的 MCP

\n

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

\n

前置条件

\n\n

配置

\n

第 1 步：打开 Cursor 设置

\n

在 Cursor 中：

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

第 2 步：添加 Synapse MCP Server

\n

点击 “Add MCP Server” 并配置：

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段值
Namesynapse
Typestdio
Commandnpx -y synapse-mcp-api@latest
EnvSYNAPSE_MIND_KEY=mk_YOUR_KEY, SYNAPSE_URL=https://synapse.schaefer.zone
\n

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

\n

Cursor 把 MCP 配置存储在 ~/.cursor/config.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}

第 4 步：重启 Cursor

\n

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

\n

验证可用

\n

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

\n
recall all my memories

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

\n

常见模式

\n

项目入门

\n

打开新项目时：

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

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

\n

架构决策

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

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

\n

调试历史

\n
what bugs have I hit in this codebase?

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

\n

跨会话代码模式

\n
search memories: "authentication pattern"

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

\n

故障排查

\n

MCP Server 未连接

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

工具未出现

\n\n

Mind Key 无效

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

下一步

\n\n","urls":{"html":"/docs/mcp/cursor","text":"/docs/mcp/cursor?format=text","json":"/docs/mcp/cursor?format=json","llm":"/docs/mcp/cursor?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}