CapaLens 使用方法：人怎么查，AI 怎么查

版本范围：本文保留 2026 年 10 月的观点与版本语境。设计目标、后续计划、说明性示例与已交付能力需分别理解，具体功能以所使用版本为准。

这一篇是智能接入（Intelligent Access，简称 IA）的查询与审查指南。两条路径：人用网页查，AI 通过 MCP 查。两者读的是同一套目录数据，查到的事实一致。

一、三步：说清任务 → 比较条件 → 审查再接入

第一步，说清任务。 从想完成的工作出发，而不是从工具名出发。网站首页的搜索框提示"输入想完成的业务任务或工具"，下面有真实的业务动作示例：检索公开企业资料、查询已授权客户资料、查看客户服务工单、核对订单状态、查看合同签署进度、核对收款交易、复核项目进展、检索已授权团队知识。

把条件一起说出来效果更好，例如："可以私有部署、不使用 cookie 的网站访问统计"。

第二步，比较条件。 按能力、环境（云端 / 自托管）、授权方式、费用来源和已知限制比较候选。本次构建保留类型、认证、环境、协议、传输、数据格式、来源和厂商等筛选；MCP 对比需提供 2–4 个不同编号，网页入口以实际可见控件为准。

第三步，审查再接入。 回到官方文档核对最新条件，审查配置，再由你自己的客户端直接连接厂商。CapaLens 只整理资料与证据，不代执行厂商业务，也不保管厂商密钥。

二、网页上怎么看一条结果

以下是后续结果卡片的设计，不能作为当前 0.4.8 已实现这些字段的说明；版本号不是交付日期承诺。读卡片时应区分设计约定与实际返回：

• 标题写功能，不只写软件名。 例如"按状态检索服务工单"，软件名、接口类型（MCP / API / CLI）、官方或第三方在第二行。
• 条件三态：✓ 满足、✗ 不满足、? 未知。 颜色只表达状态：绿色满足、橙色不满足、灰色虚线未知。未知 ≠ 不支持——它只是说我们还没有证据。字段缺失一律显示"?"。
• 证据阶梯： 自我声明 → 文档核查 → 机器检测 → 人工校验，点亮到当前等级。应按单条范围显示：正式目录的文档核对标签不代表厂商业务实测，Registry 来源登记和本地补充信息记录仍须显示未核验、未实测。人工看过资料也不等于业务调用成功。
• 新鲜度（设计）： 在有日期和适用版本时显示其范围；有效期、待复测和自动降级属于后续规则，缺失日期保持未知。
• 排序理由： 一行，只引用命中的需求映射和字段。公开可核对的排序依据是设计目标；现有结果以实际字段为准，不应从本篇推断完整规则已经公开。
• 卡片上不会出现： "推荐""最佳""安全""保证可用"和星级综合分。

如果页面或响应提供了数据摘要和快照日期，可据此核对范围；未提供的版本或日期应视为未知，不能假设每页都有相同的完整快照标记。

软件详情可包含证据日期、来源、价格说明、业务映射、限制和接入说明，具体以单条实际字段为准。价格与日期缺失时保持未知，不用零或默认日期补齐。

三、AI 怎么用：通过 MCP

CapaLens 提供一个只读的 MCP 服务器：

• 地址： https://capalens.com/mcp
• 传输： Streamable HTTP
• 鉴权： 公开目录无需登录或令牌

以下为 Claude Code 的 HTTP MCP 配置示例；其他客户端的配置结构可能不同，请先对照其当前官方文档审查；以下示例和命令仅供用户手动评估，本页面不会自动执行或安装：

{
  "mcpServers": {
    "capalens": {
      "type": "http",
      "url": "https://capalens.com/mcp"
    }
  }
}

对 Claude Code 用户，一行命令：

claude mcp add --transport http capalens https://capalens.com/mcp

对于 Claude、ChatGPT 等应用，请先核对当前客户端、套餐、工作区策略与管理员权限是否支持自定义远程 MCP，再依官方流程添加该地址。并非所有桌面 / 网页客户端都支持相同入口。添加 CapaLens 可能会建立到其 MCP 端点的连接，但不会自动安装或连接目录中的其他厂商服务；你的 AI 只是多了一个可以查证据的地方。

下面是目标交互示例，包含后续版本设计的条件三态与追问信息，并不表示 v0.4.8 已返回全部字段：

你说："帮我接一个能查客服工单的工具，要官方来源、OAuth 授权。" 在目标交互中，AI 调用 search_software 后，按已交付字段展示候选、条件状态、证据与未知项；条件三态及建议追问以对应版本实际输出为准。对"未知"的条件，AI 应该回头问你（比如"需要数据存国内吗？"），而不是替你猜。你选定以后，在自己的客户端里确认添加，凭据直接给厂商。之后的调用不再经过 CapaLens。

工具一览

本次准备所依据的 0.4.8 工具合同为 15 个只读工具（7 个正式目录工具、1 个路径检查工具、7 个来源候选工具）。此处是构建合同说明，不是新的线上工具调用验收：

两个使用建议：

1. 先取简明搜索结果，再按编号取详情。 详细响应受客户端和服务预算约束；get_software.fields 只接受前表列出的扩展，不可当作任意投影字段使用。
2. 来源登记和正式目录是两套口径。 Registry 是官方注册中心的元数据来源，不代表每个维护者都是厂商官方。首页已经能以同一查询分别检索两个通道，但尚不能据此推断跨来源身份已全部关联或去重。文档标签与厂商业务实测也须分开。

阅读实际响应中的范围和未知项：平台只提供资料与证据，不规划、担保或代为调用。某个响应没有完整说明时，也不能推定该接入已验证可用。

四、把查到的结果带走

复制给 AI（v0.5.0 设计，以上线验收为准）。 结果卡片上的"复制给 AI"会生成一段精简文本——查询理解、每个候选的编号、条件状态、证据链接，加一句范围声明，可以直接贴进任何 AI 对话。以下为说明性格式示例，不是本次真实查询回执：

[CapaLens 接入卡 · 数据版本 163ae635 · 2026-10-21]
Notion MCP（Notion 官方，远程 MCP，需 OAuth 授权）
能力：搜索工作区内容；读取与更新页面；创建页面和数据库
条件：官方来源 ✓｜只读访问 ✗（含写入）｜数据存国内 ?（暂无证据）
证据：developers.notion.com 官方文档（文档核查，未实测）
边界：CapaLens 只提供证据；连接和授权由用户在客户端确认。
复核：CapaLens MCP get_software id=notion

最后一行告诉接收方的 AI 怎么回到 CapaLens 复核——这样转发出去的不是一个结论，而是一条可以验证的线索。

接入卡与"用到我的 AI 里"（规划中）。 后续版本里，每条接入会有一张无状态的接入卡链接：打开的人先看到条件和证据，再按自己的客户端一键添加。

流程是：点"用到我的 AI 里"→ 选客户端 → 确认（服务器地址来自目录不可改；凭据只给获取方式）→ 一键添加，由客户端自己弹出安装确认 → 打不开时复制配置手动添加。Cursor 和 VS Code 走安装链接，Claude Code 走一行命令，其他应用复制远程地址；API / CLI 类接入则生成一份"给 AI 的接入说明"（Markdown），可存为规则或技能文件。

红线不变：不代为安装、不收集凭据、不中转调用；所有添加都在你自己的客户端里确认。

五、几条常见问题

查不到想要的东西怎么办？ 中文与英文表达可能命中不同结果，可尝试其他关键词、业务需求编号（如 review-customer-tickets）或软件名。后续需求路由和同义词改进以实际版本为准。零结果查询是否采集、脱敏方式与保留范围应以实际实现及隐私说明为准；本篇内容不启用新的日志或反馈采集。

"未知"是什么意思？ 我们没有证据，不是说不支持。可以放宽这个条件再查，或者回到官方文档确认，并欢迎通过纠错通道告诉我们。

信息多久更新一次？ 有记录时查看日期的来源与范围，缺失时保持未知。持续监测和自动重测是后续方向，不保证已在某个版本全量上线；费用与权限尤其应回到厂商最新说明确认。

CapaLens 收费吗？ 公开查询按站点实际额度提供。持续检查、变更提醒和团队审核仍是商业假设，以未来条款和交付为准；本次导入不接入收费，不以付费换核验结论，赞助与自然结果及证据分开标注。

---

本文依据准备中的 0.4.8 构建合同与资料快照。设计和规划不等于当前线上功能；实际页面、Schema 和发布记录决定可用范围，本篇不构成新的线上验收。