nex_docus/docs/sdd/specs/DV-0011-mcp-integration/spec.md

26 lines
758 B
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# DV-0011:MCP 接入 – 规格(Spec)
- **状态**:Implemented
- **关联 ADR**:ADR-0005(可溯源/开放)
## 目标
通过 MCP Streamable HTTP 让外部 Agent 以用户身份访问 NexDocs 能力。
## 范围
- **In**:后端内嵌 MCP server、bot 凭据管理、工具暴露。
- **Out**:独立 MCP 部署(已废弃 mcp_server/)。
## 用户故事
> 作为外部 Agent,我希望用 bot 凭据调用 NexDocs 工具管理项目/文档。
## 功能需求(FR)
| ID | 需求 | 验收要点 |
| --- | --- | --- |
| FR-18 | MCP /mcp + X-Bot-Id/Secret 认证 | streamableHttp;bot 映射用户;401 未带凭据 |
## 非功能需求(NFR)
| ID | 需求 |
| --- | --- |
| NFR-4 | 工具以用户身份 + 权限判定执行 |