关于 ClariLayer
ClariLayer 是一个 MCP 服务,用于保存个人工作上下文,包括事实、偏好、决策、规则和经验,并在不同项目与会话中由 AI 召回。它面向希望让 AI 记住工作方式的个人分析师,召回结果会附带来源与适用范围。
主要功能
- 01跨项目与会话召回已保存上下文
- 02保存时保留来源与适用范围
- 03支持修正、按范围遗忘与排除
- 04内置 Analytics 专用工具,可对比仓库证据
- 05可选 npm CLI,用于连接与 dbt 文档检查
适用场景
- 01在新会话中召回已确认的项目决策
- 02为 Claude Code、Cursor 或 Codex 保存工作规则
- 03检查本地 dbt 文档中的字段与描述问题
MCP 相关
ClariLayer 是托管 MCP 服务,向 Claude Code、Cursor、Codex、claude.ai 等远程 MCP 客户端提供 recall_context、remember、get_context_entry 等工具。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://clarilayer.com/api/mcp/mcpclaude mcp add --transport http clarilayer-clarilayer https://clarilayer.com/api/mcp/mcp{"mcpServers":{"clarilayer-clarilayer":{"type":"http","url":"https://clarilayer.com/api/mcp/mcp"}}}在 Cursor 中打开{"servers":{"clarilayer-clarilayer":{"type":"http","url":"https://clarilayer.com/api/mcp/mcp"}}}在 VS Code 中打开{"mcpServers":{"clarilayer-clarilayer":{"type":"http","url":"https://clarilayer.com/api/mcp/mcp"}}}{"mcpServers":{"clarilayer-clarilayer":{"serverUrl":"https://clarilayer.com/api/mcp/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://clarilayer.com/api/mcp/mcp需要授权工具
详细介绍
ClariLayer
你的 AI 应该记住你的工作方式。
将选定的过往对话转化为记忆,让 AI 能在不同项目和会话中使用。
ClariLayer 会保留你选择延续使用的事实、偏好、决策、规则和经验。连接 Claude Code、Cursor、Codex、claude.ai 或其他兼容的远程 MCP 客户端。你的 AI 可以从选定且已授权的空间中回忆相关工作背景,并显示其来源和适用范围。
免费开始。当前个人套餐无需信用卡。
将一项决策延续到下一次会话
你与 AI 确定了一项发布决策:
对于 Launch 项目,先展示产品演示。技术细节应放在文档中。请记住这项已确认的决策,以及它的来源和适用项目。
在之后的会话中:
起草发布页面前,先回忆 Launch 项目保存的决策。指出适用的决策以及其来源。
这项决策可以在已授权空间内跨项目和会话延续,同时保留其原始适用范围。针对某个客户或项目的规则仍仅限于该范围。如果规则发生变化,请更正它;如果不再适用,请使用限定范围的遗忘或排除功能。
是否能回忆取决于 AI 客户端是否实际调用该工具。连接 MCP 并不保证每个回答都会使用已保存的上下文。
连接你的 AI
使用 连接你的 AI 获取引导式设置。选择客户端和空间,将设置请求交给该 AI,并在客户端中完成身份验证。如果所选连接方式支持 OAuth,请使用 OAuth;否则,可将上下文密钥存储在本地作为备用方案。切勿将密钥粘贴到 AI 对话或 GitHub 问题中。
已经连接?在同一页面选择 更新我的 AI 设置,然后在目标项目中运行相应请求。这会更新一个已识别的 ClariLayer 指令块,同时保留你自己的指令。
| 客户端 | 项目指令目标 |
|---|---|
| Claude Code | CLAUDE.md |
| Codex | AGENTS.md |
| Cursor | .cursor/rules/clarilayer.mdc |
| claude.ai / 其他远程客户端 | 按照该客户端支持的连接和运行时指南操作 |
在每个新的 AI 会话中,首次需要相关信息时,已安装的引导程序会通过 get_project_stanza 并使用 mode: "runtime" 获取当前工作流。常规的服务端指南更新会在下一个会话中生效,无需将另一份冗长的工作流复制到每个项目中。
可选的设置 CLI
npm CLI 支持使用上下文密钥进行连接设置,以及执行本地 dbt 检查。CLI 0.3.0 将内置的 Analytics 指令替换为向已连接 AI 发出的请求,并新增 instructions --agent <client>。
选择命令前,请先检查可用版本:
npm view clarilayer version
如果可用版本为 0.3.0 或更高版本:
npx clarilayer@latest init
# Already connected? Print only the instruction update request:
npx clarilayer@latest instructions --agent codex
如果你的注册表仍提供 0.2.1,请使用 npx [email protected] init --no-stanza 跳过其中较旧的内置指令,然后通过上述引导式设置完成 更新我的 AI 设置。托管方式不受 npm 发布情况影响,可独立使用。
有关选项和源码检出方式,请参阅 CLI.md;有关发布历史,请参阅 CHANGELOG.md;有关发布检查,请参阅 RELEASING.md。原生指令资格验证记录了经过测试的客户端及其限制。
完整设置说明、手动连接示例和故障排除:QUICKSTART.md。
AI 能做什么
| 工作 | 工作方式 |
|---|---|
| 回忆 | recall_context 可在选定的授权空间中检索相关的已保存上下文。保留来源和适用范围;项目和用途只是相关性提示,并非权限。需要时,使用 get_context_entry 获取完整条目。 |
| 记住或更正 | 使用 remember 和 work_context 保存已确认的持久事实、偏好、决策、规则和经验。含义不明确的更改和建议仍会作为候选项留待审核。 |
| 忘记 | 先回忆目标,再使用返回的条目 ID 执行所请求的遗忘操作。不要猜测名称,也不要在未收到单独请求时删除相关条目。 |
| 完成上下文闭环 | context_checkpoint 会记录 AI 有界的完成声明。它不能证明 AI 使用了正确的上下文,也不能证明已完成外部任务。 |
| 报告使用情况 | report_context_use 可选地将有界反馈关联到已交付的上下文。仅有交付回执并不能证明回答质量。 |
托管 MCP 服务于 2026 年 9 月 17 日完成检查:能力 v64 · 服务端 0.39.0 · 23 个工具。使用实时的 capabilities 工具查看当前列表和版本。能力参考。
导入选定的历史记录
连接后,你可以选择受支持的本地历史记录、目标空间和提取服务提供方,然后在接受初始导入前检查确切的预览。持续捕获需要针对所选来源单独进行设置并授予权限。仅连接 MCP 不会读取历史记录,也不会启用捕获。
来源支持和提取服务提供方支持是分开的。目前符合条件的提取路径使用特定版本的 Claude CLI 配置;OpenAI 和 Cursor 提取服务提供方不可用,原生 Cursor 历史记录的适用范围也有限。选择来源前,请查看当前历史记录指南。
所选来源的内容会由选定的提取服务提供方处理。ClariLayer 存储提取后的上下文,而不是原始对话记录档案。服务提供方处理可能会使用你的额度,或产生服务提供方使用费用。
可选的语义搜索需要在 Settings 中单独取得组织同意并披露服务提供方信息。新连接或历史记录导入选项不会授予此项同意。即使未同意,仍可使用词法回忆。
工作需要时使用分析
ClariLayer for Analytics 保留其专业工具:
get_analysis_context可回忆定义、架构备注、已保存的查询及相关上下文。回忆预览可能会被截断;如需完整内容、已存储的 SQL 和 CRM 合约,请使用get_context_entry。bootstrap可导入提供的 SQL、dbt 模型、备注、数据字典和语义模型。它本身不会读取代码仓库或数据仓库。reconcile会将已保存的定义与受支持的数据仓库证据或 Agent 提供的有界、无行数据的 HubSpot 证据进行比较。Salesforce 合约可以存储和回忆;Salesforce reconcile 已禁用。
通用工作和工程上下文不会独立进行核对。实时信任状态仍为 asserted / caveat;verified 当前不可用。
观看 Analytics 核对示例

预置的 Analytics 演示。你的 Agent 提供数据仓库证据;不匹配之处会作为注意事项保留,供后续会话参考。此示例展示了 Analytics 专业流程。
cd your-dbt-project
dbt docs generate
npx clarilayer dbt-check
CLI 会比较本地的 manifest.json 和 catalog.json 文件,以查找虚构列、缺失的目录模型、类型族不匹配以及空描述。本地检查无需账户或数据仓库连接。使用显式的 --save 时,有界的发现结果会作为提案暂存到你的 Context Inbox 中,供你审核。--save --dry-run 可预览有效负载,而不发起网络请求。
请参阅 CLI 参考和 分析配方。《2026 年 8 月 dbt 漂移调查》保留了已发布的 0.2.1 检查所用的方法、证据和局限性。
控制与隐私
- 保存的上下文会保留其来源和适用范围。不同空间不会自动合并。
- 历史记录导入、持续捕获和语义处理各自都有独立的设置或同意边界。
- 在个人 MCP reconcile 流程中,ClariLayer 不持有任何数据仓库或 CRM 凭据,不执行 SQL,也不调用任何 HubSpot API。你的 Agent 会提供证据。数据仓库证据可以包含可选的预览行;CRM 证据不包含行数据。
- 建议可以通过
propose/propose_batch暂存以供审核。待处理的提案不会成为实时召回上下文。临时对话采集需要明确请求,且发送的是提炼后的候选内容,而不是对话记录。
什么是开源?
本仓库的文档、示例、配方和设置/dbt CLI 均采用 MIT 许可证。托管的 ClariLayer 服务是专有软件。本仓库是连接到该服务的公开起点。
Governed Context Edge 可通过人工执行的私有团队试点使用。申请提前体验。
如需贡献代码和设置帮助,请参阅 CONTRIBUTING.md。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。
