# MCP 能力资产包

本目录用于沉淀可被 Agent 调用的外部能力边界，不保存任何服务地址、访问令牌、账号、内部域名或业务数据。

## 何时使用

- 需要跨系统读取经授权的事实、日志或文档。
- 需要调用具有结构化输入输出的外部工具。
- 需要将浏览器、数据库、内部平台或其他服务能力提供给 Agent。

## 不适用场景

- 已有稳定命令且不需要交互式工具调用的任务，优先使用 CLI。
- 只有知识、流程、模板或检查清单的任务，优先沉淀为 Rule、任务上下文契约或 Skill。
- 未确认数据范围、鉴权方式、审计要求或副作用的外部服务。

## 使用顺序

1. 使用 `MCP能力契约.template.md` 描述每个拟接入的服务与工具。
2. 使用 `MCP工具权限与验收清单.md` 审查权限、敏感数据、错误和副作用。
3. 为完整请求、缺参、越权、故障和脱敏结果准备验证夹具。
4. 只有契约与验收都满足时，才将对应工具分配给自定义 Agent 或 Skill。

## 基本原则

- 不根据工具名称推断只读或安全性。
- 外部工具失败时，结论必须标记为“外部事实未取得”。
- 写入、删除、发布和外发能力不应作为通用 Agent 的默认权限。
- 日志、示例和夹具不得包含密钥、Token、账号、完整个人信息或内部地址。