AI Editor

Cursor

Connect Cursor to Memaster through Rules, Skills or the hosted Remote HTTP MCP endpoint for persistent project context.

RulesSkillsMCPproject memory

Cursor 的项目规则通常来自当前工作区文件和对话上下文。接入 Memaster 后，Cursor 可以跨会话复用长期记忆：用户偏好、项目约定、排障记录、接口规范和架构决策都可以按项目持续沉淀。

Workspace-aware用 metadata 标记 repository、branch、area，让召回结果贴合当前工作区。

Rule friendly把 Cursor Rules、团队规范和用户偏好合并为可检索长期记忆。

Debug history保存已验证的修复路径，减少重复定位同类问题。

前置准备

创建 API Key

打开 Dashboard → API Keys，创建并保存 msk_xxx 形式的密钥。

选择接入方式

选择 Rules/Skills 或 MCP。两者可以同时使用：Rules 负责流程，MCP 负责工具执行。

添加 Cursor 配置

如果使用 Rules/Skills，把规则文件加入工作区；如果使用 MCP，在 Cursor 的 MCP 配置中加入 memaster Remote HTTP endpoint。

Rules / Skills 配置模板

你可以在 Cursor Rules 中加入轻量提示，让模型按需使用 Memaster。实际读写可通过 Skills 接入中的 SDK 或 REST 脚本完成。

.cursor/rules/memaster-memory.mdc

复杂任务开始前，先通过 Memaster 检索项目事实、用户偏好和历史调试记录。
修改核心逻辑、创建新文件或调整接口前，再次检索相关实现模式和架构决策。
任务完成后，只保存稳定、可复用且不包含敏感信息的结论。
不要保存 API Key、Token、私钥、密码或 `.env` 真实值。
写入记忆时附带 project、area、source、memory_type 和 tags。

MCP 配置模板

如果 Cursor 支持 Remote HTTP MCP，直接配置 Memaster 托管 endpoint：

.cursor/mcp.json

{
  "mcpServers": {
    "memaster": {
      "type": "http",
      "url": "https://api.memaster.cn/mcp",
      "headers": {
        "X-API-Key": "msk_xxx"
      }
    }
  }
}

如果 Cursor 支持从 secret 或环境变量引用 header，请把真实 API Key 放到本机或团队 secret 中，不要提交到仓库。私有化部署时将 url 替换为你的实例 /mcp 地址，例如 https://memaster.your-company.com/mcp。

如果当前 Cursor 环境只支持本地 stdio MCP，则需要一个本地 bridge 将 stdio 请求转发到 https://api.memaster.cn/mcp。对支持 Remote HTTP MCP 的客户端，不需要本地部署 Memaster MCP Server。

字段	示例	用途
`project`	`memaster`	区分仓库或产品
`area`	`server-golang/docs`	区分代码区域
`source`	`cursor`	标记来源编辑器
`memory_type`	`debug` / `implementation` / `user_preference`	区分记忆类型
`tags`	`["文档", "MCP", "编辑器"]`	快速聚合和筛选

使用模式

开始任务前检索

先调用 memaster_search，检索当前仓库的项目规范、用户偏好和最近相关调试记录，再制定修改方案。

完成任务后写入

请把这次已验证的实现决策和测试命令通过 memaster_add 保存为项目记忆，不要保存任何密钥。

更新错误记忆

如果检索到的旧结论已经不适用，请调用 memaster_update 更新它，或调用 memaster_delete 删除错误记忆。

验证接入

在 Cursor 聊天中要求写入一条测试记忆。
刷新或开启新对话。
要求先检索，再回答同一问题。

记住：这个仓库的文档站位于 server-golang/docs，并使用 Nextra。

请检索长期记忆并回答：这个仓库的文档站在哪里，使用什么框架？

故障排查

现象	检查项
Cursor 没有显示 Memaster 工具	MCP 配置路径是否正确，Cursor 是否已重载窗口，URL 是否为 `https://api.memaster.cn/mcp`
工具调用 401	`X-API-Key` 是否为有效的 `msk_xxx`，是否被放在 headers 中
检索结果和当前仓库无关	是否写入了 `project` / `area` / `source` metadata 并在检索时过滤
写入过多噪声	只保存稳定事实、偏好、决策和已验证结论，不保存临时推理

下一步

Skills 接入 Model Context Protocol Claude Code 接入 Dashboard

Claude Code Devin