AI Editor

Claude Code

Use Memaster as the long-term memory backend for Claude Code through Skills, Rules or the hosted Remote HTTP MCP endpoint.

SkillsMCPAI editor memory

Claude Code 适合长期维护大型代码库，但默认上下文会随会话结束而丢失。接入 Memaster 后，你可以把项目规范、目录结构、调试结论、用户偏好和关键架构决策保存为长期记忆，并在之后的任务中自动召回。

Project memory保存项目规范、模块边界、API 约定和踩坑记录，减少重复解释。

User preferences记录代码风格、回复语言、测试策略和提交偏好。

Safe recall通过 user_id / agent_id / run_id 和 metadata 过滤，避免跨项目污染。

前置准备

创建 API Key

打开 Dashboard → API Keys，创建一个 msk_xxx 形式的密钥。

选择接入方式

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

配置 Claude Code

如果使用 Skills，把 Skill 文件加入 Claude Code 可加载的 Skills 目录；如果使用 MCP，把 Memaster Remote HTTP MCP endpoint 加入 Claude Code 支持的 MCP 配置位置。

Skills 配置模板

将下面的 Skill 内容保存为 Claude Code 可加载的技能文件，或合并到团队已有的编码工作流中：

memaster-memory/SKILL.md

---
description: Use Memaster long-term memory before, during and after coding tasks.
---
 
# Memaster Memory
 
## Start
 
Before complex coding tasks, search Memaster for:
 
1. User preferences.
2. Project facts.
3. Related debugging history.
4. Architecture decisions and implementation patterns.
 
## During
 
Search again before creating files, changing central abstractions or making architecture decisions.
 
## Finish
 
Save stable implementation details, debugging conclusions, component relationships and user preferences.
 
Never save API keys, tokens, private keys, passwords or raw `.env` values.

如果 Claude Code Skill 需要调用本地脚本，可以参考 Skills 接入中的 Python / TypeScript / REST 示例。

MCP 配置模板

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

mcp.json

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

私有化部署时将 url 替换为你的实例 /mcp 地址，例如 https://memaster.your-company.com/mcp。

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

工具	触发时机	说明
`memaster_search`	读取代码、制定方案、排查问题前	根据当前任务召回项目规则、历史决策和用户偏好
`memaster_add`	完成实现、定位问题、形成稳定结论后	保存可复用事实、调试结论、架构约定
`memaster_update`	旧结论被新实现取代时	更新单条记忆，避免错误信息继续被召回
`memaster_delete`	发现误记或敏感内容时	删除指定记忆

建议保存什么

项目结构：核心目录、入口文件、模块职责。
工程约定：包管理器、测试命令、部署流程、代码风格。
调试结论：根因、修复方式、验证命令。
用户偏好：回复语言、是否需要解释、测试覆盖偏好。
架构决策：为什么采用某个接口、模型、队列或缓存方案。

不应该保存什么

API Key、Token、私钥、密码。
.env 中的真实密钥。
用户未确认的临时猜测。
一次性日志、堆栈和无复用价值的中间输出。

验证接入

在 Claude Code 中让模型执行一次记忆写入和检索：

请调用 memaster_add 记住：这个项目默认使用 pnpm，不使用 npm。

随后开启新会话或新任务，再询问：

请先检索长期记忆，然后告诉我这个项目默认使用什么包管理器。

如果返回 pnpm，说明写入和召回链路正常。

故障排查

现象	检查项
工具列表里没有 Memaster	MCP 配置是否被 Claude Code 加载，URL 是否为 `https://api.memaster.cn/mcp`
401 / Authentication required	`X-API-Key` 是否为有效的 `msk_xxx`，是否被放在 headers 中
检索为空	写入时的 `user_id` / `agent_id` 是否和检索一致
召回了其它项目内容	是否缺少 `project`、`area`、`source` 等 metadata 过滤
响应变慢	降低 `top_k`，或只在任务开始和关键节点检索

下一步

Skills 接入 Model Context Protocol Cursor 接入 API Reference

MCP 接入 Cursor