
ClariLayer
ClariLayer 是一个通过 MCP 交付的个人上下文层,适用于 AI 数据代理,它从您现有的 SQL/dbt/笔记中引导,在会话之间记住更正,并根据真实的源证据协调已保存的定义,以将不匹配项作为警告呈现。
https://clarilayer.com/?ref=producthunt&utm_source=aipure

产品信息
更新于:2026年07月30日
什么是 ClariLayer
ClariLayer 是一个上下文层,专为使用 Claude Code、Cursor、Codex 或 claude.ai 等 AI 编码代理的个人分析师设计。您无需在每个新会话中重复解释表格、连接和指标定义,而是将 ClariLayer 连接为 MCP 服务器,以便您的代理可以在任务中回忆起正确的结构化上下文。ClariLayer 专注于信任:它将手写的定义(如 CLAUDE.md)视为“已断言”,直到它们与支持的证据进行核对,并且它清晰地标记出出处和状态,这样您的代理就不会自信地重用过时或不正确的业务逻辑。
ClariLayer 的主要功能
ClariLayer 是一个通过 MCP 交付的个人上下文层,它插入到您已使用的 AI 代理(Claude Code、Cursor、Codex 或 claude.ai)中,以便代理能够可靠地回忆和持久化您的数据定义、模式注释、连接路径和跨会话的可重用查询。它从现有资产(SQL 文件、dbt 模型、注释/CLAUDE.md、字典和语义模型)引导上下文,并添加了一个关键的信任机制:“协调”,即根据来自您的真实来源(由您的代理以其自己的访问权限运行)的支持证据检查已保存的定义。当声明的逻辑和实际结果出现偏差时,ClariLayer 会标记一个警告,而不是让代理自信地重用过时或错误的假设——而 ClariLayer 从不持有数据仓库/CRM 凭据或在服务器端运行 SQL。
MCP 原生代理内集成: 作为 MCP 服务器安装到 Claude Code、Cursor、Codex 中,或通过 OAuth 连接到 claude.ai——没有单独的目标应用程序,因此上下文在您的正常工作流程中可在任务中途使用。
从现有分析工件引导: 摄取并结构化来自 SQL(经过验证的 SELECT、确定性结构化)、dbt 模型、CLAUDE.md/注释、数据字典(每个变量一个模式注释)和语义模型(例如,由您的代理规范化的 Databricks Metric Views)的上下文。
召回优先的上下文检索: 您的代理可以在编写 SQL 之前,在流程中拉取最相关的定义、模式注释和先前的更正,并明确范围和信号,说明何时有意省略上下文。
更正和定义的持久内存: 保存指标定义、连接路径、假设和模式警告,这样您就不必在每次新的聊天/会话中重复解释相同的业务逻辑。
根据真实来源证据进行协调: 您的代理使用其自己的数据仓库访问权限运行查询(或收集有界、无行的 HubSpot 元数据证据),并返回结果形状/信号;ClariLayer 比较声明与实际情况,并记录结果,将偏差作为警告显示。
诚实的标签和警告系统: ClariLayer 不会声称“已验证”,而是将条目标记为已断言或警告,并显示出处,这样过时的定义就不会冒充真相。
ClariLayer 的使用场景
收入分析和 QBR 救火: 当仪表板和临时 SQL 不一致时(例如,净收入与总收入),协调功能可以标记偏差(缺失的连接/过滤器/列),以便分析师可以在高管审查之前快速查明数字不匹配的原因。
精益团队的自助式 BI 一致性: 独立分析师或小型团队可以为其 AI 代理构建一个持久的“工作语义层”——定义、连接和警告在会话之间持续存在,无需平台团队推出。
数据工程交接 (dbt + 数据仓库): 从 dbt 模型和 SQL 引导,为代理提供可靠的上下文,用于与血缘相关的任务(正确的基表、连接路径、已知的空值周期),减少重复的入职培训和错误的连接。
受控证据的 CRM 操作 (HubSpot): 存储 CRM 属性的契约(预期阶段/值/别名),并使用代理收集的有界分布/元数据进行协调——有助于 RevOps 和销售运营,而无需将 CRM 行移动到工具中。
跨行业指标定义标准化: 在电子商务、金融科技、SaaS 或医疗保健分析中,团队可以通过在底层数据变化时持久化和标记定义来防止重复的指标偏差(退款处理、活跃客户规则、队列逻辑)。
优点
通过 MCP(Claude Code/Cursor/Codex/claude.ai)在现有代理内部工作,最大限度地减少工作流程中断。
协调模型将定义偏差标记为警告,与纯注释/CLAUDE.md 相比,减少了自信的错误答案。
将数据仓库/CRM 凭据保留在用户代理中;ClariLayer 不在服务器端运行 SQL 或持有源凭据。
从现有 SQL/dbt/字典/语义模型引导,实现第一天的实用性,而不是从零开始设置。
缺点
协调功能依赖于代理运行查询并提供证据负载(结果形状/可选预览),因此质量可能因代理配置和访问权限而异。
在当前版本中,不会将条目标记为完全“已验证”;结果是已断言或警告,而不是强有力的验证印章。
团队治理功能(共享规范、所有权/审批工作流)被描述为单独的扩展路径,并且似乎处于试点阶段,而不是广泛可用。
如何使用 ClariLayer
1) 注册并生成上下文密钥(适用于本地代理): 创建一个 ClariLayer 账户,然后生成一个上下文密钥。请妥善保管:密钥在创建时显示一次,并由本地编码代理(Claude Code、Cursor、Codex)使用。注意:只读密钥只能调用读取工具;写入操作(例如,保存新上下文)需要 context:write 权限。
2) 将 ClariLayer 连接到您的 AI 工具(选择其中一种方式): 选择 (A) 使用您的上下文密钥的本地编码代理,或 (B) 使用 OAuth 批准的 claude.ai。两者都连接到相同的远程 MCP 端点:https://app.clarilayer.com/api/mcp/mcp。
3A) 从本地编码代理连接(Claude Code / Cursor / Codex): 在您的终端中运行 MCP 安装命令,将 ClariLayer 注册为 MCP 服务器。示例:\n\nclaude mcp add --transport http clarilayer https://app.clarilayer.com/api/mcp/mcp --header "Authorization: Bearer cl_YOUR_CONTEXT_KEY"\n\n将 cl_YOUR_CONTEXT_KEY 替换为您生成的密钥。
3B) 从 claude.ai 连接(OAuth,无上下文密钥): 在 claude.ai 中,转到“设置”→“连接器”→“添加自定义连接器”。只粘贴 MCP URL:https://app.clarilayer.com/api/mcp/mcp。然后在浏览器中登录 ClariLayer 并批准连接。
4) 使用健康检查工具验证连接: 要求您的代理调用 clarilayer__health 工具。成功的身份验证响应会返回类似 { ok: true, user, org } 的内容。如果您看到身份验证错误,请重新检查您是否粘贴了完整的 cl_… 密钥(本地代理)或 OAuth 批准是否完成(claude.ai)。
5) 引导您的上下文(第一天设置): 运行引导流程以加载您已有的上下文,这样您就不会从头开始。ClariLayer 支持从以下来源引导:SQL、dbt 模型、CLAUDE.md/notes、数据字典和语义模型。这会将您现有的工作转化为您的代理可以重用的持久的结构化上下文。
6) 在分析期间使用“回忆”(in-flow retrieval): 在处理问题时,让您的代理在编写 SQL 之前调用“回忆”以拉取相关的已保存定义、模式注释、连接路径和注意事项。“回忆”旨在保持范围明确(例如,命名模糊的候选而不是猜测),并与定义一起呈现注意事项。
7) 使用“记住”来持久化更正和新上下文: 当您发现规则、定义、连接陷阱或模式细微之处时,让您的代理使用“记住”来保存它,以便它在会话之间持久存在。这就是您停止在每次新聊天中重复解释相同业务逻辑的方式。
8) 将已保存的定义与实际结果进行协调(信任循环): 让您的代理运行“协调”以根据支持的证据验证已保存的定义。对于数据仓库:您的代理使用自己的数据仓库访问权限在本地运行 SQL,并报告结果元数据(如果您选择,还可以选择预览行)。ClariLayer 比较声明的信号与实际信号,并在不匹配时记录警告;干净的通过会使条目保持断言状态(而不是“已验证”)。
9) (可选) 使用无行证据协调 HubSpot 合同: 如果您使用 HubSpot,您可以为属性存储无行合同(预期阶段、规范值、已弃用别名、预期标签)。您的代理使用自己的授权访问权限读取 HubSpot,并且只发送有界属性元数据和值分布——没有 CRM 行,也没有凭据。不匹配会成为警告;否则合同保持断言状态。
10) 在完成之前闭环:提交完成收据: 在您的代理说“完成”之前,让它持久化所学到的内容(或明确记录没有什么可更新的)。这使您的上下文持久化,并防止改进只存在于聊天记录中。
11) 继续使用循环:引导 → 回忆 → 协调 → 记住: 在日常工作中,重复地:回忆相关上下文,使用您自己的访问权限运行查询,在定义重要时进行协调,并记住更正。随着时间的推移,您的个人上下文会在会话之间和支持的代理之间累积。
ClariLayer 常见问题
ClariLayer 是一个由 MCP 提供的、面向 AI 数据代理(例如 Claude Code、Cursor、Codex、claude.ai)的上下文层,它帮助您的代理跨会话回忆已保存的定义和笔记,并将这些定义与来自您来源的受支持证据进行核对,将不匹配之处作为警告而非让过时的上下文被视为事实。











