2. 世界观与基础概念 · 概念指南
什么是智能接入
窄屏可在表格区域横向滚动；键盘用户可聚焦表格区域后滚动查看。
AI 能解释一个系统的用法，与它能够连接这个系统、读取数据或完成操作，是两件不同的事。中间需要具体的接入入口，也需要相应的运行环境与权限。
在 CapaLens 的语境中，智能接入（Intelligent Access，简称 IA）是指能够通过 AI 或大模型应用连接、调用或操作的具体端点与入口能力。它涵盖 MCP、API、CLI、SDK、远程连接等形式，用来回答一个实际问题：AI 可以通过什么入口，使用哪些外部能力？
理解这个概念，有助于找到合适的工具，也有助于看懂目录中的条目、数量与验证状态。
智能接入是一类能力
“智能接入”是组织和描述这些入口的概念。MCP 是其中一种具体协议，API、CLI、SDK 则分别描述接口、命令行工具、开发工具包等不同形态。它们不处在完全相同的技术层级，也不一定互相排斥。
例如，某个 SDK 可能封装同一服务的 API，一个 MCP 服务可能在内部调用 API，命令行工具也可能连接远程服务。接入形式可以不同，背后的业务能力可能重叠。
这里的“智能”描述的是入口与 AI 工作流的关系，不要求每个被接入的服务本身都内置大模型。传统工具只要具有明确的连接或调用路径，并能由 AI 应用在授权范围内使用，也可以成为智能接入。
常见的接入形式
下表列出常见形式，并不穷尽所有接入方式。
| 形式 | 入口是什么 | 接入时主要看什么 |
|---|---|---|
| MCP | 向客户端提供能力的 MCP 服务，可涉及工具、资源和提示模板 | 服务身份、连接方式、客户端兼容性与授权条件 |
| API | 按约定发送请求、接收结果的程序接口 | 地址、方法、输入输出、鉴权与调用限制 |
| CLI | 可在终端或脚本中调用的命令行工具 | 安装方式、命令参数、运行环境、输出与退出状态 |
| SDK | 在特定编程环境中使用的软件开发工具包 | 包与版本、语言环境、初始化方式及调用说明 |
| 远程连接 | 通向远程主机或执行环境的连接入口 | 目标环境、连接协议、身份、权限与可操作范围 |
MCP 官方文档描述了客户端与服务端的连接关系，以及工具、资源、提示模板等能力；服务可以运行在本地或远程。因此，MCP 接入不能简单等同于“一个网页地址”。MCP 架构说明
GitHub 是理解不同接入形式的一个例子：它提供 REST API、可用于终端和脚本的 GitHub CLI，以及用于编程集成的官方 Octokit 库。这些入口服务于相关业务能力，但使用方式和依赖条件不同。REST API 入门、GitHub CLI 手册、官方客户端库说明
远程连接则提供另一类入口。例如，VS Code Remote SSH 能连接远程环境，并在远端运行命令与扩展。把远程环境纳入 AI 工作流，还需要相应的执行工具和授权；仅仅存在一个 SSH 地址，并不代表任何 AI 应用都能使用它。VS Code Remote SSH 文档
什么算一个独立接入单元
整理智能接入目录时，需要先区分几个容易混在一起的对象。
| 对象 | 它代表什么 | 与接入数量的关系 |
|---|---|---|
| 厂商或项目 | 能力的提供者、维护者 | 一个提供者可以有多个独立入口 |
| 来源记录 | 一次收录获得的线索或证据 | 多条来源记录可能指向同一入口 |
| 文档或展示页面 | 说明、展示或汇总信息的载体 | 一个页面可以描述多个入口 |
| 功能、方法或子命令 | 某个入口内部可以执行的操作 | 不自动成为独立接入条目 |
| 独立接入单元 | 可以独立识别，并具有明确接入路径和能力边界的对象 | 是接入数量应当说明的统计对象 |
判断一个对象是否值得独立建条目，可以看三件事：
- 身份是否明确。 能说清它属于谁、叫什么，以及如何与其他对象区分。
- 入口是否具体。 有可追溯的服务地址、接口定义、软件包、启动命令或连接配置等依据，不能只剩一句功能宣传。
- 边界是否清楚。 能说明它提供什么、依赖什么，以及它与同一产品下其他入口的关系。
一个 API 端点、MCP 服务或可安装工具，都可能构成独立接入单元；具体粒度取决于其公开身份、接入边界与实际证据。不能因为文档列出了许多函数，就默认每个函数都是一条独立接入。
同一产品的 MCP、API 与 CLI 也不应仅凭标签就分别计数或全部合并。应判断它们是否具有独立的入口与配置边界，并记录彼此关联。底层能力重叠不一定是重复条目；名称、语言或链接写法不同，也不一定代表新增入口。
一个页面可以包含多个接入
以下为示意案例，不对应 CapaLens 当前数据，也不是任何厂商的实际配置。
假设某个数据服务的一个文档页面同时介绍：
- 一个具有独立连接说明的搜索 MCP 服务。
- 一个具有独立地址、输入输出与鉴权说明的文件提取 API。
- 一个可独立安装、配置和运行的批处理 CLI。
如果三者分别满足独立单元的判定条件，即使都写在同一个页面，也可以形成三个接入条目。反过来，同一个 MCP 服务在官网、代码仓库和教程中出现三次，仍可能只是一个单元，只是多了几份来源证据。
如果页面另外列出十个 CLI 子命令，不能直接再加十条；如果附带的 SDK 只是已有 API 的调用示例或包装，也不能只因新增一个名称就加一条。只有存在足够的独立身份与接入边界证据，才考虑拆分。
因此，网址数量、页面数量、来源记录数量，都不能直接当作智能接入数量。
接入数量应当可以复核
有意义的接入数量，需要同时满足去重、来源可追溯、入口清楚这几个条件。
实际整理时，应把指向同一单元的重复记录归并，保留其来源；也要检查一个页面是否包含多个独立入口，避免漏收。对于名称相似但维护者不同、官方与第三方实现并存，或存在多个部署形态的情况，应说明关系，不能仅凭名称或域名自动合并。
公布数量时，还应说明统计时间、粒度与范围：统计的是接入单元、厂商，还是来源记录？是否包含失效、待核实或仅有线索的项目？只有口径一致，数字才具有比较意义。
来源可追溯也不等于来源可靠。条目应尽量标明官方文档、官方仓库、第三方实现或社区资料的区别，让读者能回到证据本身判断。
收录与验证分别说明什么
目录发现入口，验证则为入口提供不同范围的使用证据。阅读条目时，应将以下几类信息分开理解。
| 记录类型 | 能说明什么 | 不能据此推出什么 |
|---|---|---|
| 已收录 | 已记录入口线索、描述与来源 | 已经连通、适配所有客户端或可靠可用 |
| 机器检测 | 自动化检查执行过指定项目，并记录结果 | 所有业务流程都能成功，或结果长期有效 |
| 人工核验 | 人工确认过指定信息，例如身份、文档或配置说明 | 一定完成了实际连接或完整业务操作 |
| 业务实测 | 在指定账号、环境、版本与任务下进行过实际测试 | 其他账号、环境和任务都能获得相同结果 |
这些标签需要附带检查范围与结果，不能只看名称。“已经检测”与“检测通过”不同；“人工核验了官方来源”与“人工完成了一次业务调用”也不同。一次测试失败，还需要区分入口失效、鉴权不足、环境限制与测试条件不满足。
未实测的接入不应直接被判为不可用，但也不能获得可靠性保证。使用者应结合证据的新鲜程度、适用环境与任务风险，决定是否继续验证。
使用前先回答几个问题
找到一个接入后，可以从下面的问题开始判断：
- 任务是否匹配？ 它实际开放的能力，是否覆盖你要做的事情？
- 环境是否支持？ 当前 AI 应用是否具有需要的客户端、运行时、执行工具或适配层？
- 权限是否合适？ 需要什么账号和授权，能否限制在任务必需的范围内？
- 证据是否充分？ 哪些信息只是收录，哪些已检查或实测，最近一次验证覆盖了什么？
- 操作会带来什么后果？ 是否写入数据、产生费用或触发外部动作，能否先在低风险环境中试用？
接入路径可以已经存在，而你的环境尚未满足条件；某项能力也可能可用，但不适合当前任务。把这些情况分清楚，比简单标一个“支持 AI”更有帮助。
智能接入的价值，在于把外部能力落实为可识别、可连接、可理解的入口。对 CapaLens 来说，清楚说明入口是什么、如何接入、依据来自哪里，以及验证到了哪一步，才能让目录中的每一条记录具有实际参考价值。