Integrations
Claude Code
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 过滤，避免跨项目污染。

推荐接入方式

Claude Code 可以通过两种方式接入 Memaster：

  • Skills 接入 —— 用 Claude Code Skill 固化检索、写入、更新和安全规则；实际读写可通过 Python/TypeScript SDK、本地脚本或 REST 完成。
  • MCP 接入 —— 用 Model Context Protocol 把 Memaster 暴露为工具，由 Claude Code 直接调用 memaster_search、memaster_add 等工具。

如果你希望控制“什么时候必须检索、什么时候必须写入”，优先使用 Skills 接入。如果你希望编辑器直接看到工具列表，使用 MCP。

⚠️

不要把 API Key 写入仓库。建议使用环境变量、系统凭据管理器或编辑器的 secret 配置能力。

前置准备

创建 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，说明写入和召回链路正常。

故障排查

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

下一步

Skills 接入Model Context ProtocolCursor 接入API Reference
MCP 接入Cursor